[SCM] Debian package checker branch, master, updated. 1.24.4-57-gcfdcbc8
The following commit has been merged in the master branch:
commit 0feca930a90f63c6ee98463259ee6e56d8ca1a5e
Author: Jordà Polo <jorda@ettin.org>
Date: Thu Jul 10 19:12:00 2008 +0200
Add Severity/Certainty headers to "debconf" tags
diff --git a/checks/debconf.desc b/checks/debconf.desc
index 7005e34..b36933f 100644
--- a/checks/debconf.desc
+++ b/checks/debconf.desc
@@ -8,11 +8,15 @@ Needs-Info: scripts
Tag: missing-debconf-dependency
Type: warning
+Severity: normal
+Certainty: possible
Info: Packages using debconf should depend on it, since debconf is not an
essential package.
Tag: missing-debconf-dependency-for-preinst
Type: warning
+Severity: normal
+Certainty: possible
Info: Packages using debconf in their preinst script must pre-depend
on debconf, with appropriate discussion on &debdev;. Since debconf is
almost always already installed, this is normally better than depending
@@ -20,44 +24,60 @@ Info: Packages using debconf in their preinst script must pre-depend
Tag: duplicate-fields-in-templates
Type: error
+Severity: important
+Certainty: certain
Info: A template contains two identical fields (with identical values or
not). This is either an error in this template, or two templates are
not properly separated by a lone newline.
Tag: unknown-field-in-templates
Type: error
+Severity: important
+Certainty: certain
Info: Valid fields are currently `Template:', `Type:', `Choices:', `Default:',
and `Description:'.
Ref: debconf-spec aen45, debconf-devel(7)
Tag: no-template-name
Type: error
+Severity: important
+Certainty: certain
Info: The templates file contains a template without a `Template:' field.
Tag: malformed-template-name
Type: error
+Severity: important
+Certainty: certain
Info: The `Template:' field should contain more than one component, each
separated by a slash (`/'). Each component may only consist of the
alphanumeric characters, `+', `-', and `.'.
Tag: no-template-type
Type: error
+Severity: important
+Certainty: certain
Info: The templates file contains a template without a `Type:' field.
Tag: unknown-template-type
Type: error
+Severity: important
+Certainty: certain
Info: A `Type:' field in a templates file provided by this package uses an
unknown data type. Valid types are currently `string', `boolean', `select',
`multiselect', `note', `text', and `password'.
Tag: empty-translated-choices
Type: error
+Severity: important
+Certainty: possible
Info: When the translation of a Choices: field is empty, the whole question
is skipped (and nothing is selected). Please verify that the translation
you're using is valid.
Tag: mismatch-translated-choices
Type: error
+Severity: important
+Certainty: certain
Info: A `Choices:' field is a comma separated list, and translated
`Choices:' fields must have the exact same number of elements. One
of the translations does not follow this rule, you should contact the
@@ -70,33 +90,45 @@ Info: A `Choices:' field is a comma separated list, and translated
Tag: select-without-choices
Type: error
+Severity: important
+Certainty: certain
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
+Severity: important
+Certainty: certain
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
+Severity: important
+Certainty: certain
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
+Severity: minor
+Certainty: certain
Info: The long description of one of the templates provided by this package
is a duplicate of the short description. If you cannot provide a good
extended description, it is better to leave it blank.
Tag: config-does-not-load-confmodule
Type: warning
+Severity: normal
+Certainty: possible
Info: The config script must load one of the debconf libraries.
Tag: postinst-uses-db-input
Type: warning
+Severity: normal
+Certainty: possible
Info: It is generally not a good idea for postinst scripts to use debconf
commands like <tt>db_input</tt>. Typically, they should restrict themselves
to <tt>db_get</tt> to request previously acquired information, and have the
@@ -104,12 +136,16 @@ Info: It is generally not a good idea for postinst scripts to use debconf
Tag: postinst-does-not-load-confmodule
Type: warning
+Severity: normal
+Certainty: certain
Info: Even if your postinst does not involve debconf, you currently need to
make sure it loads one of the debconf libraries. This will be changed in
the future.
Tag: loads-obsolete-confmodule
Type: warning
+Severity: normal
+Certainty: certain
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>.
@@ -117,12 +153,16 @@ Ref: debconf-devel(7)
Tag: postrm-does-not-purge-debconf
Type: warning
+Severity: normal
+Certainty: certain
Info: Packages using debconf should call <tt>db_purge</tt> or its equivalent
in their postrm. If the package uses debhelper, dh_installdebconf(1) should
take care of this.
Tag: isdefault-flag-is-deprecated
Type: warning
+Severity: normal
+Certainty: possible
Info: The 'isdefault' flag on debconf questions is deprecated as of debconf
0.5.00, and has been replaced by 'seen' with the inverse meaning. From
debconf 0.5 onwards there should be very few reasons to use isdefault/seen
@@ -135,23 +175,31 @@ Info: The 'isdefault' flag on debconf questions is deprecated as of debconf
Tag: debconf-config-not-executable
Type: error
+Severity: important
+Certainty: certain
Info: The debconf `config' script in the package control area must be
executable.
Tag: no-debconf-config
Type: warning
+Severity: normal
+Certainty: possible
Info: The package contains a `templates' file in its control area but has no
corresponding `config' script. This is occasionally OK, but is usually an
error.
Tag: no-debconf-templates
Type: warning
+Severity: normal
+Certainty: possible
Info: The package contains a `config' script in its control area but has no
corresponding `templates' file. This is occasionally OK, but is usually an
error.
Tag: debconf-is-not-a-registry
Type: warning
+Severity: important
+Certainty: wild-guess
Info: In the Unix tradition, Debian packages should have human-readable and
human-editable configuration files. This package uses debconf commands
outside its maintainer scripts, which often indicates that it is taking
@@ -169,6 +217,8 @@ Ref: devref 6.5.1, debconf-devel(7)
Tag: malformed-prompt-in-templates
Type: warning
+Severity: normal
+Certainty: possible
Info: The short description of a select, multiselect, string and password
debconf template is a prompt and not a title. Avoid question style
prompts ("IP Address?") in favour of "opened" prompts ("IP address:").
@@ -180,6 +230,8 @@ Ref: devref 6.5.4.2
Tag: malformed-title-in-templates
Type: warning
+Severity: normal
+Certainty: possible
Info: The short description of a note debconf template should be written
as a title and therefore should not end with a period, question mark,
colon, or semicolon.
@@ -187,6 +239,8 @@ Ref: devref 6.5.4.2.4
Tag: malformed-question-in-templates
Type: warning
+Severity: normal
+Certainty: possible
Info: The short description of a boolean debconf template should be
phrased in the form of a question which should be kept short and should
generally end with a question mark. Terse writing style is permitted and
@@ -198,6 +252,8 @@ Ref: devref 6.5.4.2.2
Tag: using-question-in-extended-description-in-templates
Type: warning
+Severity: normal
+Certainty: possible
Info: The extended description of a debconf template should never include
a question.
.
@@ -207,6 +263,8 @@ Ref: devref 6.5.3.2
Tag: using-imperative-form-in-templates
Type: warning
+Severity: normal
+Certainty: possible
Info: Do not use useless imperative constructions such as "Please choose...",
"Enter...". The interface will make it obvious that the user needs to
choose or enter something.
@@ -214,6 +272,8 @@ Ref: devref 6.5.4.2
Tag: using-first-person-in-templates
Type: warning
+Severity: normal
+Certainty: possible
Info: You should avoid the use of first person ("I will do this..." or
"We recommend..."). The computer is not a person and the Debconf
templates do not speak for the Debian developers. You should use neutral
@@ -225,6 +285,8 @@ Ref: devref 6.5.2.5
Tag: making-assumptions-about-interfaces-in-templates
Type: warning
+Severity: normal
+Certainty: possible
Info: Template text should not make reference to widgets belonging to
some debconf interfaces. Sentences like "If you answer Yes..." have no
meaning for users of graphical interfaces which use checkboxes for
@@ -233,6 +295,8 @@ Ref: devref 6.5.2.4
Tag: too-long-short-description-in-templates
Type: warning
+Severity: normal
+Certainty: certain
Info: The short description should be kept short (50 characters or so) so
that it may be accomodated by most debconf interfaces. Keeping it short
also helps translators, as usually translations tend to end up being
@@ -241,6 +305,8 @@ Ref: devref 6.5.3.2
Tag: too-long-extended-description-in-templates
Type: warning
+Severity: normal
+Certainty: certain
Info: Some debconf interfaces cannot deal very well with descriptions of
more than about 20 lines, so try to keep the extended description below
this limit.
@@ -248,6 +314,8 @@ Ref: devref 6.5.3.2
Tag: unknown-debconf-priority
Type: error
+Severity: important
+Certainty: certain
Info: The given maintainer script calls db_input or or db_text with a
first argument that doesn't match one of the known priorities. The
supported priorities are low, medium, high, and critical.
@@ -255,6 +323,8 @@ Ref: debconf-devel(7)
Tag: possible-debconf-note-abuse
Type: warning
+Severity: normal
+Certainty: possible
Info: Debconf notes should be used only for important notes that the
user really should see, since debconf will go to great pains to make
sure the user sees it.
@@ -273,12 +343,16 @@ Ref: policy 3.9.1
Tag: select-with-boolean-choices
Type: warning
+Severity: normal
+Certainty: possible
Info: Select templates with only yes and no choices should use the boolean
type instead.
Ref: debconf-devel(7)
Tag: template-uses-unsplit-choices
Type: warning
+Severity: normal
+Certainty: possible
Experimental: yes
Info: The use of _Choices in templates is deprecated.
An _Choices field must be translated as a single string.
@@ -295,6 +369,8 @@ Ref: po-debconf(7)
Tag: unused-debconf-template
Type: info
+Severity: minor
+Certainty: possible
Info: Templates which are not used by the package should be removed from
the templates file.
.
--
Debian package checker
Reply to: