Address lintian warnings in the binary packages

Bug #1009707 reported by Andreas Hasenack
6
This bug affects 1 person
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://paste.ubuntu.com/1027450/

I: landscape-client source: no-complete-debconf-translation
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-report-po, for
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-daemon-in-maintainer-script postinst:130
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-field-in-dsc original-maintainer
W: landscape-client-ui-install: description-synopsis-starts-with-article
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-client-ui-install: extended-description-is-probably-too-short
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-client-ui-install: binary-without-manpage usr/bin/landscape-client-ui-install
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-client-ui-install: desktop-entry-limited-to-environments usr/share/applications/landscape-client-settings.desktop
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-client-ui: description-synopsis-starts-with-article
I: landscape-client-ui: extended-description-is-probably-too-short
W: landscape-client-ui: binary-without-manpage usr/bin/landscape-client-registration-mechanism
W: landscape-client-ui: binary-without-manpage usr/bin/landscape-client-settings-mechanism
W: landscape-client-ui: binary-without-manpage usr/bin/landscape-client-settings-ui
I: landscape-client: unused-debconf-template landscape-client/computer_title
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_$service_at_boot)
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-debconf-template landscape-client/account_name
I: landscape-client: unused-debconf-template landscape-client/registration_password
I: landscape-client: unused-debconf-template landscape-client/url
I: landscape-client: unused-debconf-template landscape-client/exchange_interval
I: landscape-client: unused-debconf-template landscape-client/urgent_exchange_interval
I: landscape-client: unused-debconf-template landscape-client/ping_url
I: landscape-client: unused-debconf-template landscape-client/ping_interval
I: landscape-client: unused-debconf-template landscape-client/http_proxy
I: landscape-client: unused-debconf-template landscape-client/https_proxy
I: landscape-client: unused-debconf-template landscape-client/tags
I: landscape-client: unused-debconf-template landscape-client/register_system
W: landscape-client: description-synopsis-starts-with-article
W: landscape-client: manpage-has-errors-from-man usr/share/man/man1/landscape-client.1.gz 40: warning: macro `system'.' not defined (possibly missing space after `sy')
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-used-as-minus-sign usr/share/man/man1/landscape-client.1.gz:94
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://lists.debian.org/debian-devel/2003/debian-devel-200303/msg01481.h
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/doc/groff-base/README.Debian and the groff_char(7)
N: manual page for details.
N:
N: Severity: wishlist, Certainty: possible
N:
N: Check: manpages, Type: binary
N:
I: landscape-client: hyphen-used-as-minus-sign usr/share/man/man1/landscape-client.1.gz:103
W: landscape-client: manpage-has-errors-from-man usr/share/man/man1/landscape-config.1.gz 46: warning: macro `/etc/landscape/client.conf').' not defined
I: landscape-client: hyphen-used-as-minus-sign usr/share/man/man1/landscape-config.1.gz:217
I: landscape-client: hyphen-used-as-minus-sign usr/share/man/man1/landscape-config.1.gz:226
I: landscape-client: hyphen-used-as-minus-sign usr/share/man/man1/landscape-config.1.gz:234
I: landscape-client: hyphen-used-as-minus-sign usr/share/man/man1/landscape-config.1.gz:243
W: landscape-client: binary-without-manpage usr/bin/landscape-broker
W: landscape-client: binary-without-manpage usr/bin/landscape-dbus-proxy
W: landscape-client: binary-without-manpage usr/bin/landscape-is-cloud-managed
W: landscape-client: binary-without-manpage usr/bin/landscape-manager
W: landscape-client: binary-without-manpage usr/bin/landscape-monitor
W: landscape-client: binary-without-manpage usr/bin/landscape-package-changer
W: landscape-client: binary-without-manpage usr/bin/landscape-package-reporter
W: landscape-client: binary-without-manpage usr/bin/landscape-release-upgrader
W: landscape-client: start-stop-daemon-in-maintainer-script postinst:130
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-debconf-template landscape-common/sysinfo
W: landscape-common: description-synopsis-starts-with-article
W: landscape-common: binary-without-manpage usr/bin/landscape-sysinfo
W: landscape-common: command-with-path-in-maintainer-script prerm:23 /usr/sbin/update-motd
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-with-path-in-maintainer-script postinst:41 /usr/sbin/update-motd
W: landscape-common: command-with-path-in-maintainer-script postinst:44 /usr/sbin/update-motd
W: landscape-common: command-with-path-in-maintainer-script postinst:48 /usr/sbin/update-motd
N: 2 tags overridden (2 warnings)

Tags: squad-qa
Changed in landscape-client:
importance: Undecided → Wishlist
Revision history for this message
Andreas Hasenack (ahasenack) wrote :

Command to see those: lintian -iI *.dsc *.deb

Changed in landscape-client:
importance: Wishlist → Low
visibility: private → public
Changed in landscape-client:
assignee: nobody → Andreas Hasenack (ahasenack)
Revision history for this message
🤖 Landscape Builder (landscape-builder) wrote :

This bug has not seen any activity in the last 6 months, so it is being automatically closed.

If you are still experiencing this issue, please feel free to re-open.

Landscape Team

Changed in landscape-client:
status: New → Invalid
To post a comment you must log in.
This report contains Public information  
Everyone can see this information.

Other bug subscribers

Remote bug watches

Bug watches keep track of this bug in other bug trackers.