gbranden pushed a commit to branch master
in repository groff.
commit 6cc33553aba67a23734361439d7f60fc89461876
Author: G. Branden Robinson <[email protected]>
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
_______________________________________________
Groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
