[groff] 09/35: groff(7): Fix content and style nits.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 6c9ad16e865e1c6214cfe0ad6507e30d1ca79ab0
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Fri Jul 8 18:00:12 2022 -0500

    groff(7): Fix content and style nits.
    
    * Refer to "troff" and "nroff" commands using the configured prefix.
    * Add thousands separator to numeric literal in prose.
    * Recast discussion of underlining to alleviate anguished English.
---
 man/groff.7.man | 79 +++++++++++++++++++++------------------------------------
 1 file changed, 29 insertions(+), 50 deletions(-)

diff --git a/man/groff.7.man b/man/groff.7.man
index 0f844d4c..1206ea41 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -4696,7 +4696,7 @@ results from request calls.
 .TPx
 .REG $$
 The process ID of
-.BR troff .
+.IR @g@troff .
 .
 .TPx
 .REG .$
@@ -4710,11 +4710,11 @@ Post-line extra line-space most recently utilized using
 .TPx
 .REG .A
 Set to\~1 in
-.B troff
+.I @g@troff
 if option
 .option \-A
 is used; always\~1 in
-.BR nroff .
+.IR @g@nroff .
 .
 .TPx
 .REG .b
@@ -5013,7 +5013,7 @@ The current post-vertical line spacing.
 .TPx
 .REG .R
 The count of available unused registers;
-always 10000 in GNU
+always 10,000 in GNU
 .IR troff . \" GNU
 .
 .
@@ -5999,63 +5999,42 @@ copies a named environment's contents to the current 
one.
 .SH Underlining
 .\" ====================================================================
 .
-In the
+In
 .I RUNOFF
-language, the underlining was quite easy.
-.
-But in
-.I roff
-this is much more difficult.
-.
+(see
+.MR roff @MAN7EXT@ ),
+underlining,
+even of lengthy passages,
+was straightforward because only fixed-pitch printing devices were
+targeted.
 .
-.\" ====================================================================
-.SS "Underlining with .ul"
-.\" ====================================================================
+Typesetter output posed a greater challenge.
 .
 There exists a
 .I groff
 request
 .B .ul
-(see above) that can underline the next or further source lines in
-.BR nroff ,
-but in
-.B troff
-it produces only a font change into
-.IR italic .
+(see above)
+that underlines subsequent source lines on terminal devices,
+but on typesetters,
+it selects an italic font style instead.
 .
-So this request is not really useful.
 .
-.
-.\" ====================================================================
-.SS "Underlining with .UL from \f[I]ms\f[]"
-.\" ====================================================================
-.
-In the \[oq]ms\[cq] macro package in tmac/s.tmac
-.MR groff_ms @MAN7EXT@ ,
-there is the macro
-.BR .UL .
-.
-But this works only in
-.BR troff ,
-not in
-.BR nroff .
+The
+.I ms
+macro package
+(see
+.MR groff_ms @MAN7EXT@ )
+offers a macro
+.BR .UL ,
+but it too produces the desired effect only on typesetters,
+and has other limitations.
 .
 .
-.\" ====================================================================
-.SS "Underlining macro definitions"
-.\" ====================================================================
-.
-So one can use the
-.I italic
-.B nroff
-idea from
-.B .ul
-and the
-.B troff
-definition
-in
-.I ms
-for writing a useful new macro, something like
+.P
+One could adapt
+.I ms 's
+approach to the construction of a macro as follows.
 .
 .RS
 .EX