vcs.maemo.org Git - maemian/blob - nokia-lintian/checks/watch-file.desc

   1 Check-Script: watch-file
   2 Author: Patrick Schoenfeld <schoenfeld@in-medisa-res.com>
   3 Abbrev: watch
   4 Type: source
   5 Unpack-Level: 1
   6 Needs-Info: debfiles
   7 Info: Check debian/watch files in source packages.
   8
   9 Tag: debian-watch-file-is-missing
  10 Type: info
  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
  17  releases.
  18  .
  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
  23  situation.
  24
  25 Tag: debian-watch-file-declares-multiple-versions
  26 Type: warning
  27 Ref: uscan(1)
  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.
  31
  32 Tag: debian-watch-file-unknown-version
  33 Type: warning
  34 Ref: uscan(1)
  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
  37  versions are 2 and 3.
  38
  39 Tag: debian-watch-file-missing-version
  40 Type: warning
  41 Ref: uscan(1)
  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.
  47
  48 Tag: debian-watch-file-should-mangle-version
  49 Type: warning
  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.
  59
  60 Tag: debian-watch-file-should-dversionmangle-not-uversionmangle
  61 Type: info
  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.
  70
  71 Tag: debian-watch-file-in-native-package
  72 Type: warning
  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
  77  releases.
  78
  79 Tag: debian-watch-file-uses-deprecated-sf-redirector-method
  80 Type: warning
  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.