Address lintian warnings in the binary packages
Affects | Status | Importance | Assigned to | Milestone | |
---|---|---|---|---|---|
Landscape Client |
Invalid
|
Low
|
Andreas Hasenack |
Bug Description
Got these from a review of the recent quantal upload:
http://
I: landscape-client source: no-complete-
N:
N: Even though this package provides debconf translation support, there are
N: no translations or none of the translations are complete. This may mean
N: that translators weren't properly warned about new strings.
N:
N: Translators may be notified of changes using podebconf-
N: example:
N:
N: podebconf-report-po --call --withtranslators --deadline="+10 days" \
N: --languageteam
N:
N: Refer to Debian Developer's Reference section 6.5.2.2 (Be kind to
N: translators) for details.
N:
N: Severity: wishlist, Certainty: possible
N:
N: Check: po-debconf, Type: source
N:
I: landscape-client source: unused-override start-stop-
N:
N: Lintian discovered an unused override entry in its database. Please
N: remove it from the overrides file if it is not needed anymore.
N:
N: Severity: wishlist, Certainty: certain
N:
I: landscape-client source: unused-override unknown-
W: landscape-
N:
N: The first line of the "Description:" should omit any initial indefinite
N: or definite article: "a", "an", or "the". A good heuristic is that it
N: should be possible to substitute the package name and synopsis into this
N: formula:
N:
N: The package name provides {a,an,the,some} synopsis.
N:
N: Refer to Debian Developer's Reference section 6.2.2 (The package
N: synopsis, or short description) for details.
N:
N: Severity: minor, Certainty: certain
N:
N: Check: description, Type: binary, udeb
N:
I: landscape-
N:
N: The extended description (the lines after the first line of the
N: "Description:" field) is only one or two lines long. The extended
N: description should provide a user with enough information to decide
N: whether they want to install this package, what it contains, and how it
N: compares to similar packages. One or two lines is normally not enough to
N: do this.
N:
N: Refer to Debian Developer's Reference section 6.2.1 (General guidelines
N: for package descriptions) and Debian Developer's Reference section 6.2.3
N: (The long description) for details.
N:
N: Severity: minor, Certainty: possible
N:
N: Check: description, Type: binary, udeb
N:
W: landscape-
N:
N: Each binary in /usr/bin, /usr/sbin, /bin, /sbin or /usr/games should
N: have a manual page
N:
N: Note that though the man program has the capability to check for several
N: program names in the NAMES section, each of these programs should have
N: its own manual page (a symbolic link to the appropriate manual page is
N: sufficient) because other manual page viewers such as xman or tkman
N: don't support this.
N:
N: If the name of the man page differs from the binary by case, man may be
N: able to find it anyway; however, it is still best practice to make the
N: case of the man page match the case of the binary.
N:
N: If the man pages are provided by another package on which this package
N: depends, lintian may not be able to determine that man pages are
N: available. In this case, after confirming that all binaries do have man
N: pages after this package and its dependencies are installed, please add
N: a lintian override.
N:
N: Refer to Debian Policy Manual section 12.1 (Manual pages) for details.
N:
N: Severity: normal, Certainty: possible
N:
N: Check: manpages, Type: binary
N:
I: landscape-
N:
N: This desktop entry uses OnlyShowIn to limit the environments in which
N: it's displayed but lists multiple environments. This is often a sign of
N: a desktop file written assuming that only GNOME, KDE, and Xfce are in
N: use and the desktop file intended to exclude one of them. This
N: unintentionally hides the application from desktop environments such as
N: LXDE where it would work fine. If this application supports any desktop
N: environment except some specific ones, it should list the unsupported
N: environments in the NotShowIn key instead.
N:
N: Severity: normal, Certainty: wild-guess
N:
N: Check: menu-format, Type: binary
N:
W: landscape-
I: landscape-
W: landscape-
W: landscape-
W: landscape-
I: landscape-client: unused-
N:
N: Templates which are not used by the package should be removed from the
N: templates file.
N:
N: This will reduce the size of the templates database and prevent
N: translators from unnecessarily translating the template's text.
N:
N: In some cases, the template is used but Lintian is unable to determine
N: this. Common causes are:
N:
N: - the maintainer scripts embed a variable in the template name in order
N: to allow a template to be selected from a range of similar templates
N: (e.g. db_input low start_$
N:
N: - the template is not used by the maintainer scripts but is used by a
N: program in the package
N:
N: - the maintainer scripts are written in perl. lintian currently only
N: understands the shell script debconf functions.
N:
N: If any of the above apply, please install an override.
N:
N: Severity: minor, Certainty: possible
N:
N: Check: debconf, Type: binary, udeb, source
N:
I: landscape-client: unused-
I: landscape-client: unused-
I: landscape-client: unused-
I: landscape-client: unused-
I: landscape-client: unused-
I: landscape-client: unused-
I: landscape-client: unused-
I: landscape-client: unused-
I: landscape-client: unused-
I: landscape-client: unused-
I: landscape-client: unused-
W: landscape-client: description-
W: landscape-client: manpage-
N:
N: This man page provokes warnings or errors from man.
N:
N: "cannot adjust" or "can't break" are trouble with paragraph filling,
N: usually related to long lines. Adjustment can be helped by left
N: justifying, breaks can be helped with hyphenation, see "Manipulating
N: Filling and Adjusting" and "Manipulating Hyphenation" in the manual.
N:
N: "can't find numbered character" usually means latin1 etc in the input,
N: and this warning indicates characters will be missing from the output.
N: You can change to escapes like \[:a] described on the groff_char man
N: page.
N:
N: Other warnings are often formatting typos, like missing quotes around a
N: string argument to .IP. These are likely to result in lost or malformed
N: output. See the groff_man (or groff_mdoc if using mdoc) man page for
N: information on macros.
N:
N: This test uses man's --warnings option to enable groff warnings that
N: catch common mistakes, such as putting . or ' characters at the start of
N: a line when they are intended as literal text rather than groff
N: commands. This can be fixed either by reformatting the paragraph so that
N: these characters are not at the start of a line, or by adding a
N: zero-width space (\&) immediately before them.
N:
N: At worst, warning messages can be disabled with the .warn directive, see
N: "Debugging" in the groff manual.
N:
N: To test this for yourself you can use the following command:
N: LC_ALL=en_US.UTF-8 MANWIDTH=80 man --warnings -E UTF-8 -l <file> >/dev/null
N:
N: Severity: normal, Certainty: certain
N:
N: Check: manpages, Type: binary
N:
I: landscape-client: hyphen-
N:
N: This manual page seems to contain a hyphen where a minus sign was
N: intended. By default, "-" chars are interpreted as hyphens (U+2010) by
N: groff, not as minus signs (U+002D). Since options to programs use minus
N: signs (U+002D), this means for example in UTF-8 locales that you cannot
N: cut and paste options, nor search for them easily. The Debian groff
N: package currently forces "-" to be interpreted as a minus sign due to
N: the number of manual pages with this problem, but this is a
N: Debian-specific modification and hopefully eventually can be removed.
N:
N: "-" must be escaped ("\-") to be interpreted as minus. If you really
N: intend a hyphen (normally you don't), write it as "\(hy" to emphasise
N: that fact. See groff(7) and especially groff_char(7) for details, and
N: also the thread starting with
N: http://
N: tml
N:
N: If you use some tool that converts your documentation to groff format,
N: this tag may indicate a bug in the tool. Some tools convert dashes of
N: any kind to hyphens. The safe way of converting dashes is to convert
N: them to "\-".
N:
N: Because this error can occur very often, Lintian shows only the first 10
N: occurrences for each man page and give the number of suppressed
N: occurrences. If you want to see all warnings, run Lintian with the
N: -d/--debug option.
N:
N: Refer to /usr/share/
N: manual page for details.
N:
N: Severity: wishlist, Certainty: possible
N:
N: Check: manpages, Type: binary
N:
I: landscape-client: hyphen-
W: landscape-client: manpage-
I: landscape-client: hyphen-
I: landscape-client: hyphen-
I: landscape-client: hyphen-
I: landscape-client: hyphen-
W: landscape-client: binary-
W: landscape-client: binary-
W: landscape-client: binary-
W: landscape-client: binary-
W: landscape-client: binary-
W: landscape-client: binary-
W: landscape-client: binary-
W: landscape-client: binary-
W: landscape-client: start-stop-
N:
N: The maintainer script seems to call start-stop-daemon directly.
N: Long-running daemons should be started and stopped via init scripts
N: using invoke-rc.d rather than directly in maintainer scripts.
N:
N: Refer to Debian Policy Manual section 9.3.3.2 (Running initscripts) for
N: details.
N:
N: Severity: normal, Certainty: certain
N:
N: Check: scripts, Type: binary
N:
I: landscape-common: unused-
W: landscape-common: description-
W: landscape-common: binary-
W: landscape-common: command-
N:
N: The indicated program run in a maintainer script has a prepended path.
N: Programs called from maintainer scripts normally should not have a path
N: prepended. dpkg ensures that the PATH is set to a reasonable value, and
N: prepending a path may prevent the local administrator from using a
N: replacement version of a command for some local reason.
N:
N: Refer to Debian Policy Manual section 6.1 (Introduction to package
N: maintainer scripts) for details.
N:
N: Severity: normal, Certainty: certain
N:
N: Check: scripts, Type: binary
N:
W: landscape-common: command-
W: landscape-common: command-
W: landscape-common: command-
N: 2 tags overridden (2 warnings)
Changed in landscape-client: | |
importance: | Undecided → Wishlist |
Command to see those: lintian -iI *.dsc *.deb