1 Check-Script: debhelper
2 Author: Joey Hess <joeyh@debian.org>
6 Info: This looks for common mistakes in debhelper source packages.
7 Needs-Info: debfiles, source-control-file
9 Tag: maintainer-script-lacks-debhelper-token
11 Info: This package is built using debhelper commands that may modify
12 maintainer scripts, but the maintainer scripts do not contain
13 the "#DEBHELPER#" token debhelper uses to modify them.
15 Adding the token to the scripts is recommended.
17 Tag: package-uses-debhelper-but-lacks-build-depends
19 Info: If a package uses debhelper, it must declare a Build-Depends
22 Tag: package-lacks-versioned-build-depends-on-debhelper
24 Info: If a package sets debhelper's compatibility version to >= 5,
25 either via DH_COMPAT, or via debian/compat, or via dh_testversion
26 (which is deprecated), it should declare a versioned Build-Depends on
27 the needed version of debhelper.
29 All versions of debhelper back to etch support compatibility version 5,
30 but the debhelper released with sarge did not, so this dependency is
31 still helpful for oldstable backports.
33 Tag: dh-make-template-in-source
35 Info: This package contains debian/*.ex and/or debian/ex.* files
36 installed by dh_make. These are intended to be filled in with the
37 package's details and renamed for use by various debhelper commands.
38 If they are not being used, they should be removed.
40 Tag: dh_testversion-is-deprecated
42 Ref: dh_testversion(1)
43 Info: This package calls dh_testversion in its <tt>debian/rules</tt> file.
44 dh_testversion is deprecated. Packages using debhelper should use
45 versioned build dependencies to ensure that the correct version of
46 debhelper is installed.
48 Tag: dh_dhelp-is-deprecated
50 Info: This package calls dh_dhelp in its <tt>debian/rules</tt> file.
51 dh_dhelp is deprecated as it is not part of the canonical debhelper suite
52 and due to be removed since it supports only one single documentation
55 Simply use dh_installdocs, which creates doc-base files and supports all of
56 the documentation systems that way.
58 Tag: dh_suidregister-is-obsolete
60 Ref: dh_suidregister(1)
61 Info: suidregister is obsoleted by dpkg-statoverride, so registration of
62 files in with dh_suidregister is unnecessary, and even harmful.
64 Tag: debhelper-compat-file-is-empty
67 Info: The source package has an empty debian/compat file. This is an error,
68 the compat level of debhelper should be in there.
70 Tag: declares-possibly-conflicting-debhelper-compat-versions
73 Info: The source package declares the debhelper compatibility version
74 both in the <tt>debian/compat</tt> file and in the <tt>debian/rules</tt>
75 file. If these ever get out of synchronisation, the package may not build
78 Tag: package-uses-deprecated-debhelper-compat-version
81 Info: The debhelper compatibility version used by this package is marked
82 as deprecated by the debhelper developer. You should really consider
83 using a newer compatibility version.
85 The compatibility version can be set in (preferred)
86 <tt>debian/compat</tt> or by setting and exporting DH_COMPAT in
87 <tt>debian/rules</tt>. If it is not set in either place, debhelper
88 defaults to the deprecated compatibility version 1.
90 Tag: package-needs-python-policy-debhelper
92 Info: The source package requests dh_python compatibility level 2 (or
93 higher) in <tt>debian/pycompat</tt> but doesn't depend on a new enough
94 debhelper. A Build-Depends on debhelper (>= 5.0.37.2) is required for
97 All versions of debhelper back to etch support this, but the debhelper
98 released with sarge did not, so this dependency is still helpful for
101 Tag: uses-dh-python-with-no-pycompat
103 Info: This package uses dh_python but apparently does not tell it to use
104 the current Python policy by putting 2 in <tt>debian/pycompat</tt>. This
105 may mean that the package has not been converted to the current Python
106 policy, in which case it probably should be.
108 Tag: debhelper-script-needs-versioned-build-depends
110 Info: The given debhelper script was introduced in a later version of
111 debhelper than the package Build-Depends on. The package Build-Depends
112 should be updated to require that version of debhelper. Giving the
113 version followed by <tt>~</tt> is recommended so that backports will
114 satisfy the dependency.