Proposed patch: commit 3c2bea2fa7f3450ac5d65e5365b5f3224e51d74a Author: G. Branden Robinson <[email protected]> Date: Mon Sep 4 14:12:48 2017 -0400
Expand portable escape section of groff_man(7).
Make some additional minor wording changes.
* Fix misspelling of English singular "apostrophe" as "apostroph" [sic].
* Hyphenate phrasal adjectives where idiomatic.
* Recast "one single word" (redundant) as "a single word".
* Stop referring to troff-to-HTML processors as "increasingly common";
that may have been true 20 years ago but may not be today.
* Characterize troff-to-HTML processors as doing transformation rather
than rendering, to further suggest the lack of precision involved.
* Indent examples with .RS/.IP/.EX/.EE/.RE for consistency with other
examples in this man page, in favor of mixed-level .sp/.EX/.EE/.sp
requests.
* \ :
+ Explain explicit double-quotes in document.
+ Ask for use case in comment.
* Document \~ escape, with example.
* \&:
+ Recast explanation.
+ Provide illustrative example of how things go wrong if you don't
use it.
* Document \[oq] and \[cq] escapes.
* Document \[lq] and \[rq] escapes.
* Add mnemonics for \[dq], \[em], \[en], and \c.
* Add mnemonic for \[rs] (en passant).
* Slightly soften the language about what isn't portable about using
.TP and \c when the rendering system isn't even identified.
Full patch attached.
--
Regards,
Branden
signature.asc
Description: PGP signature
