r26064 - in /trunk/libtext-formattable-perl/debian: README.source changelog

[dmn at users.alioth.debian.org]

Author: dmn
Date: Thu Oct 16 05:48:22 2008
New Revision: 26064

URL: http://svn.debian.org/wsvn/pkg-perl/?sc=1&rev=26064
Log:
add debian/README.source documenting quilt usage

Added:
    trunk/libtext-formattable-perl/debian/README.source
Modified:
    trunk/libtext-formattable-perl/debian/changelog

Added: trunk/libtext-formattable-perl/debian/README.source
URL: http://svn.debian.org/wsvn/pkg-perl/trunk/libtext-formattable-perl/debian/README.source?rev=26064&op=file
==============================================================================
--- trunk/libtext-formattable-perl/debian/README.source (added)
+++ trunk/libtext-formattable-perl/debian/README.source Thu Oct 16 05:48:22 2008
@@ -1,0 +1,57 @@
+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 configure quilt to use debian/patches instead of patches, you want
+either to export QUILT_PATCHES=debian/patches in your environment
+or use this snippet in your ~/.quiltrc:
+
+    for where in ./ ../ ../../ ../../../ ../../../../ ../../../../../; do
+        if [ -e ${where}debian/rules -a -d ${where}debian/patches ]; then
+                export QUILT_PATCHES=debian/patches
+        fi
+    done
+
+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.

Modified: trunk/libtext-formattable-perl/debian/changelog
URL: http://svn.debian.org/wsvn/pkg-perl/trunk/libtext-formattable-perl/debian/changelog?rev=26064&op=diff
==============================================================================
--- trunk/libtext-formattable-perl/debian/changelog (original)
+++ trunk/libtext-formattable-perl/debian/changelog Thu Oct 16 05:48:22 2008
@@ -6,6 +6,7 @@
   * add quilt to B-D/rules
   * convert debian/rules to debhelper 7; adjust debhelper build-dependency and
     debian/compat; install examples via debian/examples
+  * add debian/README.source documenting quilt usage
 
  -- Damyan Ivanov <dmn at debian.org>  Wed, 15 Oct 2008 18:08:57 +0300