lintian: r221 - branches/1.23.0/checks
Author: jeroen
Date: 2004-04-25 20:35:50 +0200 (Sun, 25 Apr 2004)
New Revision: 221
Modified:
branches/1.23.0/checks/manpages
branches/1.23.0/checks/manpages.desc
Log:
Manpages:
- Demote section-mismatch and bad-whatis-entry to warning
- Fix the references in those descriptions
Modified: branches/1.23.0/checks/manpages
===================================================================
--- branches/1.23.0/checks/manpages 2004-04-25 13:22:42 UTC (rev 220)
+++ branches/1.23.0/checks/manpages 2004-04-25 18:35:50 UTC (rev 221)
@@ -226,7 +226,7 @@
# removed.
if ($path =~ m,/man/man\d/,) {
if (system("lexgrog unpacked/\Q$file\E >/dev/null 2>&1")) {
- print "E: $pkg $type: manpage-has-bad-whatis-entry $file\n";
+ print "W: $pkg $type: manpage-has-bad-whatis-entry $file\n";
}
}
# Now we search through the whole man page for some common errors
@@ -241,7 +241,7 @@
my ($th_command, $th_title, $th_section, $th_date ) =
Text::ParseWords::parse_line( '\s+', 0, $line);
if ($th_section && ($fn_section ne $th_section)) {
- print "E: $pkg $type: manpage-section-mismatch $file:$lc $fn_section != $th_section\n";
+ print "W: $pkg $type: manpage-section-mismatch $file:$lc $fn_section != $th_section\n";
}
}
if ($line =~ /^[^\.].*[^\w\\]--?\w+/o) {
Modified: branches/1.23.0/checks/manpages.desc
===================================================================
--- branches/1.23.0/checks/manpages.desc 2004-04-25 13:22:42 UTC (rev 220)
+++ branches/1.23.0/checks/manpages.desc 2004-04-25 18:35:50 UTC (rev 221)
@@ -84,15 +84,15 @@
Ref: policy 12.1
Tag: manpage-has-bad-whatis-entry
-Type: error
+Type: warning
Info: Each manual page should start with a `NAME' section, which lists the
- name and a brief description of the page. These sections are parsed by
- `mandb' and stored in a database for the use of `apropos' and `whatis', so
- they must be in a certain format. This manual page apparently uses the
- wrong format and cannot be parsed by `mandb'.
+ name and a brief description of the page seperated by '\-'. These sections
+ are parsed by `mandb' and stored in a database for the use of `apropos' and
+ `whatis', so they must be in a certain format. This manual page apparently
+ uses the wrong format and cannot be parsed by `mandb'.
.
- For information on how `NAME' sections should be written and a list of some
- common mistakes, please see the lexgrog(8) manual page.
+ For information on how `NAME' sections should be written see man(7). See also
+ lexgrog(1) for some common mistakes.
Tag: manpage-for-x11-binary-in-wrong-directory
Type: error
@@ -133,14 +133,12 @@
Type: error
Info: The referenced manual page is empty.
-Tag: manpage-section-missmatch
-Type: error
-Info: Most man pages contain a header line (marked .TH) in which
- among other thing their section number is specified. For this
- particular man page the section number in the header line isn't
- equal with the section number specified by the filename. This
- is most probably an error (In most cases caused by someone
- renaming the file but not adjusting the content).
+Tag: manpage-section-mismatch
+Type: warning
+Info: A man page usually should contain a <tt>.TH</tt> header, specifying the
+ section. The section in this manpage doesn't match with the section in the
+ filename. Please consult man(7) for more information about <tt>.TH</tt>
+ syntax (amongst others).
Tag: hyphen-used-as-minus-sign
Type: info
Reply to: