lintian: r220 - branches/1.23.0/checks
Author: jeroen
Date: 2004-04-25 15:22:42 +0200 (Sun, 25 Apr 2004)
New Revision: 220
Modified:
branches/1.23.0/checks/manpages
branches/1.23.0/checks/manpages.desc
Log:
Demote that hyphen-thing to info: apparantly, a lot of them are caused by
conversion tools, and also, a lot of them are in upstream, and it would be not
really easily accepted debian maintainers should fix up their upstreams
manpage over this... This is the type of test that really should fall in the
--pedantic category of lintian tests
Was discussed with Colin Watson.
Modified: branches/1.23.0/checks/manpages
===================================================================
--- branches/1.23.0/checks/manpages 2004-04-24 18:57:42 UTC (rev 219)
+++ branches/1.23.0/checks/manpages 2004-04-25 13:22:42 UTC (rev 220)
@@ -247,7 +247,7 @@
if ($line =~ /^[^\.].*[^\w\\]--?\w+/o) {
# hyphen at the begin of a word, probably not!
$hc++;
- print "W: $pkg $type: hyphen-used-as-minus-sign $file:$lc\n" if $hc <= 10 or $ENV{'LINTIAN_DEBUG'};
+ print "I: $pkg $type: hyphen-used-as-minus-sign $file:$lc\n" if $hc <= 10 or $ENV{'LINTIAN_DEBUG'};
}
if (($line =~ m,(/usr/(dict|doc|etc|info|man|adm|preserve)/),o)
|| ($line =~ m,(/var/(adm|catman|named|nis|preserve)/),o)) {
@@ -256,7 +256,7 @@
print "I: $pkg $type: FSSTND-dir-in-manual-page $file:$lc $1\n";
}
}
- print "W: $pkg $type: hyphen-used-as-minus-sign $file ".($hc-10)." more occurences not shown\n" if $hc > 10 and ! $ENV{'LINTIAN_DEBUG'};
+ print "I: $pkg $type: hyphen-used-as-minus-sign $file ".($hc-10)." more occurences not shown\n" if $hc > 10 and ! $ENV{'LINTIAN_DEBUG'};
}
}
close(IN);
Modified: branches/1.23.0/checks/manpages.desc
===================================================================
--- branches/1.23.0/checks/manpages.desc 2004-04-24 18:57:42 UTC (rev 219)
+++ branches/1.23.0/checks/manpages.desc 2004-04-25 13:22:42 UTC (rev 220)
@@ -143,7 +143,7 @@
renaming the file but not adjusting the content).
Tag: hyphen-used-as-minus-sign
-Type: warning
+Type: info
Info: Manual page seems to contain a hyphen where a minus sign was intended.
'-' chars are interpreted as hyphens (U+2010) by groff, not as minus signs
(U+002D). Since options to programs use minus signs (U+002D), this means for
@@ -155,6 +155,11 @@
especially groff_char(7) for details, and also the thread starting with
http://lists.debian.org/debian-devel/2003/debian-devel-200303/msg01481.html
.
+ If you use some tool that converts your documentation to groff format, it
+ might be possible that this tool converts dashes of any kind to groff
+ hyphens, while the safe way of converting dashes is usually to convert them
+ to '\-'.
+ .
Because this error can occur <em>very</em> often we show only the
first 10 occurences for each man page and give the number of
suppressed occurences. If you want to see all warnings, run
Reply to: