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