[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Groff] [PATCH] Expand portable escape section of groff_man(7).
From: |
G. Branden Robinson |
Subject: |
[Groff] [PATCH] Expand portable escape section of groff_man(7). |
Date: |
Mon, 4 Sep 2017 14:34:23 -0400 |
User-agent: |
NeoMutt/20170113 (1.7.2) |
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
- [Groff] [PATCH] Expand portable escape section of groff_man(7).,
G. Branden Robinson <=