1 Check-Script: watch-file
2 Author: Patrick Schoenfeld <schoenfeld@in-medisa-res.com>
7 Info: Check debian/watch files in source packages.
9 Tag: debian-watch-file-is-missing
11 Ref: policy 4.11, uscan(1)
12 Info: This source package is not Debian-native but it does not have a
13 <tt>debian/watch</tt> file. This file is used for automatic detection of
14 new upstream versions by the Debian External Health Status project and
15 other project infrastructure. If this package is maintained upstream,
16 please consider adding a <tt>debian/watch</tt> file to detect new
19 If the package is not maintained upstream or if upstream uses a
20 distribution mechanism that cannot be meaningfully monitored by uscan
21 and the Debian External Health Status project, please consider adding a
22 <tt>debian/watch</tt> file containing only comments documenting the
25 Tag: debian-watch-file-declares-multiple-versions
28 Info: The <tt>debian/watch</tt> file in this package contains multiple
29 lines starting with <tt>version=</tt>. There should be only one version
30 declaration in a watch file, on the first non-comment line of the file.
32 Tag: debian-watch-file-unknown-version
35 Info: The <tt>version=</tt> line in the <tt>debian/watch</tt> file in this
36 package declares an unknown version. The currently known watch file
39 Tag: debian-watch-file-missing-version
42 Info: The <tt>debian/watch</tt> file in this package doesn't start a
43 <tt>version=</tt> line. The first non-comment line of
44 <tt>debian/watch</tt> should be a <tt>version=</tt> declaration. This
45 may mean that this is an old version one watch file that should be
46 updated to the current version.
48 Tag: debian-watch-file-should-mangle-version
50 Ref: uscan(1), http://wiki.debian.org/DEHS
51 Info: The version of this package contains <tt>dfsg</tt>, <tt>ds</tt>,
52 or <tt>debian</tt>, which normally indicates that the upstream source
53 has been repackaged to comply with the Debian Free Software Guidelines
54 (or similar reason), but there is no version mangling in the
55 <tt>debian/watch</tt> file. Since the <tt>dfsg</tt> string is not
56 part of the upstream version, the <tt>debian/watch</tt> file should
57 use the dversionmangle option to remove the <tt>dfsg</tt> before
58 version number comparison.
60 Tag: debian-watch-file-should-dversionmangle-not-uversionmangle
62 Ref: http://wiki.debian.org/DEHS
63 Info: The version of this package contains <tt>dfsg</tt>, <tt>ds</tt>,
64 or <tt>debian</tt>, but a misleading upstream version mangling occurs in
65 the <tt>debian/watch</tt> file. Since the <tt>dfsg</tt> string is not
66 part of the upstream version and its addition is Debian-specific, the
67 the <tt>debian/watch</tt> file should use the dversionmangle option to
68 remove, instead of adding in uversionmangle, the <tt>dfsg</tt> before
69 comparing version numbers.
71 Tag: debian-watch-file-in-native-package
73 Ref: http://wiki.debian.org/DEHS
74 Info: The package ships a watch file although it is a Debian native
75 package. DEHS does not process watch files in native packages based on
76 the reasoning that native packages do not have upstreams to check for new
79 Tag: debian-watch-file-uses-deprecated-sf-redirector-method
81 Info: The watch file seems to be passing arguments to the redirector
82 other than a path. Calling the SourceForge redirector with parameters like
83 <tt>project</tt> prevents uscan from generating working uri's to the files
84 and thus has been deprecated and is no longer supported by the redirector.