[groff] 05/05: groff(1): Fix style and markup nits.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 33a8a9d9066be1cf65dd48c2e0992fc79508f04f
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sat May 20 02:14:55 2023 -0500

    groff(1): Fix style and markup nits.
    
    Style:
    * Tighten wording.
    * Use active voice more.
    * Clarify when we're referring to GNU troff rather than a generic one.
    * Migrate terminology away from "intermediate output".
    
    Markup:
    * Adjust dead-tree pagination.
---
 src/roff/groff/groff.1.man | 38 +++++++++++++++++++++-----------------
 1 file changed, 21 insertions(+), 17 deletions(-)

diff --git a/src/roff/groff/groff.1.man b/src/roff/groff/groff.1.man
index 418743eff..c551326e8 100644
--- a/src/roff/groff/groff.1.man
+++ b/src/roff/groff/groff.1.man
@@ -144,12 +144,13 @@ All three approaches can be combined.
 .
 If no
 .I file
-operands are given on the command line,
+operands are specified,
 or if
 .I file
 is
 .RB \[lq] \- \[rq],
-the standard input stream is read.
+.I groff
+reads the standard input stream.
 .
 .
 .P
@@ -215,8 +216,9 @@ options can be given to
 .SS "\f[I]groff\f[]-specific options"
 .\" ====================================================================
 .
-The following options either do not exist for
-.I @g@troff
+The following options either do not exist in
+GNU
+.I troff \" GNU
 or are interpreted differently by
 .IR groff .
 .
@@ -486,14 +488,14 @@ to the formatter and any pre- or postprocessors invoked.
 .
 .TP
 .B \-V
-Output the pipeline that would be run by
+Output the pipeline that
 .I groff
-(as a wrapper program)
-to the standard output stream,
+would run to the standard output stream,
 but do not execute it.
 .
 If given more than once,
-the pipeline is both written to the standard error stream and run.
+.I groff
+both writes and runs the pipeline.
 .
 .
 .TP
@@ -786,6 +788,7 @@ $ \c
 .B .nr a 1
 .B \[rs]# Do integer arithmetic with operators evaluated left-to-right.
 .B .nr b \[rs]n[a]+5/2
+.ne 2v
 .B \[rs]# Let\[aq]s get the result on the standard error stream.
 .B .tm \[rs]n[b]
 3
@@ -918,9 +921,9 @@ required of users of traditional
 .MR roff @MAN7EXT@
 systems can be avoided.
 .
-The
+Use the
 .MR grog @MAN1EXT@
-program can be used to infer an appropriate
+program to infer an appropriate
 .I groff
 command line to format a document.
 .
@@ -1315,10 +1318,11 @@ described in the next subsection.
 .
 .
 .P
-The formatter generates device-independent,
+GNU
+.I troff \" GNU
+generates output in a device-independent,
 but not device-agnostic,
-.I intermediate output
-in a page description language whose syntax is detailed in
+page description language detailed in
 .MR groff_out @MAN5EXT@ .
 .
 .
@@ -1444,12 +1448,12 @@ and a
 .\" ====================================================================
 .
 Any program that interprets the output of
-.I @g@troff
-is a GNU
-.I roff
+GNU
+.I troff \" GNU
+is a
 postprocessor.
 .
-All of the postprocessors provided by GNU
+The postprocessors provided by GNU
 .I roff
 are
 .IR "output drivers" ,