[groff] 09/24: groff_man*(7): Fix style nits.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 218e99e2eba7574738697a881e80d2eede4d52c3
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Tue Aug 22 22:44:59 2023 -0500

    groff_man*(7): Fix style nits.
    
    * Migrate terminology: say simply "terminals" and "typesetters".
    * Explain relationship between inset amount and indentation less
      vaguely.
    * Use parentheticals less.
    * Use active voice more.
    * Tune indentation of tagged paragraphs used for option list.
    * Use unbreakable spaces before measurements at ends of sentences.
    * Tighten wording.
    * Retune poor man's keep.
---
 tmac/groff_man.7.man.in | 37 ++++++++++++++++---------------------
 1 file changed, 16 insertions(+), 21 deletions(-)

diff --git a/tmac/groff_man.7.man.in b/tmac/groff_man.7.man.in
index 87f1da30d..011a7ad04 100644
--- a/tmac/groff_man.7.man.in
+++ b/tmac/groff_man.7.man.in
@@ -282,11 +282,10 @@ option).
 details these processes.
 .
 Output is prepared for
-.I terminal
-devices,
+.I terminals
 or for more capable
-.I typesetting
-devices that can change the type size and font family.
+.I typesetters
+that can change the type size and font family.
 .
 .
 .P
@@ -300,11 +299,11 @@ put its name after a dot on a control line.
 .\" You never need to indent macro calls in man(7), or call them with
 .\" the no-break control character.
 .
-We refer to macros in this document using this leading dot.
+This document uses the leading dot to identify macros.
 .
 Some macros interpret
 .I arguments,
-words that follow the macro name.
+words that follow its name.
 .
 A newline,
 unless escaped
@@ -1996,7 +1995,8 @@ _ifstyle()dnl
 .
 .
 .P
-The inset amount and indentation are related but distinct concepts.
+The inset amount and indentation are related but distinct parameters
+with the same defaults.
 .
 The former is manipulated by
 .B .RS
@@ -2153,21 +2153,16 @@ and the deprecated
 .BR .HP .
 .
 The default inter-section and inter-paragraph spacing is
-is 1v for terminals
+is 1v for terminals and 0.4v for typesetters.
 _ifstyle()dnl
-and 0.4v for typesetters
-(\(lqv\(rq is a unit of vertical distance,
-where 1v is the distance between adjacent text baselines in a
-single-spaced document).
-_endif()dnl
-_ifnotstyle()dnl
-and 0.4v for typesetters.
+\(lqv\(rq is a unit of vertical distance,
+where 1v is the distance between adjacent text baselines.
 _endif()dnl
 .
 (The deprecated macro
 .B .PD
 can change this vertical spacing,
-but its use is discouraged.)
+but we discourage its use.)
 .
 Between
 .B .EX
@@ -3388,7 +3383,7 @@ reader preferences,
 man pages should never manipulate them.
 .
 .
-.TP 8n \" "-rcR=1" + 2n
+.TP 9.25n \" "-rHY=0" + 2n + hand-tuned for PDF
 .BI \-dAD= adjustment-mode
 Set line adjustment to
 .I adjustment-mode,
@@ -3416,7 +3411,7 @@ Set the indentation amount for ordinary paragraphs not 
within an
 .BR .RS / .RE
 inset.
 .
-The default is 5n.
+The default is\~5n.
 .
 .
 .TP
@@ -3492,7 +3487,7 @@ the page text is broken before writing the footer.
 .
 Ignored if continuous rendering is enabled.
 .
-The default is \-0.5i.
+The default is\~\-0.5i.
 .
 .
 .TP
@@ -3618,7 +3613,7 @@ See subsection \(lqFont style macros\(rq above for the 
default.
 Set indentation of subsection headings to
 .I subsection-indentation.
 .
-The default is 3n.
+The default is\~3n.
 .
 .
 .TP
@@ -3635,7 +3630,7 @@ The default is\~2n.
 .
 .
 .br
-.ne 4v
+.ne 3v
 .TP
 .B \-rU0
 Disable generation of URI hyperlinks in output drivers capable of them,