r23909 - /website/howto/adopt.pod
gregoa at users.alioth.debian.org
gregoa at users.alioth.debian.org
Thu Aug 7 21:22:44 UTC 2008
Author: gregoa
Date: Thu Aug 7 21:22:42 2008
New Revision: 23909
URL: http://svn.debian.org/wsvn/?sc=1&rev=23909
Log:
integrate a couple of improvements from gwolf into adopt.pod, thanks
Modified:
website/howto/adopt.pod
Modified: website/howto/adopt.pod
URL: http://svn.debian.org/wsvn/website/howto/adopt.pod?rev=23909&op=diff
==============================================================================
--- website/howto/adopt.pod (original)
+++ website/howto/adopt.pod Thu Aug 7 21:22:42 2008
@@ -5,10 +5,10 @@
=head1 0. Introduction
This short How-to tries to give some useful hints for adopting packages for
-the Debian Perl Group. It's no exhaustive tutorial and not necessarily
+the Debian Perl Group. It's not an exhaustive tutorial and not necessarily
complete.
-C<Adoption> means to take over a package for the Debian Perl Group that was
+C<Adopting> means to take over a package for the Debian Perl Group that was
maintained by someone else beforehand; the package may be officially
orphaned or offered for adoption, or the previous maintainer may just have
asked for or agreed to having it moved to the group.
@@ -40,8 +40,8 @@
"-c 0" switch and/or move the tarball around.
Setting the correct svn-bp svn properties (cf.
-F</usr/share/doc/svn-buildpackage/CONFIG>) on C<$newpkg/debian> helps for
-further C<svn-upgrade>'s.
+F</usr/share/doc/svn-buildpackage/CONFIG>) on
+C<$your_new_package_directory/debian> helps for further C<svn-upgrade>'s.
=head2 Helper scripts
@@ -51,7 +51,7 @@
or a link to a message with the request for takeover from the maintainer.
F<fill_svn_props> (again in C<svn+ssh://svn.debian.org/svn/pkg-perl/scripts/>)
-sets the svn-bp svn properties on F<$newpkg/debian>.
+sets the svn-bp svn properties on C<$your_new_package_directory/debian>.
=head1 3. Changing the package
@@ -102,8 +102,12 @@
=head2 debian/watch
-Create or check a F<debian/watch> file, usually using the distribution-based
-CPAN URL. [*]
+Create a new or check an existing F<debian/watch> file.
+Whenever possible, please use a dist-based URL, such as
+
+ http://search.cpan.org/dist/Foo-Bar/ .*/Foo-Bar-v?(\d[\d_.]+)\.(?:tar(?:\.gz|\.bz2)?|tgz|zip)$
+
+instead of pointing to the module or author directories in CPAN, or in external repositories. [*]
=head2 debian/copyright
@@ -147,13 +151,16 @@
=item *
+Carefully review the existing F<debian/rules>. In order to maintain consistency
+and ease maintenance, you will probably prefer replacing it with our
+standard templates.
+
+=item *
+
+A simple way for bringing the file in line with current pratices is:
+
Take a look at the current F<debian/rules> and try to remember anything
special.
-
-=item *
-
-Often an update is helpful to get the file in line with current practices. A
-simple way is
$ dh-make-perl --refresh --dh (5|7)
$ svn diff
@@ -231,7 +238,7 @@
=item *
If the package already uses C<quilt> make sure the relevant lines are still
-in F<debian/rules> after "d-make-perl --refresh" and maybe refresh the
+in F<debian/rules> after "dh-make-perl --refresh" and maybe refresh the
patches; cf. L<http://pkg-perl.alioth.debian.org/howto/quilt.html> for
details.
More information about the Pkg-perl-cvs-commits
mailing list