Re: watch files

[gregor herrmann <gregor+debian@comodo.priv.at>]

On Mon, 07 Jan 2008 19:54:25 +0100, gregor herrmann wrote:

> Anyway, mentioning watch files in policy is no error I guess. Here
> goes the first proposal:

As there were no more comments since about 9 days I've commited the
change now (with the minor improvements).

(I'm attaching the diff for convenience.)


Cheers,
gregor
 
-- 
 .''`.   http://info.comodo.priv.at/ | gpg key ID: 0x00F3CFE4
 : :' :  debian: the universal operating system - http://www.debian.org/
 `. `'   member of https://www.vibe.at/ | how to reply: http://got.to/quote/
   `-    NP: Blumfeld: Graue Wolken

Index: policy.pod
===================================================================
--- policy.pod	(revision 13056)
+++ policy.pod	(working copy)
@@ -25,14 +25,16 @@
 
 =item 3. L<debian/control handling|/"debian/control handling">
 
-=item 4. L<Debian Maintainers practice|/"Debian Maintainers practice">
+=item 4. L<debian/watch handling|/"debian/watch handling">
 
-=item 5. L<Release Process|/"Release Process">
+=item 5. L<Debian Maintainers practice|/"Debian Maintainers practice">
 
-=item 6. L<Authors|/"Authors">
+=item 6. L<Release Process|/"Release Process">
 
-=item 7. L<License|/"License">
+=item 7. L<Authors|/"Authors">
 
+=item 8. L<License|/"License">
+
 =back
 
 =head1 Mandatory mailing lists and such
@@ -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.

Attachment: signature.asc
Description: Digital signature