[SCM] Debian package checker branch, master, updated. 2.2.18-55-g8d8221a
The following commit has been merged in the master branch:
commit f20d74d9720197c079c5919df1b92db96b8bbfc3
Author: Russ Allbery <rra@debian.org>
Date: Thu Dec 24 15:57:36 2009 -0800
Clarify hyphen-used-as-minus-sign tag description
* checks/manpages.desc:
+ [RA] Clarify the long description of hyphen-used-as-minus-sign.
Note that Debian groff is currently patched to avoid this problem,
but hopefully that divergence can be removed. Reference
groff-base's README.Debian for more information. (Closes: #548844)
diff --git a/checks/manpages.desc b/checks/manpages.desc
index 13f21bd..479949c 100644
--- a/checks/manpages.desc
+++ b/checks/manpages.desc
@@ -223,27 +223,32 @@ Ref: groff_man(7), man(1)
Tag: hyphen-used-as-minus-sign
Severity: wishlist
-Certainty: certain
-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
- example in UTF-8 locales that you cannot cut&paste options, nor search for
- them easily.
+Certainty: possible
+Info: This manual page seems to contain a hyphen where a minus sign was
+ intended. By default, "-" 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 example in UTF-8 locales that you cannot
+ cut and paste options, nor search for them easily. The Debian groff
+ package currently forces "-" to be interpreted as a minus sign due to the
+ number of manual pages with this problem, but this is a Debian-specific
+ modification and hopefully eventually can be removed.
.
- "-" must be escaped ("\-") to be interpreted as minus. If you really intend a
- hyphen, write it as "\(hy" to emphasise that fact. See groff(7) and
- especially groff_char(7) for details, and also the thread starting with
+ "-" must be escaped ("\-") to be interpreted as minus. If you really
+ intend a hyphen (normally you don't), write it as "\(hy" to emphasise
+ that fact. See groff(7) and 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 "\-".
+ If you use some tool that converts your documentation to groff format,
+ this tag may indicate a bug in the tool. Some tools convert dashes of
+ any kind to hyphens. The safe way of converting dashes is to convert
+ them to "\-".
.
- Because this error can occur <em>very</em> often we show only the
- first 10 occurrences for each man page and give the number of
- suppressed occurrences. If you want to see all warnings, run
- lintian with the -d/--debug option.
+ Because this error can occur <em>very</em> often, Lintian shows only the
+ first 10 occurrences for each man page and give the number of suppressed
+ occurrences. If you want to see all warnings, run Lintian with the
+ -d/--debug option.
+Ref: /usr/share/doc/groff-base/README.Debian, groff_char(7)
Tag: FSSTND-dir-in-manual-page
Severity: wishlist
diff --git a/debian/changelog b/debian/changelog
index 67558a6..be54253 100755
--- a/debian/changelog
+++ b/debian/changelog
@@ -34,6 +34,11 @@ lintian (2.3.0) UNRELEASED; urgency=low
(Closes: #557786)
+ [RA] For lib-recommends-documentation, exclude packages ending in
-tools or -bin. Thanks, Jay Berkenbilt. (Closes: #557883)
+ * checks/manpages.desc:
+ + [RA] Clarify the long description of hyphen-used-as-minus-sign.
+ Note that Debian groff is currently patched to avoid this problem,
+ but hopefully that divergence can be removed. Reference
+ groff-base's README.Debian for more information. (Closes: #548844)
* checks/rules{,.desc}:
+ [RA] Remove build-depends-without-arch-dep. If the package only
builds architecture-independent packages, the distinction between
--
Debian package checker
Reply to: