[groff] 14/18: troff(1): Fix style nits.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 203f8603fc722a7b2176cc64c1dc0e65332ed816
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Thu Apr 7 14:20:34 2022 +1000

    troff(1): Fix style nits.
    
    * Reduce bulleted list indentation.
    * Be crystal clear about restrictions on -d and -r arguments.
    * Clarify that page ranges given to the -o option are inclusive.
    * Clarify that "-w all" is a perfectly cromulent choice for _documents_
      written for AT&T troff--not just macro packages.
    * Tighten wording.
---
 src/roff/troff/troff.1.man | 28 +++++++++++++++++-----------
 1 file changed, 17 insertions(+), 11 deletions(-)

diff --git a/src/roff/troff/troff.1.man b/src/roff/troff/troff.1.man
index 93e8ed06..98d55841 100644
--- a/src/roff/troff/troff.1.man
+++ b/src/roff/troff/troff.1.man
@@ -122,7 +122,7 @@ This option produces a sort of abstract preview of the 
formatted output.
 .
 .
 .RS
-.IP \[bu]
+.IP \[bu] 2n
 Page breaks are marked by a phrase in angle brackets;
 for example,
 \[lq]<beginning of page>\[rq].
@@ -209,9 +209,13 @@ Due to
 .MR getopt_long 3
 limitations,
 .IR c\~ cannot
-be and
+be,
+and
+.I s
+and
 .I name
-cannot contain an equals sign,
+cannot contain,
+an equals sign,
 even though that is a valid character in a
 .I roff
 identifier.
@@ -302,9 +306,7 @@ Process
 .RI name .tmac
 before input files.
 .
-If
-.RI name .tmac
-is not found,
+If not found,
 .IR tmac. name
 is attempted.
 .
@@ -339,7 +341,7 @@ Number the first page
 .BI \-o\~ list
 Output only pages in
 .IR list ,
-which is a comma-separated list of page ranges;
+which is a comma-separated list of inclusive page ranges;
 .I n
 means print page
 .IR n ,
@@ -383,9 +385,13 @@ Due to
 .MR getopt_long 3
 limitations,
 .IR c\~ cannot
-be and
+be,
+and
+.I n
+and
 .I reg
-cannot contain an equals sign,
+cannot contain,
+an equals sign,
 even though that is a valid character in a
 .I roff
 identifier.
@@ -441,7 +447,7 @@ Enable
 .RB ( \-w )
 or inhibit
 .RB ( \-W )
-emission of warnings in category
+warnings in category
 .IR name .
 .
 See section \[lq]Warnings\[rq] below.
@@ -709,7 +715,7 @@ and
 .BR reg .
 .
 This shorthand is intended to produce all warnings that are useful with
-macro packages written for AT&T
+macro packages and documents written for AT&T
 .I troff \" AT&T
 and its descendants,
 which have less fastidious diagnostics than GNU