groff-commit
[Top][All Lists]
Advanced

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

[groff] 01/02: groff(7), groff_diff(7): Fix style nits.


From: G. Branden Robinson
Subject: [groff] 01/02: groff(7), groff_diff(7): Fix style nits.
Date: Sat, 18 Jul 2020 00:21:15 -0400 (EDT)

gbranden pushed a commit to branch master
in repository groff.

commit 6cc33553aba67a23734361439d7f60fc89461876
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sat Jul 18 12:44:54 2020 +1000

    groff(7), groff_diff(7): Fix style nits.
    
    man/groff.7.man:
    man/groff_diff.7.man:
    * Set metasyntactic font called "f" in italics, not bold.
    
    man/groff_diff.7.man:
    * Uncaptialize independent clause after a colon.
    * Break input lines after commas.
    * Quote macro arguments containing interior whitespace and use a regular
      space there rather than a nonbreaking space \~.  (I prefer \~ when it
      leads or trails a macro argument, because it is less likely to be
      mistaken as accidental space among macro arguments or at the end of an
      input line.)
---
 man/groff.7.man      |  2 +-
 man/groff_diff.7.man | 41 ++++++++++++++++++++++++-----------------
 2 files changed, 25 insertions(+), 18 deletions(-)

diff --git a/man/groff.7.man b/man/groff.7.man
index 4077890..3cc14a8 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -2370,7 +2370,7 @@ Remove the font-specific definitions of glyphs
 .IR c1 ,
 .IR c2 ,
 \&.\|.\|.\& for
-.RB font\~ f .
+.RI font\~ f .
 .
 .TPx
 .REQ .rj "n"
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index cd01ecc..b93f041 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -972,9 +972,9 @@ Similar to
 .BR .am ,
 but compatibility mode is switched off during execution.
 .
-To be more precise, a \[oq]compatibility save\[cq] token is inserted
-at the beginning of the macro addition, and a \[oq]compatibility
-restore\[cq] token at the end.
+To be more precise,
+a \[lq]compatibility save\[rq] token is inserted at the beginning,
+and a \[lq]compatibility restore\[rq] token at the end.
 .
 As a consequence, the requests
 .BR am ,
@@ -1002,15 +1002,16 @@ Same as the
 .B ami
 request but compatibility mode is switched off during execution.
 .
+.
 .TP
 .BI .as1\~ xx\~yy
 Similar to
 .BR .as ,
 but compatibility mode is switched off during expansion.
 .
-To be more precise, a \[oq]compatibility save\[cq] token is inserted
-at the beginning of the string, and a \[oq]compatibility restore\[cq]
-token at the end.
+To be more precise,
+a \[lq]compatibility save\[rq] token is inserted at the beginning,
+and a \[lq]compatibility restore\[rq] token at the end.
 .
 As a consequence, the requests
 .BR as ,
@@ -1024,6 +1025,7 @@ only affect the (sub)strings defined by
 and
 .BR ds1 .
 .
+.
 .TP
 .BI .asciify\~ xx
 This request \[oq]unformats\[cq] the diversion
@@ -1772,9 +1774,10 @@ Similar to
 .BR .ds ,
 but compatibility mode is switched off during expansion.
 .
-To be more precise, a \[oq]compatibility save\[cq] token is inserted
-at the beginning of the string, and a \[oq]compatibility restore\[cq]
-token at the end.
+To be more precise,
+a \[lq]compatibility save\[rq] token is inserted at the beginning,
+and a \[lq]compatibility restore\[rq] token at the end.
+.
 .
 .TP
 .B .ecs
@@ -2584,7 +2587,7 @@ Remove the font-specific definitions of glyphs
 .IR c1 ,
 .IR c2 ,
 \*[ellipsis] for
-.RB font\~ f .
+.RI font\~ f .
 .
 Whitespace is optional between
 .IR cn \~arguments.
@@ -3182,24 +3185,28 @@ are immediately copied through to the output regardless 
of whether there
 is a current diversion;
 this behavior is so anomalous that it must be considered a bug.
 .
+.
 .TP
-.BI .de\~ xx\~yy
+.BI .de\~ "xx yy"
 .TQ
-.BI .am\~ xx\~yy
+.BI .am\~ "xx yy"
 .TQ
-.BI .ds\~ xx\~yy
+.BI .ds\~ "xx yy"
 .TQ
-.BI .as\~ xx\~yy
-In compatibility mode, these requests behaves similar to
+.BI .as\~ "xx yy"
+In compatibility mode,
+these requests behave similarly to
 .BR .de1 ,
 .BR .am1 ,
 .BR .ds1 ,
 and
 .BR .as1 ,
-respectively: A \[oq]compatibility save\[cq] token is inserted at the
-beginning, and a \[oq]compatibility restore\[cq] token at the end,
+respectively:
+a \[lq]compatibility save\[rq] token is inserted at the beginning,
+and a \[lq]compatibility restore\[rq] token at the end,
 with compatibility mode switched on during execution.
 .
+.
 .TP
 .BI .ev\~ xx
 If



reply via email to

[Prev in Thread] Current Thread [Next in Thread]