r29492 - /trunk/dh-make-perl/dh-make-perl

dmn at users.alioth.debian.org dmn at users.alioth.debian.org
Fri Jan 9 14:24:45 UTC 2009


Author: dmn
Date: Fri Jan  9 14:24:43 2009
New Revision: 29492

URL: http://svn.debian.org/wsvn/pkg-perl/?sc=1&rev=29492
Log:
POD: move description in the start, add some links

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=29492&op=diff
==============================================================================
--- trunk/dh-make-perl/dh-make-perl (original)
+++ trunk/dh-make-perl/dh-make-perl Fri Jan  9 14:24:43 2009
@@ -28,15 +28,40 @@
 
 =back
 
+=head1 DESCRIPTION
+
+B<dh-make-perl> will create the files required to build
+a debian source package out of a perl package.
+This works for most simple packages and is also useful
+for getting started with packaging perl modules.
+
+You can specify a module name with the L<--cpan|/cpan_dist> switch
+and B<dh-make-perl> will download the module for you from
+a CPAN mirror, or you can specify the directory with the
+already unpacked sources. If neither L<--cpan|/cpan_dist> nor a directory
+is given as argument, dh-make-perl tries to create a
+perl package from the data in the current directory.
+
+There is an override mechanism in place to handle most of
+the little changes that may be needed for some modules
+(this hasn't been tested much, though, and the override
+database needs to be filled in).
+
+You can build and install the debian package using the L</--build>
+and L</--install> command line switches.
+
+Using this program is no excuse for not reading the
+debian developer documentation, including the Debian policy,
+the perl policy, the packaging manual and so on.
+
 =head2 COMMANDS
 
 =over
 
 =item --make
 
-Default command if no command is given. Needs a source directory given as
-argument to the command line or the B<--cpan> option. Adds debianisation to
-upstream sources.
+Default command if no command is given. Creates debianisation from scratch.
+Fails with an error if L<debian/> directory already exists.
 
 =item --refresh
 
@@ -60,7 +85,7 @@
 
 Useful for populating L<dh-make-perl.conf> file.
 
-=over
+=back
 
 =head2 OPTIONS
 
@@ -133,6 +158,10 @@
 Sets C<Maintainer>, C<Uploaders>, C<Vcs-Svn> and C<Vcs-Browser> fields in
 debian/control accordingly, and sets packaging-related licensing to GPLv2.
 
+=item --cpan I<DIST>
+
+Instructs dh-make-perl to fetch and extract the given CPAN distribution.
+
 =item B<--cpan-mirror> I<MIRROR>
 
 Specifies a CPAN site to use as mirror.
@@ -264,32 +293,6 @@
 
 =back
 
-=head1 DESCRIPTION
-
-B<dh-make-perl> will create the files required to build
-a debian source package out of a perl package.
-This works for most simple packages and is also useful
-for getting started with packaging perl modules.
-
-You can specify a module name with the B<--cpan> switch
-and B<dh-make-perl> will download the module for you from
-a CPAN mirror, or you can specify the directory with the
-already unpacked sources. If neither --cpan nor a directory
-is given as argument, dh-make-perl tries to create a
-perl package from the data in F<.>
-
-There is an override mechanism in place to handle most of
-the little changes that may be needed for some modules
-(this hasn't been tested much, though, and the override
-database needs to be filled in).
-
-You can build and install the debian package using the --build
-and --install command line switches.
-
-Using this program is no excuse for not reading the
-debian developer documentation, including the Debian policy,
-the perl policy, the packaging manual and so on.
-
 =head1 FILES
 
 The following directories will be searched to find additional files




More information about the Pkg-perl-cvs-commits mailing list