r44290 - /website/debhelper.pod

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

Author: jawnsy-guest
Date: Sat Sep 19 13:46:19 2009
New Revision: 44290

URL: http://svn.debian.org/wsvn/?sc=1&rev=44290
Log:
Rearrange a few things, add a section describing how to easily enable Adam Kennedy's tests

Modified:
    website/debhelper.pod

Modified: website/debhelper.pod
URL: http://svn.debian.org/wsvn/website/debhelper.pod?rev=44290&op=diff
==============================================================================
--- website/debhelper.pod (original)
+++ website/debhelper.pod Sat Sep 19 13:46:19 2009
@@ -76,7 +76,7 @@
 Note that the latest version of dh-make-perl does this automatically. It
 requires using B<debhelper 7> or greater.
 
-=head1 Arcane Uses
+=head1 Occasionally Useful
 
 =head2 Removing Something
 
@@ -177,6 +177,45 @@
 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 Enabling Adam Kennedy's Tests
+
+Adam Kennedy is a CPAN developer that maintains over 200 Perl modules, so
+chances are you will encounter one of his modules. Luckily, most of his
+modules follow the same basic structure; namely, they use Module::Install
+(so check the L<copyright.pod> for that entry) and they all have certain
+author tests that should be enabled.
+
+=head3 Prerequisites
+
+Add these prerequisites to your Build-Depends-Indep for "Architecture: all"
+modules, and Build-Depends for "Architecture: any" modules:
+
+=begin html
+
+<pre>libtest-cpan-meta-perl, libtest-pod-perl (>= 1.26), 
+libperl-minimumversion-perl, libtest-minimumversion-perl
+</pre>
+
+=end html
+
+These prerequisites apply when you have the B<t/97_meta.t>, B<t/98_pod.t>,
+B<t/99_pmv.t> test files; you may need to adjust accordingly, but this is
+the most common scenario.
+
+To enable automated testing (don't enable release testing), use:
+
+=begin html
+
+<pre>override_dh_auto_test:
+&#09;AUTOMATED_TESTING=1 dh_auto_test
+</pre>
+
+=end html
+
+This requires support for overrides, introduced in B<debhelper 7.0.50>
+
+=head1 Arcane Uses
+
 =head2 Module::Install 0.85
 
 For Module::Install version 0.85, anything that uses AutoInstall will cause