--- Begin Message ---
- To: Debian Bug Tracking System <submit@bugs.debian.org>
- Subject: lintian: quote command to reproduce man page format errors
- From: "James R. Van Zandt" <jrv@debian.org>
- Date: Tue, 29 Jul 2008 19:55:36 -0400
- Message-id: <20080729235536.3373.88080.reportbug@vanzandt.comcast.net>
Package: lintian
Version: 1.24.2
Severity: normal
Lintian gave me this warning:
W: emacspeak: manpage-has-errors-from-man usr/share/man/man1/emacspeak.1.gz 1: warning: `.' not defined
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
N: a string argument to .IP. These are likely to result in lost or
N: malformed output. See the groff_man (or groff_mdoc if using mdoc) man
N: page for 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
N: of a line when they are intended as literal text rather than groff
N: commands. This can be fixed either by reformatting the paragraph so
N: that 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,
N: see "Debugging" in the groff manual.
N:
I couldn't reproduce the warning with man, making it difficult to fix
the bug. Eventually I resorted to scanning a 6MB strace log of the
lintian run, and found an nroff command that would reproduce the
error. That nroff command should appear in the lintian extended help
for this error:
nroff -mandoc -wmac -Tascii foo.1.gz
- Jim Van Zandt
-- System Information:
Debian Release: lenny/sid
APT prefers unstable
APT policy: (990, 'unstable'), (500, 'oldstable'), (500, 'testing'), (500, 'stable')
Architecture: i386 (i686)
Kernel: Linux 2.6.25 (SMP w/4 CPU cores; PREEMPT)
Locale: LANG=C, LC_CTYPE=C (charmap=ANSI_X3.4-1968)
Shell: /bin/sh linked to /bin/bash
Versions of packages lintian depends on:
ii binutils 2.18.1~cvs20080103-7 The GNU assembler, linker and bina
ii diffstat 1.45-2 produces graph of changes introduc
ii dpkg-dev 1.14.20 Debian package development tools
ii file 4.24-4 Determines file type using "magic"
ii gettext 0.17-3 GNU Internationalization utilities
ii intltool-debian 0.35.0+20060710.1 Help i18n of RFC822 compliant conf
ii libparse-debianchan 1.1.1-2 parse Debian changelogs and output
ii libtimedate-perl 1.1600-9 Time and date functions for Perl
ii liburi-perl 1.35.dfsg.1-1 Manipulates and accesses URI strin
ii man-db 2.5.2-2 on-line manual pager
ii perl [libdigest-sha 5.10.0-11 Larry Wall's Practical Extraction
lintian recommends no packages.
-- no debconf information
--- End Message ---
--- Begin Message ---
Source: lintian
Source-Version: 1.24.3
We believe that the bug you reported is fixed in the latest version of
lintian, which is due to be installed in the Debian FTP archive:
lintian_1.24.3.dsc
to pool/main/l/lintian/lintian_1.24.3.dsc
lintian_1.24.3.tar.gz
to pool/main/l/lintian/lintian_1.24.3.tar.gz
lintian_1.24.3_all.deb
to pool/main/l/lintian/lintian_1.24.3_all.deb
A summary of the changes between this version and the previous one is
attached.
Thank you for reporting the bug, which will now be closed. If you
have further comments please address them to 492930@bugs.debian.org,
and the maintainer will reopen the bug report if appropriate.
Debian distribution maintenance software
pp.
Frank Lichtenheld <djpig@debian.org> (supplier of updated lintian package)
(This message was generated automatically at their request; if you
believe that there is a problem with it please contact the archive
administrators by mailing ftpmaster@debian.org)
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1
Format: 1.8
Date: Sat, 09 Aug 2008 00:35:13 -0300
Source: lintian
Binary: lintian
Architecture: source all
Version: 1.24.3
Distribution: unstable
Urgency: low
Maintainer: Debian Lintian Maintainers <lintian-maint@debian.org>
Changed-By: Frank Lichtenheld <djpig@debian.org>
Description:
lintian - Debian package checker
Closes: 376184 491135 491252 491296 491302 491365 491440 491578 491625 491685 492930 493156 493903 493920 493921
Changes:
lintian (1.24.3) unstable; urgency=low
.
The "greetings from Argentina" release.
.
* checks/binaries:
+ [ADB] Use Lintian::Collect throughout rather than reparsing file-info
and objdump-info.
* checks/changelog-file{,.desc}:
+ [ADB] Use Lintian::Collect instead of reading the fields/*, file-info
and objdump-info files.
+ [ADB] Remove a misplaced word from the description of the tag
"debian-changelog-file-contains-invalid-email-address".
* checks/copyright-file{,.desc}:
+ [ADB] Drop the "copyright line too long" check. Most of the issues
it flags aren't easily fixable, particularly where the copyright file
is (semi)automatically generated. (Closes: #491302, #491365, #491685)
+ [ADB] Use Lintian::Collect for accessing control fields and reading the
list of files in the package.
+ [ADB] Don't flag use of version 1 of the GPL, or licenses using phrases
such as "compatible with the GPL" (for example, the W3C Software
License) as missing a reference to common-licenses
+ [ADB] Replace references to the GPL in GFDL and LGPL related tags
with the appropriate license. Also remove a misplaced word.
* checks/cruft:
+ [ADB] Use Lintian::Collect for accessing control fields
* checks/debconf:
+ [ADB] Don't complain about unused debconf templates in udebs.
(Closes: #491135)
+ [RA] Try to recognize at least some debconf template uses in Perl.
+ [ADB] Replace fields/* and scripts access with Lintian::Collect
+ [ADB] Don't flag the shared templates used for dictionaries-common
co-ordination as unused.
+ [FL] Remove debconf-error-requires-versioned-depends since post-lenny
a tag for the sake of sarge-backports clearly makes no sense anymore.
(Closes: #493920)
* checks/description:
+ [RA] Don't warn about a synopsis that ends in "etc." Patch from
Chris Lamb. (Closes: #491252)
+ [ADB] Use Lintain::Collect to read the package's description.
* checks/etcfiles:
+ [ADB] Walk Lintian::Collect->index instead of reading the "index" file.
* checks/fields{,.desc}:
+ [RA] Warn about packages that depend exclusively on makedev.
Thanks, Josh Triplett. (Closes: #491625)
+ [ADB] Use Lintian::Collect::field() to determine the content of fields
from control files rather than reading the fields/* files. This and
similar changes to other scripts should improve performance as the
Collect object caches the lookup result.
+ [ADB] Reformat a couple of tags' descriptions.
* checks/files{,.desc}:
+ [ADB] Switch to using Lintian::Collect.
+ [ADB] Fix a couple of bugs in the parsing of the list of scripts
contained within a package which led to scripts in /usr/share/doc
being incorrectly tagged as executable-in-usr-share-doc.
+ [ADB] Update a couple of Policy references. Thanks Jordà Polo.
+ [ADB] Warn when a package embeds a copy of the Universal Feed Parser.
Patch from Chris Lamb. (Closes: #493156)
+ [FL, ADB] Don't issue tag file-in-unusal-dir for files where we already
issued one of the specific dir-or-file-in-* tags. (Closes: #493921)
+ [ADB] Add a missing "have" to package-contains-ancient-file's
description.
* checks/huge-usr-share:
+ [ADB] Replace (the single) direct access to fields/* with ::field()
+ [ADB] Replace an outdated link to the Developer's Reference.
Thanks Jordà Polo.
* checks/infofiles{,.desc}:
+ [ADB] Use Lintian::Collect to retrieve information about the files
being processed.
+ [ADB] Update the tag "install-info-not-called-with-quiet-option"'s
Policy reference. Thanks Jordà Polo.
* checks/init.d.desc:
+ [ADB] Update a Policy reference. Thanks Jordà Polo.
* checks/lintian.desc:
+ [ADB] Add a Policy reference to bad-section-in-changes-file. Thanks
Jordà Polo.
* checks/manpages{,.desc}:
+ [RA] Suppress warnings about inability to break a line that contains
a URL. URLs often can't be usefully broken. Based on a patch by
Damyan Ivanov. (Closes: #491578)
+ [ADB] Update the Policy reference for manpage-has-wrong-extension.
+ [ADB] Use Lintian::Collect rather than parsing the "index" and
"file-info" files.
+ [FL] In description for manpage-has-errors-from-man note how to
reproduce this errors outside of lintian. (Closes: #492930)
* checks/menu-format{,.desc}:
+ [ADB] Use Lintian::Collect to parse the list of files in the package.
+ [ADB] Don't raise menu-command-not-in-package for 'sensible-browser'
or 'sh'. Thanks Raphael Geissert.
+ [RA] Warn about .kdelnk files and [KDE Desktop Entry] headings in
desktop files. Patch from Raphael Geissert.
* checks/menus{,.desc}:
+ [ADB] Fix a typo; thanks Jordà Polo.
+ [ADB] Use the file list from Lintian::Collect.
* checks/nmu{,.desc}:
+ [ADB] Use Lintian::Collect for maintainer / uploader information
+ [ADB] Add a DevRef reference to changelog-should-mention-nmu. Thanks
Jordà Polo.
* checks/patch-systems:
+ [RA] Combine all patch-system-but-direct-changes-in-diff instances
into a single message to reduce the noise from packages that rebuild
all auto-generated files outside the patch system. Thanks, Julien
Cristau. (Closes: #491296)
+ [ADB] Migrate fields/* reading to use ::Collect::field().
* checks/po-debconf{,.desc}:
+ [ADB] Check that at least one complete translation exists. Thanks Jordà
Polo.
* checks/rules:
+ [ADB] Use ::Collect for field access.
+ [FL] Do not complain about using dh in a unused binary-* target.
* checks/scripts{,.desc}:
+ [RA] Warn about maintainer scripts that prepend a path to commands.
Based on a patch by Raphael Geissert. (Closes: #376184)
+ [ADB] Don't read fields/*, scripts, index or file-info directly as the
contents have almost certainly been cached in Lintian::Collect already.
+ [ADB] Update a couple of Policy references. Thanks Jordà Polo.
* checks/shared-libs.{,desc}:
+ [ADB] Improve the description of no-symbols-control-file.
+ [ADB] Migrate to using ::Collect instead of parsing the index, file-info
and objdump-info files directly.
+ [ADB] Disable ldconfig-symlink-before-shlib-in-deb as it can never be
tested correctly using the information currently available to the
scripts
* checks/watch-file:
+ [FL] Do not issue debian-watch-file-should-mangle-version for
empty watch files.
.
* data/doc-base/sections:
+ [ADB] Resynchronize with doc-base's section list (adding
Programming/OCaml). (Closes: #491440)
.
* debian/postrm:
+ [FL] Do not try to remove /var/spool/lintian if it doesn't exist
(dpkg might already removed it at this point).
.
* doc/desc-files:
+ [ADB] Update the description of tags to include experimental and info
tags.
* doc/README:
+ [ADB] Add -E / --show-experimental, -T / --tags and --tags-from-file
to the option list.
.
* frontend/lintian:
+ [FL, ADB] Add new --tags/-T option to limit the amount of checks
run not by check names but by names of tags you're interested
in. Requested by Joerg Jaspert for ftpmaster. (Closes: #493903)
+ [FL] Add --tags-from-file option to make it easier to specify
a long list of tags.
.
* lib/Lintian/Collect/Binary.pm:
+ [ADB] When parsing objdump-info, indicate whether a shared object is
an Ocaml executable. Also add information on segments which various
checks scripts use which hadn't made it here yet.
+ [ADB] Make index() return a hash rather than an array
+ [ADB] Add support for parsing the "scripts" index file
* lib/Read_taginfo.pm:
+ [FL] Handle URLs in the Ref: field.
* lib/Tags.pm:
+ [ADB] If --tags was used, don't issue tags that aren't in the provided
list.
.
* man/lintian.1
+ [ADB] Update the list of check scripts, removing the no longer present
deb-format and perl and adding the nmu script.
+ [FL] Document the new --tags/-T option.
+ [FL] Document the new --tags-from-file option.
.
* reporting/templates/index.tmpl:
+ [RA] Add a link to lintian.log. Suggested by Stefano Zacchiroli.
.
* t/:
+ [FL] Begin work on a new testsuite.
.
* testset/fields:
+ [ADB] New testset from Tobias Quathamer (including some tags which
previously weren't tested)
* testset/tags.scripts{,.sed}:
+ [ADB] Munge .changes filenames so that the tests produce consistent
output across architectures
Checksums-Sha1:
b8f6a2acca6ac078f5e641b4b3a965ed965906c0 1123 lintian_1.24.3.dsc
41caf7e8d07bd78393dd5ecb7e34201f2089880b 486467 lintian_1.24.3.tar.gz
6dc1b8ae29e0872fe5f5080465eee7c234fe9e81 361460 lintian_1.24.3_all.deb
Checksums-Sha256:
e7a323b903db95d2426517abb4219500f3fd45394e77cfca48687e19f1446099 1123 lintian_1.24.3.dsc
8dad1d4dcc5500685a0a9e610a49ed2e07e91d400b51443cd07363a20e4b76c2 486467 lintian_1.24.3.tar.gz
f22e5fc828980f1ad57f0658499686fe618788e0699d4494f884a47185d46aba 361460 lintian_1.24.3_all.deb
Files:
9821fe44ddf6d391ff0f341e300906b5 1123 devel optional lintian_1.24.3.dsc
bbd146521dc381b5d771f313d7c1c6c2 486467 devel optional lintian_1.24.3.tar.gz
6fc40f5e39a7baace4a2de08bb3347b5 361460 devel optional lintian_1.24.3_all.deb
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.9 (GNU/Linux)
iEYEARECAAYFAkidEvIACgkQQbn06FtxPfA8dgCgve4z1NiGag/DObk9JV5EibR6
ldwAn39FcHI+JvLuoKThloKSo7+K7j0g
=/Svk
-----END PGP SIGNATURE-----
--- End Message ---