Bug#643735: lintian: Add check for manual page to verify TH matches FILENAME.N
Package: lintian
Version: 2.5.3
Severity: wishlist
An example. Binary name /usr/bin/xsnap-ocr and manpage in
.../man1/xsnap-ocr.1 reads:
! 64 .IX Title "xsnap_ocr 1"
! 65 .TH xsnap_ocr 1 "2011-09-29" "xsnap-ocr" "User Commands"
66 .\" For nroff, turn off justification. Always turn off hyphenation; it makes
67 .\" way too many mistakes in technical documents.
68 .if n .ad l
69 .nh
70 .SH "NAME"
! 71 xsnap_ocr \- OCR reader helper called by xsnap
72 .SH "SYNOPSIS"
SUGGESTION
It would be nice if there were a P: or X: check to verify that
basename of manual page's filename (without suffix) matches the marked
(!) lines.
The above should have read:
! 64 .IX Title "xsnap-ocr 1"
! 65 .TH xsnap-ocr 1 "2011-09-29" "xsnap-ocr" "User Commands"
...
! 71 xsnap-ocr \- OCR reader helper called by xsnap
-- System Information:
Debian Release: wheezy/sid
APT prefers testing
APT policy: (990, 'testing'), (500, 'unstable'), (1, 'experimental')
Architecture: amd64 (x86_64)
Kernel: Linux 3.0.0-1-amd64 (SMP w/2 CPU cores)
Locale: LANG=en_DK.UTF-8, LC_CTYPE=en_DK.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash
Versions of packages lintian depends on:
ii binutils 2.21.52.20110606-2
ii bzip2 1.0.5-7
ii diffstat 1.54-1
ii file 5.08-1
ii gettext 0.18.1.1-4
ii intltool-debian 0.35.0+20060710.1
ii libapt-pkg-perl 0.1.24+b2
ii libclass-accessor-perl 0.34-1
ii libdpkg-perl 1.16.1
ii libemail-valid-perl 0.185-1
ii libipc-run-perl 0.90-1
ii libparse-debianchangelog-perl 1.2.0-1
ii libtimedate-perl 1.2000-1
ii liburi-perl 1.59-1
ii locales 2.13-21
ii man-db 2.6.0.2-2
ii patchutils 0.3.2-1
ii perl [libdigest-sha-perl] 5.12.4-4
ii unzip 6.0-5
lintian recommends no packages.
Versions of packages lintian suggests:
ii binutils-multiarch <none>
ii dpkg-dev 1.16.1
ii libhtml-parser-perl 3.68-1+b1
ii libtext-template-perl 1.45-2
ii man-db 2.6.0.2-2
ii xz-utils 5.1.1alpha+20110809-2
-- debconf-show failed
Reply to: