[Groff] [PATCH] Expand portable escape section of groff_man(7).

[G. Branden Robinson]

Proposed patch:

commit 3c2bea2fa7f3450ac5d65e5365b5f3224e51d74a
Author: G. Branden Robinson <address@hidden>
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