[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

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: