r45064 - /website/debhelper.pod

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

Author: jawnsy-guest
Date: Wed Sep 30 03:11:40 2009
New Revision: 45064

URL: http://svn.debian.org/wsvn/?sc=1&rev=45064
Log:
Add rule for fixing interpreter shebang lines

Modified:
    website/debhelper.pod

Modified: website/debhelper.pod
URL: http://svn.debian.org/wsvn/website/debhelper.pod?rev=45064&op=diff
==============================================================================
--- website/debhelper.pod (original)
+++ website/debhelper.pod Wed Sep 30 03:11:40 2009
@@ -78,6 +78,25 @@
 
 =head1 Occasionally Useful
 
+=head2 Note on Paths
+
+In order to save on typing, be a bit lazy and improve a little bit on
+maintainability and readability of the file, the following variables are
+typically placed at the top of your B<rules> file when there are some file
+operations involved.
+
+=begin html
+
+<pre>PACKAGE = $(shell dh_listpackages)
+TMP     = $(CURDIR)/debian/$(PACKAGE)
+</pre>
+
+=end html
+
+Then any of your paths become pretty trivial, you can specify them as:
+B<($TMP)/usr/share/path/to/file>. Otherwise, you can accomplish the same
+thing with: B<$(CURDIR)/debian/package-name/usr/share/path/to/file>
+
 =head2 Removing Something
 
 =head3 A File
@@ -158,24 +177,22 @@
 
 Using overrides requires B<debhelper 7.0.50>
 
-=head2 Note on Paths
-
-In order to save on typing, be a bit lazy and improve a little bit on
-maintainability and readability of the file, the following variables are
-typically placed at the top of your B<rules> file when there are some file
-operations involved.
-
-=begin html
-
-<pre>PACKAGE = $(shell dh_listpackages)
-TMP     = $(CURDIR)/debian/$(PACKAGE)
-</pre>
-
-=end html
-
-Then any of your paths become pretty trivial, you can specify them as:
-B<($TMP)/usr/share/path/to/file>. Otherwise, you can accomplish the same
-thing with: B<$(CURDIR)/debian/package-name/usr/share/path/to/file>
+=head2 Fixing Interpreter Shebang Lines
+
+Sometimes examples are Perl scripts that do not use the absolute path of
+the Perl interpreter in the shebang line. In these cases, they should be
+rewritten to B</usr/bin/perl>:
+
+=begin html
+
+<pre>override_dh_installexamples:
+&#09;dh_installexamples
+&#09;sed -i '1s|^#!perl|#!/usr/bin/perl|' $(TMP)/usr/share/doc/libdate-calc-perl/examples/*override_dh_fixperms:
+</pre>
+
+=end html
+
+Using overrides requires B<debhelper 7.0.50>
 
 =head2 Enabling Adam Kennedy's Tests