Package: quilt
Version: 0.46-4
Severity: wishlist
As recently mentioned in debian-devel-announce [1], the next release of
Policy will recommend that packages where one can't just dpkg-source -x
a package, modify things, and run dpkg-buildpackage should have a
debian/README.source. Here is the sample that I wrote for a package
that uses quilt. Could you include this document and install it
(probably in /usr/share/doc/quilt) so that packages that use quilt can
refer to it?
Thanks!
[1] http://lists.debian.org/debian-devel-announce/2008/04/msg00016.html
-- System Information:
Debian Release: lenny/sid
APT prefers testing
APT policy: (990, 'testing'), (500, 'unstable'), (1, 'experimental')
Architecture: i386 (i686)
Kernel: Linux 2.6.24-1-686 (SMP w/1 CPU core)
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/bash
Versions of packages quilt depends on:
ii bzip2 1.0.5-0.1 high-quality block-sorting file co
ii diffstat 1.45-2 produces graph of changes introduc
ii gawk [awk] 1:3.1.5.dfsg-4.1 GNU awk, a pattern scanning and pr
ii gettext 0.17-2 GNU Internationalization utilities
ii mawk [awk] 1.3.3-11 a pattern scanning and text proces
ii patch 2.5.9-4 Apply a diff file to an original
quilt recommends no packages.
-- no debconf information
This package uses quilt to manage all modifications to the upstream
source. Changes are stored in the source package as diffs in
debian/patches and applied during the build.
To get the fully patched source after unpacking the source package, cd to
the root level of the source package and run:
quilt push -a
The last patch listed in debian/patches/series will become the current
patch.
To add a new set of changes, first run quilt push -a, and then run:
quilt new <patch>
where <patch> is a descriptive name for the patch, used as the filename in
debian/patches. Then, for every file that will be modified by this patch,
run:
quilt add <file>
before editing those files. You must tell quilt with quilt add what files
will be part of the patch before making changes or quilt will not work
properly. After editing the files, run:
quilt refresh
to save the results as a patch.
Alternately, if you already have an external patch and you just want to
add it to the build system, run quilt push -a and then:
quilt import -P <patch> /path/to/patch
quilt push -a
(add -p 0 to quilt import if needed). <patch> as above is the filename to
use in debian/patches. The last quilt push -a will apply the patch to
make sure it works properly.
To remove an existing patch from the list of patches that will be applied,
run:
quilt delete <patch>
You may need to run quilt pop -a to unapply patches first before running
this command.
