[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[groff] 14/23: groff_mm(7) <AL, ML, HM>: Reduce redundancy.
From: |
G. Branden Robinson |
Subject: |
[groff] 14/23: groff_mm(7) <AL, ML, HM>: Reduce redundancy. |
Date: |
Sat, 30 Jul 2022 14:53:45 -0400 (EDT) |
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
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [groff] 14/23: groff_mm(7) <AL, ML, HM>: Reduce redundancy.,
G. Branden Robinson <=