Check-Script: watch-file Author: Patrick Schoenfeld Abbrev: watch Type: source Needs-Info: debfiles Info: Check debian/watch files in source packages. Tag: debian-watch-file-is-missing Severity: wishlist Certainty: certain Ref: policy 4.11, uscan(1) Info: This source package is not Debian-native but it does not have a debian/watch file. This file is used for automatic detection of new upstream versions by the Debian External Health Status project and other project infrastructure. If this package is maintained upstream, please consider adding a debian/watch file to detect new releases. . If the package is not maintained upstream or if upstream uses a distribution mechanism that cannot be meaningfully monitored by uscan and the Debian External Health Status project, please consider adding a debian/watch file containing only comments documenting the situation. Tag: debian-watch-file-declares-multiple-versions Severity: normal Certainty: certain Ref: uscan(1) Info: The debian/watch file in this package contains multiple lines starting with version=. There should be only one version declaration in a watch file, on the first non-comment line of the file. Tag: debian-watch-file-unknown-version Severity: normal Certainty: certain Ref: uscan(1) Info: The version= line in the debian/watch file in this package declares an unknown version. The currently known watch file versions are 2 and 3. Tag: debian-watch-file-missing-version Severity: normal Certainty: certain Ref: uscan(1) Info: The debian/watch file in this package doesn't start a version= line. The first non-comment line of debian/watch should be a version= declaration. This may mean that this is an old version one watch file that should be updated to the current version. Tag: debian-watch-file-should-mangle-version Severity: normal Certainty: certain Ref: uscan(1), http://wiki.debian.org/DEHS Info: The version of this package contains dfsg, ds, or debian, which normally indicates that the upstream source has been repackaged to comply with the Debian Free Software Guidelines (or similar reason), but there is no version mangling in the debian/watch file. Since the dfsg string is not part of the upstream version, the debian/watch file should use the dversionmangle option to remove the dfsg before version number comparison. Tag: debian-watch-file-should-dversionmangle-not-uversionmangle Severity: wishlist Certainty: certain Ref: http://wiki.debian.org/DEHS Info: The version of this package contains dfsg, ds, or debian, but a misleading upstream version mangling occurs in the debian/watch file. Since the dfsg string is not part of the upstream version and its addition is Debian-specific, the the debian/watch file should use the dversionmangle option to remove, instead of adding in uversionmangle, the dfsg before comparing version numbers. Tag: debian-watch-file-should-uversionmangle-not-dversionmangle Severity: wishlist Certainty: certain Ref: http://wiki.debian.org/DEHS Info: The version of this package contains alpha, beta, or rc, but a misleading Debian version mangling occurs in the debian/watch file. You should use the uversionmangle option instead of dversionmangle so that the prerelease is sorted by uscan before a possible future final release. Tag: debian-watch-file-in-native-package Severity: normal Certainty: certain Ref: http://wiki.debian.org/DEHS Info: The package ships a watch file although it is a Debian native package. DEHS does not process watch files in native packages based on the reasoning that native packages do not have upstreams to check for new releases. Tag: debian-watch-file-uses-deprecated-sf-redirector-method Severity: normal Certainty: certain Info: The watch file seems to be passing arguments to the redirector other than a path. Calling the SourceForge redirector with parameters like project prevents uscan from generating working URIs to the files and thus has been deprecated and is no longer supported by the redirector. Tag: debian-watch-file-should-use-sf-redirector Severity: normal Certainty: certain Ref: uscan(1) Info: The watch file specifies a SourceForge page or download server directly. This is not recommended; SourceForge changes their download servers and website periodically, requiring watch files to be modified every time. Instead, use the qa.debian.org redirector by using the magic URL: . http://sf.net/<project>/<tar-name>-(.+)\.tar\.gz . replacing <project> with the name of the SourceForge project and <tar-name> with the name of the tarball distributed within that project. Adjust the filename regex as necessary. Tag: debian-watch-file-specifies-wrong-upstream-version Severity: normal Certainty: certain Ref: uscan(1) Info: The watch file specifies an upstream version which exactly matches the version of a debian/changelog entry, this is not a native package, and no version mangling is being done. The version field in a watch file should specify the expected upstream version, not the version of the Debian package. Any epochs and Debian revisions should be removed first or mangled away. Tag: debian-watch-file-specifies-old-upstream-version Severity: normal Certainty: certain Info: The watch file specifies an upstream version number which matches the upstream portion of an old debian/changelog entry, and the current debian/changelog entry specifies a newer upstream version. The version number in the watch file is very likely to be incorrect and probably should be replaced with the current expected upstream version. Otherwise, DEHS and similar projects will think the package is out of date even when it may not be. Tag: debian-watch-contains-dh_make-template Severity: wishlist Certainty: certain Info: The watch file contains a standard template included by dh_make. Please remove them once you have implemented the watch file.