[SCM] Debian package checker branch, master, updated. 1.24.3-12-g7d05c56
The following commit has been merged in the master branch:
commit 7e7f3d2ea43d67e89b39d0b7ce87b3d36e0e7c9e
Author: Jordà Polo <jorda@ettin.org>
Date: Thu Aug 7 15:50:53 2008 +0200
Add new references and fix typos
Some of the references have been extracted from `Info', so descriptions have
been updated accordingly.
diff --git a/checks/binaries.desc b/checks/binaries.desc
index 6a84e3e..8359044 100644
--- a/checks/binaries.desc
+++ b/checks/binaries.desc
@@ -167,6 +167,7 @@ Info: This package includes a *.so file in <tt>/usr/lib/perl5</tt>,
Tag: debug-file-should-use-detached-symbols
Type: warning
+Ref: devref 6.7.9
Info: This file is in a location generally used for detached debugging
symbols, but it appears to contain a complete copy of the executable or
library instead of only the debugging symbols. Files in subdirectories
diff --git a/checks/cruft.desc b/checks/cruft.desc
index 3e9a2af..44ea11b 100644
--- a/checks/cruft.desc
+++ b/checks/cruft.desc
@@ -28,6 +28,7 @@ Info: Leaving <tt>debian/files</tt> causes problems for the autobuilders,
architecture, which will cause dpkg-buildpackage run by the buildd to fail.
.
The clean rule for the package should remove this file.
+Ref: policy 4.12
Tag: diff-contains-cvs-control-dir
Type: warning
diff --git a/checks/debconf.desc b/checks/debconf.desc
index 1acbecf..7005e34 100644
--- a/checks/debconf.desc
+++ b/checks/debconf.desc
@@ -26,8 +26,9 @@ Info: A template contains two identical fields (with identical values or
Tag: unknown-field-in-templates
Type: error
-Info: See the Debconf Programmer's Tutorial for a list of the possible
- fields in a debconf templates file.
+Info: Valid fields are currently `Template:', `Type:', `Choices:', `Default:',
+ and `Description:'.
+Ref: debconf-spec aen45, debconf-devel(7)
Tag: no-template-name
Type: error
@@ -71,15 +72,18 @@ Tag: select-without-choices
Type: error
Info: Templates using the `select' or `multiselect' data types must provide
a `Choices:' field listing the possible values of the template.
+Ref: debconf-spec aen45, debconf-devel(7)
Tag: boolean-template-has-bogus-default
Type: error
Info: The `boolean' type in a debconf template, can have only two values: true
and false. The default has been set to something different.
+Ref: debconf-spec aen45, debconf-devel(7)
Tag: no-template-description
Type: error
Info: The templates file contains a template without a `Description:' field.
+Ref: debconf-spec aen45, debconf-devel(7)
Tag: duplicate-long-description-in-template
Type: warning
@@ -109,6 +113,7 @@ Type: warning
Info: The maintainer script uses an obsolete name for a debconf confmodule.
Shell scripts should source <tt>/usr/share/debconf/confmodule</tt>, while
Perl scripts should use <tt>Debconf::Client::ConfModule</tt>.
+Ref: debconf-devel(7)
Tag: postrm-does-not-purge-debconf
Type: warning
@@ -160,6 +165,7 @@ Info: In the Unix tradition, Debian packages should have human-readable and
for questions. If you maintain a package containing such a program, please
install an override. Other exceptions to this check include configuration
scripts called from the package's post-installation script.
+Ref: devref 6.5.1, debconf-devel(7)
Tag: malformed-prompt-in-templates
Type: warning
diff --git a/checks/fields.desc b/checks/fields.desc
index 356e2ec..170a696 100644
--- a/checks/fields.desc
+++ b/checks/fields.desc
@@ -44,6 +44,7 @@ Type: warning
Info: The debian version part (the part after the -) should consist of one
or two dot-separated parts: one for a regular maintainer release or two
for a source-NMU.
+Ref: devref 5.11.2, policy 5.6.12
Tag: debian-revision-should-not-be-zero
Type: warning
@@ -281,6 +282,7 @@ Type: warning
Info: The `Homepage:' field in this package's control file contains
superfluous markup around the URL, like enclosing < and >.
This is unnecessary and needlessly complicates using this information.
+Ref: policy 5.6.23
Tag: bad-homepage
Type: warning
diff --git a/checks/files.desc b/checks/files.desc
index ac97f50..b3a3ba2 100644
--- a/checks/files.desc
+++ b/checks/files.desc
@@ -95,6 +95,7 @@ Info: As of policy version 3.0.0.0, Debian no longer follows the FSSTND.
.
Instead, the Filesystem Hierarchy Standard (FHS), version 2.3, is
used. You can find it in /usr/share/doc/debian-policy/fhs/ .
+Ref: policy 9.1.1
Tag: FSSTND-dir-in-var
Type: error
@@ -102,6 +103,7 @@ Info: As of policy version 3.0.0.0, Debian no longer follows the FSSTND.
.
Instead, the Filesystem Hierarchy Standard (FHS), version 2.3, is
used. You can find it in /usr/share/doc/debian-policy/fhs/ .
+Ref: policy 9.1.1
Tag: package-installs-into-etc-gconf-schemas
Type: warning
@@ -348,6 +350,7 @@ Tag: run-parts-cron-filename-contains-full-stop
Type: warning
Info: The script in /etc/cron.<time-interval> will not be executed by
run-parts(8) because the filename contains a "." (full stop).
+Ref: run-parts(8)
Tag: bad-permissions-for-etc-cron.d-script
Type: error
@@ -493,17 +496,20 @@ Info: All license information should be collected in the
Tag: non-standard-toplevel-dir
Type: error
Info: The Filesystem Hierarchy Standard forbids the installation of new
- files or directories in the root directory, in section 3.
+ files or directories in the root directory.
+Ref: fhs therootfilesystem
Tag: subdir-in-bin
Type: error
Info: The Filesystem Hierarchy Standard forbids the installation of new
directories in <tt>/bin</tt>.
+Ref: fhs binessentialusercommandbinaries
Tag: subdir-in-usr-bin
Type: error
Info: The Filesystem Hierarchy Standard forbids the installation of new
directories in <tt>/usr/bin</tt> other than <tt>/usr/bin/mh</tt>.
+Ref: fhs usrbinmostusercommands
Tag: non-standard-dir-in-usr
Type: warning
@@ -511,6 +517,7 @@ Info: The FHS says "No large software packages should use a direct
subdirectory under the <tt>/usr</tt> hierarchy". This package contains
a directory in <tt>/usr</tt> that is not mentioned in the Filesystem
Hierarchy Standard.
+Ref: fhs theusrhierarchy
Tag: non-standard-dir-in-var
Type: error
@@ -518,6 +525,7 @@ Info: The FHS says "Applications should generally not add directories to
the top level of <tt>/var</tt>. Such directories should only be added
if they have some system-wide implication, and in consultation with the
FHS mailing list."
+Ref: fhs thevarhierarchy
Tag: use-of-compat-symlink
Type: error
@@ -544,6 +552,7 @@ Info: Packages built using the perl MakeMaker package will have a file
.
or by telling MakeMaker to use vendor install dirs; consult a recent
version of Perl policy. Perl 5.6.0-12 or higher supports this.
+Ref: perl-policy 4.1
Tag: zero-byte-file-in-doc-directory
Type: warning
@@ -554,6 +563,7 @@ Type: error
Info: Location of per package overrides the file
/usr/share/lintian/overrides/package. See the lintian documentation for more
info on proper naming and format.
+Ref: lintian 2.4
Tag: package-contains-upstream-install-documentation
Type: warning
@@ -575,6 +585,7 @@ Info: The package contains a hardlink in <tt>/etc</tt> or across different
does dpkg in certain cases.
.
A better solution might be using symlinks here.
+Ref: policy 10.7.3
Tag: package-contains-bts-control-dir
Type: warning
@@ -625,6 +636,7 @@ Info: Architecture-independent Perl code should be placed in
<tt>/usr/share/perl5</tt>, not <tt>/usr/lib/perl5</tt>
unless there is at least one architecture-dependent file
in the module.
+Ref: perl-policy 2.3
Tag: file-in-usr-lib-site-python
Type: error
@@ -739,6 +751,7 @@ Info: This package provides at least one file in <tt>/usr/lib/debug</tt>,
which is intended for detached debugging symbols, but the package name
does not end in "-dbg". Detached debugging symbols should be put into a
separate package, Priority: extra, with a package name ending in "-dbg".
+Ref: devref 6.7.9
Tag: package-contains-linda-override
Type: warning
diff --git a/checks/init.d.desc b/checks/init.d.desc
index efbbae7..bbf91ea 100644
--- a/checks/init.d.desc
+++ b/checks/init.d.desc
@@ -38,6 +38,7 @@ Type: error
Info: An <tt>/etc/init.d</tt> script which has been registered in the
<tt>postinst</tt> script is not de-registered in the
<tt>postrm</tt> script.
+Ref: policy 9.3.3.1
Tag: postrm-contains-additional-updaterc.d-calls
Type: error
diff --git a/checks/lintian.desc b/checks/lintian.desc
index fd1b170..daf4866 100644
--- a/checks/lintian.desc
+++ b/checks/lintian.desc
@@ -17,6 +17,7 @@ Info: You've specified an unknown target distribution for your upload in
Note that the distributions <tt>non-free</tt> and <tt>contrib</tt> are no
longer valid. You'll have to use distribution <tt>unstable</tt> and
<tt>Section: non-free/xxx</tt> or <tt>Section: contrib/xxx</tt> instead.
+Ref: policy 5.6.14
Tag: bad-ubuntu-distribution-in-changes-file
Type: error
diff --git a/checks/manpages.desc b/checks/manpages.desc
index 6bae647..3e90124 100644
--- a/checks/manpages.desc
+++ b/checks/manpages.desc
@@ -98,10 +98,7 @@ Info: Each manual page should start with a `NAME' section, which lists the
are parsed by `mandb' and stored in a database for the use of `apropos' and
`whatis', so they must be in a certain format. This manual page apparently
uses the wrong format and cannot be parsed by `mandb'.
- .
- For information on how `NAME' sections should be written see lexgrog(1).
- See also groff_man(7) and groff_mdoc(7) for general information on writing
- manual pages.
+Ref: lexgrog(1), groff_man(7), groff_mdoc(7)
Tag: manpage-has-useless-whatis-entry
Type: warning
@@ -169,6 +166,7 @@ Info: Manual pages for binaries which are located in <tt>/usr/X11R6/bin</tt>
Note that normally only packages that are part of X itself and those that
are using some arcane Imakefiles should actually install binaries into
<tt>/usr/X11R6/bin</tt>.
+Ref: fhs usrsharemanmanualpages
Tag: manpage-for-non-x11-binary-in-wrong-directory
Type: error
@@ -178,6 +176,7 @@ Info: Manual pages for binaries that are not located in <tt>/usr/X11R6/bin</tt>
.
Note that moving a binary into <tt>/usr/X11R6/bin</tt> is almost never the
proper solution for this problem; move the manual page instead.
+Ref: fhs usrsharemanmanualpages
Tag: no-manpage-in-correct-directory
Type: warning
@@ -204,8 +203,8 @@ Tag: manpage-section-mismatch
Type: warning
Info: A man page usually should contain a <tt>.TH</tt> header, specifying the
section. The section in this manpage doesn't match with the section in the
- filename. Please consult groff_man(7) for more information about
- <tt>.TH</tt> syntax (amongst others).
+ filename.
+Ref: groff_man(7), man(1)
Tag: hyphen-used-as-minus-sign
Type: info
diff --git a/checks/menu-format.desc b/checks/menu-format.desc
index b7845fe..4029bf1 100644
--- a/checks/menu-format.desc
+++ b/checks/menu-format.desc
@@ -24,11 +24,13 @@ Type: error
Info: The menu file contains an item that does not start with the text
"?package(somepackage):". All menu file lines must test for the existence
of a package in this way.
+Ref: menu 3.2
Tag: unparsable-menu-item
Type: error
Info: An item of the menu file cannot be parsed as a series of tag=value
pairs. This could be because you didn't close a set of double quotes.
+Ref: menu 3.2
Tag: pkg-not-in-package-test
Type: warning
@@ -48,6 +50,7 @@ Tag: duplicated-tag-in-menu-item
Type: warning
Info: The menu item contains two instances of the same tag. This is just a
waste of space, as menu will only use one of them.
+Ref: menu 3.2
Tag: menu-item-missing-required-tag
Type: error
@@ -84,16 +87,19 @@ Tag: menu-item-uses-apps-games-section
Type: warning
Info: The menu item has a line that specifies a section under "Apps/Games".
This section has been moved to just "Games".
+Ref: menu-policy 2.1
Tag: menu-item-uses-apps-section
Type: warning
Info: The menu item has a line that specifies a section under "Apps".
This section has been moved to "Applications".
+Ref: menu-policy 2.1
Tag: menu-item-uses-windowmanagers-section
Type: warning
Info: The menu item has a line that specifies a section under
"WindowManagers". This section has been moved to "Window Managers".
+Ref: menu-policy 2.1
Tag: menu-item-creates-new-section
Type: warning
diff --git a/checks/menus.desc b/checks/menus.desc
index 6aff4f2..efd025e 100644
--- a/checks/menus.desc
+++ b/checks/menus.desc
@@ -42,9 +42,9 @@ Info: The maintainer script calls the <tt>install-docs</tt> command without
Tag: maintainer-script-calls-deprecated-wm-menu-config
Type: warning
-Info: The use of the wm-menu-config script is deprecated because it's
- design had some serious flaws. Please see the menu documentation,
- chapter 5 for more information.
+Info: The use of the wm-menu-config script is deprecated because its design
+ had some serious flaws.
+Ref: menu 5
Tag: preinst-calls-updatemenus
Type: error
@@ -77,6 +77,7 @@ Info: As of menu, version 2.1.25, /usr/lib/menu as location for menu
files is deprecated (but still works perfectly). Menu files should
now be placed in /usr/share/menu instead. Only menu files that are
actually binary executables still need to go to /usr/lib/menu.
+Ref: menu 3.1
Tag: executable-in-usr-share-docbase
Type: error
@@ -92,6 +93,7 @@ Info: Since the package installs a file in <tt>/usr/share/doc-base</tt>, the
if [ -x /usr/sbin/install-docs ]; then
/usr/sbin/install-docs -i /usr/share/doc-base/<your-package>
fi
+Ref: doc-base 2.4
Tag: prerm-does-not-call-installdocs
Type: error
@@ -103,6 +105,7 @@ Info: Since the package installs a file in <tt>/usr/share/doc-base</tt>, the
if [ -x /usr/sbin/install-docs ]; then
/usr/sbin/install-docs -r <your-package> || true
fi
+Ref: doc-base 2.4
Tag: postinst-does-not-call-updatemenus
Type: error
@@ -112,6 +115,7 @@ Info: Since the package installs a file in either <tt>/usr/lib/menu</tt> or
.
For example, use the following code in your maintainer script:
if [ -x /usr/bin/update-menus ] ; then update-menus ; fi
+Ref: menu 4.2
Tag: postrm-does-not-call-updatemenus
Type: error
@@ -121,6 +125,7 @@ Info: Since the package installs a file in either <tt>/usr/lib/menu</tt> or
.
For example, use the following code in your maintainer script:
if [ -x /usr/bin/update-menus ] ; then update-menus ; fi
+Ref: menu 4.2
Tag: postinst-has-useless-call-to-update-menus
Type: warning
diff --git a/checks/nmu.desc b/checks/nmu.desc
index e7e758f..a4a37a5 100644
--- a/checks/nmu.desc
+++ b/checks/nmu.desc
@@ -26,6 +26,7 @@ Info: A source NMU should have a Debian revision of "-x.x" (or "+nmuX" for a
Maybe you didn't intend this upload to be a NMU, in that case, please
doublecheck that the most recent entry in the changelog is byte-for-byte
identical to the maintainer or one of the uploaders.
+Ref: devref 5.11.2
Tag: maintainer-upload-has-incorrect-version-number
Type: warning
diff --git a/checks/po-debconf.desc b/checks/po-debconf.desc
index 2a57de8..faae06d 100644
--- a/checks/po-debconf.desc
+++ b/checks/po-debconf.desc
@@ -59,8 +59,8 @@ Info: The name of this PO file doesn't appear to be a valid language
code. Any files in <tt>debian/po</tt> ending in <tt>.po</tt> will be
processed as translations by po2debconf for the language code equal to
the file name without the trailing <tt>.po</tt>. If the file name does
- not correct reflect the language of the translation, the translation will
- not be accessible to users of that language.
+ not correctly reflect the language of the translation, the translation
+ will not be accessible to users of that language.
.
If this file isn't actually a PO file, rename it to something that
doesn't end in <tt>.po</tt> or move it to another directory so that
diff --git a/checks/scripts.desc b/checks/scripts.desc
index 1fffe90..366fc47 100644
--- a/checks/scripts.desc
+++ b/checks/scripts.desc
@@ -234,6 +234,7 @@ Info: The maintainer script seems to calll <tt>start-stop-daemon</tt>
directly. Long-running daemons should be started and stopped via init
scripts using <tt>invoke-rc.d</tt> rather than directly in maintainer
scripts.
+Ref: policy 9.3.3.2
Tag: maintainer-script-removes-device-files
Type: error
@@ -319,6 +320,7 @@ Info: <tt>update-alternatives --remove <alternative> foo</tt> is
.
<tt>update-alternatives --remove</tt> should be called in the prerm
instead.
+Ref: policy F, update-alternatives(8)
Tag: deprecated-chown-usage
Type: warning
@@ -326,6 +328,7 @@ Info: <tt>chown user.group</tt> is called in one of the maintainer
scripts. The correct syntax is <tt>chown user:group</tt>. Using "." as a
separator is still supported by the GNU tools, but it will fail as soon
as a system uses the "." in user or group names.
+Ref: chown(1)
Tag: maintainer-script-hides-init-failure
Type: warning
diff --git a/checks/shared-libs.desc b/checks/shared-libs.desc
index 2e2866a..3343456 100644
--- a/checks/shared-libs.desc
+++ b/checks/shared-libs.desc
@@ -305,6 +305,7 @@ Type: error
Info: The symbols control file contains an unknown meta-information field.
.
A list of currently supported fields may be found in deb-control(5).
+Ref: deb-control(5)
Tag: symbols-declared-but-not-shlib
Type: error
--
Debian package checker
Reply to: