Bug#285540: marked as done (lintian: man page syntax checking with "man -l file")
Your message dated Wed, 03 Aug 2005 06:47:05 -0700
with message-id <E1E0JaL-0000md-00@spohr.debian.org>
and subject line Bug#285540: fixed in lintian 1.23.11
has caused the attached Bug report to be marked as done.
This means that you claim that the problem has been dealt with.
If this is not the case it is now your responsibility to reopen the
Bug report if necessary, and/or fix the problem forthwith.
(NB: If you are a system administrator and have no idea what I am
talking about this indicates a serious mail system misconfiguration
somewhere. Please contact me immediately.)
Debian bug tracking system administrator
(administrator, Debian Bugs database)
--------------------------------------
Received: (at submit) by bugs.debian.org; 13 Dec 2004 22:16:55 +0000
>From user42@zip.com.au Mon Dec 13 14:16:55 2004
Return-path: <user42@zip.com.au>
Received: from mailout1.pacific.net.au [61.8.0.84]
by spohr.debian.org with esmtp (Exim 3.35 1 (Debian))
id 1CdyUw-0004om-00; Mon, 13 Dec 2004 14:16:55 -0800
Received: from mailproxy2.pacific.net.au (mailproxy2.pacific.net.au [61.8.0.87])
by mailout1.pacific.net.au (8.12.3/8.12.3/Debian-7.1) with ESMTP id iBDMGqGx025137
for <submit@bugs.debian.org>; Tue, 14 Dec 2004 09:16:52 +1100
Received: from localhost (ppp2946.dyn.pacific.net.au [61.8.41.70])
by mailproxy2.pacific.net.au (8.12.3/8.12.3/Debian-7.1) with ESMTP id iBDMGo7L018851
for <submit@bugs.debian.org>; Tue, 14 Dec 2004 09:16:50 +1100
Received: from gg by localhost with local (Exim 3.36 #1 (Debian))
id 1CdyUg-0002Vo-00; Tue, 14 Dec 2004 09:16:38 +1100
From: Kevin Ryde <user42@zip.com.au>
To: submit@bugs.debian.org
Subject: lintian: man page syntax checking with "man -l file"
Date: Tue, 14 Dec 2004 09:16:38 +1100
Message-ID: <87k6rlyhbt.fsf@zip.com.au>
User-Agent: Gnus/5.110003 (No Gnus v0.3) Emacs/21.3 (gnu/linux)
MIME-Version: 1.0
Content-Type: multipart/mixed; boundary="=-=-="
Delivered-To: submit@bugs.debian.org
X-Spam-Checker-Version: SpamAssassin 2.60-bugs.debian.org_2004_03_25
(1.212-2003-09-23-exp) on spohr.debian.org
X-Spam-Status: No, hits=-5.3 required=4.0 tests=BAYES_00,FROM_ENDS_IN_NUMS,
HAS_PACKAGE,HTML_MESSAGE autolearn=no
version=2.60-bugs.debian.org_2004_03_25
X-Spam-Level:
--=-=-=
Package: lintian
Version: 1.23.4
Severity: wishlist
Tags: patch
It'd be nice if lintian could check that man pages get through man
successfully. I've noticed a few with typos which would be picked up
with this. Patches below for checks/manpages and manpages.desc.
There's quite a lot of pages with latin1 in them which provoke
warnings. Maybe man should accept them, but for now they result in
missing characters and so I think justify a lintian warning.
Problems with "adjust" and "break" won't lose any output, I think, but
it's annoying to see complaints from man, so it's worth lintian
reporting them. (Some attention to the formatting directives can
probably produce better looking output.)
Without picking on any particular packages, some samples for this
check:
sysvinit 2.86-5 typos in pidof.8 and bootlogd.8
apt 0.5.27 adjust problem in apt_preferences.5
groff 1.18.1.1-4 latin1 in mmroff (resulting in characters missing
from the author's name, in LANG=C at least)
-- System Information:
Debian Release: 3.1
APT prefers unstable
APT policy: (500, 'unstable')
Architecture: i386 (i586)
Kernel: Linux 2.6.8-1-386
Locale: LANG=C, LC_CTYPE=C (charmap=ANSI_X3.4-1968)
Versions of packages lintian depends on:
ii binutils 2.15-5 The GNU assembler, linker and bina
ii diffstat 1.35-1 produces graph of changes introduc
ii file 4.12-1 Determines file type using "magic"
ii gettext 0.14.1-6 GNU Internationalization utilities
ii intltool-debian 0.30+20040213 Help i18n of RFC822 compliant conf
ii man-db 2.4.2-19 The on-line manual pager
ii perl [libdigest-md5-perl] 5.8.4-4 Larry Wall's Practical Extraction
-- no debconf information
--=-=-=
Content-Disposition: attachment; filename=manpages.diff
--- manpages.old 2004-07-05 10:20:56.000000000 +1000
+++ manpages 2004-12-14 09:07:25.000000000 +1100
@@ -232,6 +232,16 @@
tag "manpage-has-bad-whatis-entry", "$file";
}
}
+ # If it's not a .so link, run it through "man" to check for errors.
+ open(MANERRS,"(man -l unpacked/\Q$file\E >/dev/null) 2>&1 |")
+ or fail("cannot run man -l: $!");
+ while (<MANERRS>) {
+ # ignore progress information from man
+ if (/^Reformatting/) { next; }
+ tag "manpage-has-errors-from-man", "$file";
+ last;
+ }
+ close(MANERRS);
# Now we search through the whole man page for some common errors
my $lc = 0;
my $hc = 0;
--=-=-=
Content-Disposition: attachment; filename=manpages.desc.diff
--- manpages.desc.old 2004-10-13 09:48:49.000000000 +1000
+++ manpages.desc 2004-12-14 09:00:34.000000000 +1100
@@ -95,6 +95,28 @@
See also groff_man(7) and groff_mdoc(7) for general information on writing
manual pages.
+Tag: manpage-has-errors-from-man
+Type: warning
+Info: This man page provokes warnings or errors from man, you can see them
+ on stderr with "man -l filename >/dev/null".
+ .
+ "cannot adjust" or "can't break" are trouble with paragraph filling,
+ usually related to long lines. Adjustment can be helped by left
+ justifying, breaks can be helped with hyphenation, see "Manipulating
+ Filling and Adjusting" and "Manipulating Hyphenation" in the manual.
+ .
+ "can't find numbered character" usually means latin1 etc in the input, and
+ this warning indicates characters will be missing from the output. You can
+ change to escapes like \[:a] described on the groff_char man page.
+ .
+ Other warnings are often formatting typos, like missing quotes around a
+ string argument to .IP. These are likely to result in lost or malformed
+ output. See the groff_man (or groff_mdoc if using mdoc) man page for
+ information on macros.
+ .
+ At worst, warning messages can be disabled with the .warn directive, see
+ "Debugging" in the groff manual.
+
Tag: manpage-for-x11-binary-in-wrong-directory
Type: error
Info: Manual pages for binaries which are located in <tt>/usr/X11R6/bin</tt>
--=-=-=--
---------------------------------------
Received: (at 285540-close) by bugs.debian.org; 3 Aug 2005 13:54:33 +0000
>From katie@spohr.debian.org Wed Aug 03 06:54:32 2005
Return-path: <katie@spohr.debian.org>
Received: from katie by spohr.debian.org with local (Exim 3.36 1 (Debian))
id 1E0JaL-0000md-00; Wed, 03 Aug 2005 06:47:05 -0700
From: Frank Lichtenheld <djpig@debian.org>
To: 285540-close@bugs.debian.org
X-Katie: $Revision: 1.56 $
Subject: Bug#285540: fixed in lintian 1.23.11
Message-Id: <E1E0JaL-0000md-00@spohr.debian.org>
Sender: Archive Administrator <katie@spohr.debian.org>
Date: Wed, 03 Aug 2005 06:47:05 -0700
Delivered-To: 285540-close@bugs.debian.org
X-Spam-Checker-Version: SpamAssassin 2.60-bugs.debian.org_2005_01_02
(1.212-2003-09-23-exp) on spohr.debian.org
X-Spam-Level:
X-Spam-Status: No, hits=-6.0 required=4.0 tests=BAYES_00,HAS_BUG_NUMBER
autolearn=no version=2.60-bugs.debian.org_2005_01_02
X-CrossAssassin-Score: 7
Source: lintian
Source-Version: 1.23.11
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.23.11.dsc
to pool/main/l/lintian/lintian_1.23.11.dsc
lintian_1.23.11.tar.gz
to pool/main/l/lintian/lintian_1.23.11.tar.gz
lintian_1.23.11_all.deb
to pool/main/l/lintian/lintian_1.23.11_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 285540@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.7
Date: Mon, 11 Jul 2005 15:50:10 +0300
Source: lintian
Binary: lintian
Architecture: source all
Version: 1.23.11
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: 253498 262749 285152 285540 294409 294661 296233 305575 313118 318110 319212 319370
Changes:
lintian (1.23.11) unstable; urgency=low
.
* frontend/lintian:
+ [FL] Don't use dpkg --print-installation-architecture since
it is deprecated, use dpkg --print-architecture instead.
.
* debian/control:
+ [FL] Depend on libparse-debianchangelog-perl, require
>= 0.6 since prior versions have bugs regarding parse
error handling
.
* checks/binaries:
+ [FL] Check that the package name of a shared library matches
the SONAME as defined in the "Library Packaging guide"
(Closes: #305575, #313118)
* checks/changelog-file{,.desc}:
+ [FL] Use libparse-debianchangelog-perl to parse the changelog,
which detects a lot of syntax errors
+ [FL] Add a new tag debian-changelog-file-missing-or-wrong-name
which is issued if we found no Debian changelog but an upstream
changelog since the further checks will treat the
latter file as the Debian changelog and only issuing
debian-changelog-file-missing would be confusing then
(Closes: #285152)
+ [FL] Detect closes: statements with non-valid bugnumbers,
suggested by martin f. krafft (Closes: #294409)
* checks/common_data.pm:
+ [FL] Fix typo (hurd-386 -> hurd-i386) from last release
that lead to spurious warnings about unknown architectures
(Closes: #318110)
* checks/control-file:
+ [CW] Break control paragraphs at lines containing only whitespace, not
just on zero-length lines. (Closes: #319370)
* checks/fields:
+ [FL] Actually mention which architecture we're complaining about
* checks/manpages:
+ [FL] Report errors from man when parsing man pages. Based on
a patch by Kevin Ryde (Closes: #285540)
* checks/po-debconf:
+ [FL] Abort check if the package doesn't seem to use debconf to
avoid false positives in case maintainers use debian/po for
other Debian specific strings (Closes: #262749)
* checks/scripts:
+ [FL] increase search limit for exec hack by not counting comments
and empty lines (Closes: #294661)
+ [FL] detect more bashisms, suggested by Clint Adams and
martin f krafft (Closes: #253498, #296233 and addresses #253012
partly).
+ [FL] Adjust check for positional arguments after ". file" to detect
more shell control and piping commands that are all allowed.
Noted by Thomas Hood. (Closes: #319212)
.
* reporting/html_reports:
+ [FL] Fix counting of binary package names
+ [FL] Generate mostly valid HTML (id and name attributes still
aren't valid in all cases)
Files:
94c4d4780489e4327fb4838c3786f630 772 devel optional lintian_1.23.11.dsc
ce29fe57c0f530f765bdf625d70eb6bb 262185 devel optional lintian_1.23.11.tar.gz
dd650f0963fb8a88700bc7bf09c6824d 228812 devel optional lintian_1.23.11_all.deb
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.1 (GNU/Linux)
iD8DBQFC8MeUQbn06FtxPfARApccAJ9vZ2LM9BMWGf/oWcs6kPbKstxDcgCfRqRh
VczRKVKtOFYwxESbkgQY3IM=
=INlc
-----END PGP SIGNATURE-----
Reply to: