r17953 - /trunk/dh-make-perl/dh-make-perl

[dmn at users.alioth.debian.org]

Author: dmn
Date: Mon Mar 24 14:27:01 2008
New Revision: 17953

URL: http://svn.debian.org/wsvn/pkg-perl/?sc=1&rev=17953
Log:
add POD about --refresh

Modified:
    trunk/dh-make-perl/dh-make-perl

Modified: trunk/dh-make-perl/dh-make-perl
URL: http://svn.debian.org/wsvn/pkg-perl/trunk/dh-make-perl/dh-make-perl?rev=17953&op=diff
==============================================================================
--- trunk/dh-make-perl/dh-make-perl (original)
+++ trunk/dh-make-perl/dh-make-perl Mon Mar 24 14:27:01 2008
@@ -14,9 +14,6 @@
 
 # TODO: 
 # * get more info from the package (maybe using CPAN methods)
-# * add --refresh
-#   should re-create debian/rules based on current dh-make-perl
-#   templates, after analyzing docs, examples etc.
 # * search.cpan.org-based watch file should be generated in the same
 #   cases as when the dist-based URL in d/copyright is used
 #   currently watch file is created only when --cpan is given
@@ -1210,6 +1207,8 @@
 
 B<dh-make-perl> [B<SOURCE_DIR> | B<--cpan> I<MODULE>]
 
+B<dh-make-perl> B<--refresh>
+
 You can modify B<dh-make-perl>'s behaviour with some switches:
 
 =over
@@ -1339,6 +1338,17 @@
 your system - If a newer version of a core module breaks the API, all kinds
 of daemons might get upset ;-)
 
+=item B<--refresh>
+
+Refresh mode.
+
+Instead of creating new debian/ directory, C<--refresh> makes C<dh-make-perl>
+to re-create only C<debian/rules> according to the current templates.
+
+This is useful when C<debian/rules> was created using older templates and
+doesn't contain much customisations. As always, you're strongly encouraged to
+verify if C<debian/rules> looks sane.
+
 =back
 
 =head1 DESCRIPTION