r13057 - /website/policy.pod

[gregoa-guest at users.alioth.debian.org]

Author: gregoa-guest
Date: Sun Jan 20 00:09:12 2008
New Revision: 13057

URL: http://svn.debian.org/wsvn/?sc=1&rev=13057
Log:
add paragraph about debian/watch

Modified:
    website/policy.pod

Modified: website/policy.pod
URL: http://svn.debian.org/wsvn/website/policy.pod?rev=13057&op=diff
==============================================================================
--- website/policy.pod (original)
+++ website/policy.pod Sun Jan 20 00:09:12 2008
@@ -25,13 +25,15 @@
 
 =item 3. L<debian/control handling|/"debian/control handling">
 
-=item 4. L<Debian Maintainers practice|/"Debian Maintainers practice">
-
-=item 5. L<Release Process|/"Release Process">
-
-=item 6. L<Authors|/"Authors">
-
-=item 7. L<License|/"License">
+=item 4. L<debian/watch handling|/"debian/watch handling">
+
+=item 5. L<Debian Maintainers practice|/"Debian Maintainers practice">
+
+=item 6. L<Release Process|/"Release Process">
+
+=item 7. L<Authors|/"Authors">
+
+=item 8. L<License|/"License">
 
 =back
 
@@ -135,6 +137,20 @@
 suggest you don't use cdbs as part of the build process for packages intended
 to be group-maintained.
 
+=head1 debian/watch handling
+
+Each package should have a watch file (F<debian/watch>) to make manual and
+automatic checking for new upstream versions easier. The recommended format
+for a watch file for a typical module I<libfoo-bar-perl> hosted on CPAN is:
+
+ version=3
+ # URL to the package page followed by a regex to search
+ http://search.cpan.org/dist/Foo-Bar/   .*/Foo-Bar-v?(\d[\d_.]+)\.(?:tar(?:\.gz|\.bz2)?|tgz|zip)
+
+(Scanning the distribution-based CPAN URLs is usually much faster than
+scanning /(by-)module/ ones; author-based URLs become invalid as soon as
+there's a change in maintainership.)
+
 =head1 Debian Maintainers practice
 
 This section describes briefly how the Debian Maintainers (DM) concept (cf.