Re: RFS: nemesis (updated package)
Peter Pentchev <roam@ringlet.net> writes:
> Just for the record, unfortunately, sometimes patching upstream's manual
> pages is the only correct solution. There are cases when the "-"
> character appears in a manual page in both roles - as "a minus sign" and
> as a "real" hyphen. For example, look at my proposed changes to the
> xvkbd package in bug #484490 - these include a patch to the manual page
> that changes "-" to "\-" in *some* cases, but not always; there are uses
> like "UNIX-like" and "upper-case" when the hyphen is indeed a hyphen.
> Thus, an automated "escape all hyphens" is not always a correct
> solution, though it is usually the easiest :)
Usually upstream is fairly happy to take these sorts of patches, though.
> Somewhat off-topic, but, well, that's one of the less important reasons
> why I always write mdoc manual pages :)
POD is a very simple language for writing man pages and takes care of this
for you too. :)
--
Russ Allbery (rra@debian.org) <http://www.eyrie.org/~eagle/>
Reply to: