gbranden pushed a commit to branch master
in repository groff.
commit 584f2b51795877d9e960bd9ed043874a58ffa581
Author: G. Branden Robinson <[email protected]>
AuthorDate: Thu Jun 27 10:54:15 2024 -0500
groff_mm(7): Fix content and style nits.
Content:
* Drop redundant explanation of `H` and `HU` macros' purpose.
* Inform user of `TAB` macro of `ta` request.
Style:
* Favor active voice over passive.
* Recast for clarity.
* Tighten wording.
* Consistently place register default values at the ends of paragraphs.
* Fix subject/verb agreement.
* (Hps2) Refer to heading levels being "within", not "below" a
"threshold", in hope that this better expresses the closed (vs. open)
nature of the interval.
---
contrib/mm/groff_mm.7.man | 49 ++++++++++++++++++++++++-----------------------
1 file changed, 25 insertions(+), 24 deletions(-)
diff --git a/contrib/mm/groff_mm.7.man b/contrib/mm/groff_mm.7.man
index 8d36cfcfe..06d24e0a6 100644
--- a/contrib/mm/groff_mm.7.man
+++ b/contrib/mm/groff_mm.7.man
@@ -3442,22 +3442,21 @@ assumes
.BR 1 .
.\" DWB 3.3 mm assumed 1 for troff mode, 0 for nroff mode.
.
-Adjustment can be temporarily suspended with the
+Invoke the
.B na
-request.
+request as desired to temporarily suspend adjustment.
.
-When the
.B H
-or
+and
.B HU
-macros are used to format a heading,
-or when
+are called,
+and
.B SA
-is called without a
+when called without a
.I mode
argument,
.I mm
-restores the default adjustment.
+restore the default adjustment.
.
.
.TP
@@ -3605,6 +3604,10 @@ call to overcome this restriction.
.B TAB
Reset tab stops to every 5\~ens.
.
+The
+.B ta
+request customizes them.
+.
.
.br
.ne 4v
@@ -4102,7 +4105,7 @@ These are presented in quotation marks.
.B Apptxt
stores the
.I title
-argument to the last
+argument to the most recent
.B APP
call.
.
@@ -4116,16 +4119,15 @@ interpolates a bullet
.
.TP
.B Ci
-is a list of indentation amounts to use for table of contents heading
-levels,
-overriding their automatic computation.
+assigns indentation amounts used by each heading level listed
+in a table of contents,
+in one-to-one correspondence,
+overriding those computed by
+.BR TC .
.
Each word must be a horizontal measurement
(like
-.RB \[lq] 1i \[rq])
-and is mapped one-to-one to heading levels 1,
-2,
-and so on.
+.RB \[lq] 1i \[rq]).
.
.
.TP
@@ -4325,8 +4327,8 @@ selects the notation format when
.B NS
is given no argument.
.
-The default is
-.RB \[lq] 0 \[rq].
+The default
+.RB is\~ 0 .
.
.
.TP
@@ -4580,8 +4582,7 @@ Headings at levels above this value are excluded;
see
.B H
and
-.B TC
-.RB ( 2 ).
+.BR TC .
.
The
.B Cl
@@ -4596,7 +4597,8 @@ if you change
.BR Cl 's
value immediately prior to calling
.BR TC ,
-you are unlikely to get the result you want.
+you are unlikely to get the result you want
+.RB ( 2 ).
.
.
.TP
@@ -4826,7 +4828,7 @@ and
.B Hb
sets the threshold for breaking the line after formatting a heading.
.
-Text after headings at levels above this value are set on the same
+Text after headings at levels above this value is set on the same
output line if possible;
see
.B H
@@ -4911,8 +4913,7 @@ devices:
.
.TP
.B Hps2
-configures the amount of vertical space preceding a heading at or below
-the
+configures the amount of vertical space preceding a heading within the
.B Hps
threshold;
see
_______________________________________________
Groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
