Peter Pentchev <[EMAIL PROTECTED]> 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 ([EMAIL PROTECTED])               <http://www.eyrie.org/~eagle/>


-- 
To UNSUBSCRIBE, email to [EMAIL PROTECTED]
with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]

Reply via email to