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