[groff] 14/23: groff_mm(7) <AL, ML, HM>: Reduce redundancy.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 51dffa5cc9a201e573f7913323eeee616ce9b61e
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Thu Jul 28 14:38:50 2022 -0500

    groff_mm(7) <AL, ML, HM>: Reduce redundancy.
    
    We already have a "Register format" subsection explaining these, so just
    refer to it.
    
    Also recast.
---
 contrib/mm/groff_mm.7.man | 115 +++++++++++++++++++++++++---------------------
 1 file changed, 62 insertions(+), 53 deletions(-)

diff --git a/contrib/mm/groff_mm.7.man b/contrib/mm/groff_mm.7.man
index 40e1ff34a..626035554 100644
--- a/contrib/mm/groff_mm.7.man
+++ b/contrib/mm/groff_mm.7.man
@@ -405,36 +405,43 @@ Author's firm, should be called before
 see also
 .BR COVER .
 .
+.
 .TP
-.BI AL\  \fR[\fPtype\ \fR[\fPtext-indent\  \fR[\fP1\fR]]]\fP
-Start auto-increment list.
+.BI AL\~ \fR[\fPtype\~\fR[\fPtext-indent\~ \fR[\fP1\fR]]]\fP
+Start an auto-incrementing list.
 .
 Items are numbered beginning with one.
 .
 The
 .I type
-argument controls the format of numbers.
+argument assigns the register format
+(see above)
+of the list item enumerators.
 .
-.RS
-.IP
-.TS
-tab(@);
-lb lb
-l l.
-Arg@Description
-1@Arabic (the default)
-A@Upper-case letters (A\(enZ)
-a@Lower-case letters (a\(enz)
-I@Upper-case roman
-i@Lower-case roman
-.TE
-.RE
+The default
+.RB is\~ 1 .
+.
+An explicitly empty
+.I type
+also indicates the default.
 .
-.IP
 .I text-indent
-sets the indentation and overrides
+sets the indentation and overrides the register
 .BR Li .
-A third argument prohibits printing of a blank line before each item.
+.
+If a third argument,
+conventionally
+.BR 1 ,
+is given,
+the blank line that normally precedes each list item is suppressed.
+.
+Use
+.B LI
+to declare list items,
+and
+.B LE
+to end the list.
+.
 .
 .TP
 .BI APP\  "name text"
@@ -1772,28 +1779,21 @@ Hyphenation can be turned off by setting register
 .B Hy
 to\~0 at the beginning of the file.
 .
+.
 .TP
 .BI HM\  "\fR[\fParg1 \fR[\fParg2 \fR[.\|.\|.\& [\fParg14\fR]]]]\fP"
-Heading mark style.
+Set the heading mark style.
 .
-Controls the type of marking for printing of the heading counters.
+Each argument assigns the specified register format
+(see above)
+to the corresponding heading level.
 .
-Default is\~1 for all levels.
+The default
+.RB is\~ 1
+for all levels.
 .
-.IP
-.B Argument
+An explicitly empty argument also indicates the default.
 .
-.TS
-tab(@);
-l l.
-1@Arabic numerals.
-0001@Arabic numerals with leading zeroes, one or more.
-A@upper-case alphabetic
-a@lower-case alphabetic
-I@upper-case roman numerals
-i@lower-case roman numerals
-\[dq]\[dq]@Arabic numerals.
-.TE
 .
 .TP
 .BI HU\  heading-text
@@ -2205,10 +2205,11 @@ Default value is 99.
 .
 There is no nesting limit.
 .
+.
 .IP
 The indentation can be changed through register
 .BR Li .
-Default is\~6.
+.
 .
 .IP
 All lists begin with a list initialization macro,
@@ -2236,12 +2237,6 @@ l l.
 .TE
 .RE
 .
-.IP
-These lists are described at other places in this manual.
-.
-See also
-.BR LB .
-.
 .
 .TP
 .BI LO\  "type \fR[\fParg\fR]\fP"
@@ -2364,19 +2359,29 @@ Default separation is
 See also
 .BR 1C .
 .
-.TP
-.BI ML\  "mark \fR[\fPtext-indent\ " \fR[\fP1\fR]]\fP
-Marked list start.
 .
-The
+.TP
+.BI ML\~ "mark \fR[\fPtext-indent\~" \fR[\fP1\fR]]\fP
+Start a list with the
 .I mark
-argument is printed before each list item.
+argument preceding each list item.
 .
 .I text-indent
-sets the indent and overrides
+sets the indentation and overrides the register
 .BR Li .
 .
-A third argument prohibits printing of a blank line before each item.
+If a third argument,
+conventionally
+.BR 1 ,
+is given,
+the blank line that normally precedes each list item is suppressed.
+.
+Use
+.B LI
+to declare list items,
+and
+.B LE
+to end the list.
 .
 .
 .TP
@@ -4026,12 +4031,16 @@ List of tables, List of exhibits and List of equations, 
respectively.
 .
 Default values are Lf=1, Lt=1, Lx=1, and Le=0.
 .
+.
 .TP
 .B Li
-List indentation, used by
-.BR .AL .
+is the list item indentation amount used by lists
+.RB ( LB
+and the macros that call it).
+.
+The default
+.BR is\~ 6 .
 .
-Default is\~6.
 .
 .TP
 .B Limsp