r35205 - /website/howto/quilt.pod

[gregoa at users.alioth.debian.org]

Author: gregoa
Date: Mon May 11 17:49:34 2009
New Revision: 35205

URL: http://svn.debian.org/wsvn/?sc=1&rev=35205
Log:
add quilt's debhelper integration since 0.46-7

Modified:
    website/howto/quilt.pod

Modified: website/howto/quilt.pod
URL: http://svn.debian.org/wsvn/website/howto/quilt.pod?rev=35205&op=diff
==============================================================================
--- website/howto/quilt.pod (original)
+++ website/howto/quilt.pod Mon May 11 17:49:34 2009
@@ -113,6 +113,10 @@
 C<Build-Depends-Indep> (for arch:all packages) is not appropriate as C<quilt> is
 needed by the C<clean> target.
 
+Note: Patches should be unapplied before committing to SVN!
+
+=head2 3.1 The "classical" way
+
 C<include /usr/share/quilt/quilt.make> has some candy for C<debian/rules>.
 First, it defines C<QUILT_PATCHES> to be C<debian/patches> so that one doesn't
 have to worry about that setting in the pbuilder chroot.
@@ -122,7 +126,7 @@
 
 Lastly, C<unpatch> target is useful as a C<clean> dependency.
 
-Here's sample fragment from C<debian/rules>:
+Here's a sample fragment from C<debian/rules>:
 
     include /usr/share/quilt/quilt.make
 
@@ -146,7 +150,21 @@
 N.B. C</usr/share/quilt/quilt.make> is available since C<quilt> version 0.40.
 You are advised to make the quilt build-dependency versioned.
 
-N.B. Patches should be unapplied before committing to SVN!
+=head2 3.2 The "modern" way
+
+Since 0.46-7 C<quilt> offers a simpler integration with debhelper. A simple
+F<debian/rules> can now be written as (needs C<debhelper> >= 7.0.8):
+
+    #!/usr/bin/make -f
+
+    %:
+        dh --with quilt $@
+
+Alternatively C<dh_quilt_patch> and C<dh_quilt_unpatch> can be added to
+C<debian/rules>.
+
+For the details take a look at F</usr/share/doc/quilt/README.Debian> and/or
+C<dh_quilt_patch(1)>, C<dh_quilt_unpatch(1)>.
 
 =head1 4. Why quilt is better?
 
@@ -230,7 +248,7 @@
 
 =head1 License
 
-Copyright (c) 2007,2008 Debian Perl Group.  All rights reserved. This document
+Copyright (c) 2007-2009 Debian Perl Group.  All rights reserved. This document
 is free software; you may redistribute it and/or modify it under the same terms
 as Perl itself