r39872 - /website/debhelper.pod

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

Author: jawnsy-guest
Date: Tue Jul 14 04:22:52 2009
New Revision: 39872

URL: http://svn.debian.org/wsvn/?sc=1&rev=39872
Log:
added a section about Module::Install 0.85

Modified:
    website/debhelper.pod

Modified: website/debhelper.pod
URL: http://svn.debian.org/wsvn/website/debhelper.pod?rev=39872&op=diff
==============================================================================
--- website/debhelper.pod (original)
+++ website/debhelper.pod Tue Jul 14 04:22:52 2009
@@ -94,6 +94,33 @@
 
 Using overrides requires B<debhelper 7.0.50>
 
+=head2 Module::Install 0.85
+
+For Module::Install version 0.85, anything that uses AutoInstall will cause
+the CPAN shell to be executed in order to check dependencies. This was
+fixed in newer versions of Module::Install, but nonetheless many modules
+are distributed with this buggy version of the installer.
+
+Build servers should not have to execute CPAN or connect to the Internet in
+the course of building a package, so you have to disable this behaviour.
+
+We can do this by tricking Module::Install into thinking that we're running
+under CPANPLUS, which prevents it from running the CPAN shell, as follows:
+
+=begin html
+
+<pre># Module::Install 0.85 has a bug causing CPAN to be launched
+override_dh_auto_configure:
+&#09;PERL5_CPANPLUS_IS_RUNNING=1 dh_auto_configure
+</pre>
+
+=end html
+
+Remember to note (by way of a comment) that this fix is only needed for
+Module::Install 0.85, so that it can be removed if/when it is upgraded.
+
+Using overrides requires B<debhelper 7.0.50>
+
 =head1 LICENSE AND COPYRIGHT
 
 Copyright (c) 2009 Debian Perl Group. All rights reserved.