r39675 - /website/debhelper.pod

[jawnsy-guest at users.alioth.debian.org]

Author: jawnsy-guest
Date: Fri Jul 10 22:05:26 2009
New Revision: 39675

URL: http://svn.debian.org/wsvn/?sc=1&rev=39675
Log:
HTMLized stuff so it's copy/pastable :-)

Modified:
    website/debhelper.pod

Modified: website/debhelper.pod
URL: http://svn.debian.org/wsvn/website/debhelper.pod?rev=39675&op=diff
==============================================================================
--- website/debhelper.pod (original)
+++ website/debhelper.pod Fri Jul 10 22:05:26 2009
@@ -16,21 +16,31 @@
 It is often quite beneficial for us to run these tests during build-time, so
 we prefer to add the author tests (if packaged) to Build-Depends-Indep.
 
-Usually there is an environment variable, like B<TEST_AUTHOR>, that will run
+Usually there is an environment variable, like C<TEST_AUTHOR>, that will run
 these tests, however. You could enable this flag (and thus the tests) using:
 
-  %:
-    TEST_AUTHOR=1 dh $@
+=begin html
+
+<pre>%:
+&#09;TEST_AUTHOR=1 dh $@
+</pre>
+
+=end html
 
 However, the problem is that older versions of lintian used to issue a warning
-when this style was used. Another issue is that TEST_AUTHOR is set for the
+when this style was used. Another issue is that C<TEST_AUTHOR> is set for the
 entire length of the build process, rather than just the testing part, so it
 could conceivably have other undesirable side-effects.
 
 You may do this using debhelper overrides, using:
 
-  override_dh_auto_test:
-    TEST_AUTHOR=1 dh_auto_test
+=begin html
+
+<pre>override_dh_auto_test:
+&#09;TEST_AUTHOR=1 dh_auto_test
+</pre>
+
+=end html
 
 This requires support for overrides, introduced in B<debhelper 7.0.50>
 
@@ -39,8 +49,13 @@
 When using a quilt patching system with the shorter debian/rules format, you
 may easily indicate that you need quilt by having a clause like this:
 
-  %:
-    dh --with quilt $@
+=begin html
+
+<pre>%:
+&#09;dh --with quilt $@
+</pre>
+
+=end html
 
 The new C<--with> syntax was added in B<debhelper 7.0.8> and requires
 B<quilt 0.46-7>.
@@ -63,9 +78,14 @@
 Sometimes debhelper's fix permissions stage (dh_fixperms) sets the wrong
 permissions for a given file. You can use an override to fix this, like so:
 
-  override_dh_fixperms:
-    dh_fixperms
-    chmod 644 $(CURDIR)/debian/package-name/usr/share/path/to/file
+=begin html
+
+<pre>override_dh_fixperms:
+&#09;dh_fixperms
+&#09;chmod 644 $(CURDIR)/debian/package-name/usr/share/path/to/file
+</pre>
+
+=end html
 
 Using overrides requires B<debhelper 7.0.50>