groff-commit
[Top][All Lists]
Advanced

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

[groff] 05/06: groff(7), groff_diff(7): Fix style nits.


From: G. Branden Robinson
Subject: [groff] 05/06: groff(7), groff_diff(7): Fix style nits.
Date: Sat, 24 Jun 2023 19:49:16 -0400 (EDT)

gbranden pushed a commit to branch master
in repository groff.

commit 3e3b246785f046ac7d5b13571e198eab9daa9345
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sat Jun 24 17:40:40 2023 -0500

    groff(7), groff_diff(7): Fix style nits.
    
    * Say "GNU troff" where distinction from other implementations is
      helpful.
    * Stop using register interpolation notation to refer to registers when
      the notation hasn't been introduced yet.
    * Use active voice more.
    * Use metasyntactic variable that is not identical to the operator
      literal adjacent to it.
    * De-bold example formatter output.
---
 man/groff.7.man      | 12 +++++++-----
 man/groff_diff.7.man | 18 ++++++++++--------
 2 files changed, 17 insertions(+), 13 deletions(-)

diff --git a/man/groff.7.man b/man/groff.7.man
index 566737f21..1aef71b4b 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -332,8 +332,8 @@ or terminal output.
 .SH "Input format"
 .\" ====================================================================
 .
-Input to
-.I @g@troff
+Input to GNU
+.I troff \" GNU
 must be in one of two character encodings it can recognize:
 IBM code page 1047 on EBCDIC systems,
 and ISO\~Latin-1 (8859-1) otherwise.
@@ -862,10 +862,12 @@ can be smaller to avoid problems with integer roundoff.
 .
 The minimum distances that a device can work with in the horizontal and
 vertical directions are termed its
-.I motion quanta,
-.B \[rs]n[.H]
+.I "motion quanta,"
+stored in the
+.B .H
 and
-.B \[rs]n[.V]
+.B .V
+registers,
 respectively.
 .
 Measurements are rounded to applicable motion quanta.
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index f62fa5c83..0d25cb6c0 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -431,8 +431,10 @@ For example,
 .SS "Numeric expressions"
 .\" ====================================================================
 .
-Spaces are permitted in a numeric expression within parentheses,
-and three new operators are available.
+GNU
+.I troff \" GNU
+permits spaces in a numeric expression within parentheses,
+and offers three new operators.
 .
 .
 .TP
@@ -480,12 +482,12 @@ request.
 .
 .
 .TP
-.BI c\~ c
+.BI c\~ chr
 True if a character
-.I c
+.I chr
 is available,
 where
-.I c
+.I chr
 is an ordinary character
 (Unicode basic Latin excluding control characters and the space),
 a special character,
@@ -5378,9 +5380,9 @@ guarantees that the first three output commands it emits 
are as follows.
 .P
 .RS
 .EX
-.BI x\~T\~ device
-.BI x\~res\~ n\~h\~v
-.B x init
+.RI x\~T\~ device
+.RI x\~res\~ n\~h\~v
+x init
 .EE
 .RE
 .



reply via email to

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