r44525 - /website/debhelper.pod

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

Author: jawnsy-guest
Date: Mon Sep 21 15:48:24 2009
New Revision: 44525

URL: http://svn.debian.org/wsvn/?sc=1&rev=44525
Log:
Create a section devoted to Module::AutoInstall :)

Modified:
    website/debhelper.pod

Modified: website/debhelper.pod
URL: http://svn.debian.org/wsvn/website/debhelper.pod?rev=44525&op=diff
==============================================================================
--- website/debhelper.pod (original)
+++ website/debhelper.pod Mon Sep 21 15:48:24 2009
@@ -217,7 +217,28 @@
 
 This requires support for overrides, introduced in B<debhelper 7.0.50>
 
-=head1 Arcane Uses
+=head1 Module::AutoInstall
+
+Module::AutoInstall is a module designed to automatically install missing
+dependencies, and is often incorporated as part of packages built using
+Module::Install. It installs using the CPAN Shell or CPANPLUS.
+
+=head2 Common Case
+
+Module::Install 0.85 ignores the --skipdeps option, which is why treatment
+of that case differs from the usual one. We can pass this option to disable
+AutoInstall's desire to check and install dependencies via CPAN. Often,
+packages require versions simply because they are the newest version from
+CPAN, which triggers the CPAN-based clients to update the module.
+
+However, they might not be the actual minimum required version of the
+module, and in Debian we often disregard updates with only small changes.
+This occasionally results in a situation where an upstream package relies
+on a version that is specifically not upgraded in Debian.
+
+When AutoInstall is used as part of a module's distribution, simply set a
+requirement for B<debhelper 7.2.13>. For backporting, one may instead
+prefer to override the build target instead.
 
 =head2 Module::Install 0.85
 
@@ -246,6 +267,8 @@
 
 Using overrides requires B<debhelper 7.0.50>
 
+=head1 Arcane Uses
+
 =head1 LICENSE AND COPYRIGHT
 
 Copyright (c) 2009 Debian Perl Group. All rights reserved.