[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[groff] 06/34: groff_mm(7): Fix style nits.
From: |
G. Branden Robinson |
Subject: |
[groff] 06/34: groff_mm(7): Fix style nits. |
Date: |
Thu, 2 Sep 2021 02:48:30 -0400 (EDT) |
gbranden pushed a commit to branch master
in repository groff.
commit 9ce6e638fab4a0e8899ecc2027a78f5890349230
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Mon Aug 23 19:37:53 2021 +1000
groff_mm(7): Fix style nits.
* Tighten descriptions of .MULB/.MULN/.MULE requests.
* Clarify description of `let@sg_*` macros.
* Favor font style alternation macros and \c over \f escape sequences.
---
contrib/mm/groff_mm.7.man | 68 ++++++++++++++++++++++++-----------------------
1 file changed, 35 insertions(+), 33 deletions(-)
diff --git a/contrib/mm/groff_mm.7.man b/contrib/mm/groff_mm.7.man
index ef2e8ec..d8935d3 100644
--- a/contrib/mm/groff_mm.7.man
+++ b/contrib/mm/groff_mm.7.man
@@ -844,16 +844,18 @@ T}
tab(@);
l lx.
0@T{
-Displays are printed at the end of each section (when section-page
-numbering is active) or at the end of the document.
+Displays are printed at the end of each section
+(when section-page numbering is active)
+or at the end of the document.
T}
1@T{
A new display is printed on the current page if there is enough space,
otherwise it is printed at the end of the document.
T}
2@T{
-One display is printed at the top of each page or column
-(in multi-column mode).
+One display is printed at the top of each page
+(or column,
+in multi-column mode).
T}
3@T{
Print one display if there is enough space for it,
@@ -861,6 +863,7 @@ otherwise it is printed at the top of the next page or
column.
T}
4@T{
Print as many displays as possible in a new page or column.
+.
A page break occurs between each display if
.B De
is not zero.
@@ -868,9 +871,10 @@ T}
5@T{
Fill the current page with displays and the rest beginning at a new page
or column.
+.
(This is the default.)
-A page break occurs between each display
-if \fBDe\fP is not zero.
+.
+A page break occurs between each display if \fBDe\fP is not zero.
T}
.TE
.RE
@@ -2435,38 +2439,30 @@ Use
.B PGFORM
without arguments to return to normal.
.
-.TP
-.BI MULB\ "cw1 space1 \fR[\fPcw2 space2 \fR[\fPcw3 \fR.\|.\|.]]\fP"
-Begin a special multi-column mode.
-.
-All columns widths must be specified.
.
-The space between the columns must be specified also.
+.TP
+.B MULB\~\c
+.IR "cw1 space1\~" [ "cw2 space2" "] .\|.\|.\~" cwn
+Begin alternative multi-column mode.
.
-The last column does not need any space definition.
+All column widths must be specified,
+as must the amount of space between each column pair.
.
-.B MULB
-starts a diversion, and
-.B MULE
-ends the diversion and prints the columns.
+The default unit for the width and space arguments is \[lq]n\[rq].
.
-The unit for the width and space arguments is \[lq]n\[rq],
-but
-.B MULB
-accepts all normal unit specifications like \[lq]c\[rq] and \[lq]i\[rq].
+.B .MULB
+uses a diversion and operates in a separate environment.
.
-.B MULB
-operates in a separate environment.
.
.TP
.B MULN
-Begin the next column.
+Begin next column in alternative column mode.
.
-This is the only way to switch the column.
.
.TP
.B MULE
-End the multi-column mode and print the columns.
+End alternative multi-column mode and emit the columns.
+.
.
.TP
.BI nP\ \fR[\fPtype\fR]\fP
@@ -4231,11 +4227,13 @@ It is supposed to remove the alias
.BR let@header ,
otherwise it is called for all pages.
.
+.
.TP
-.BI let@sg_ "type name title n flag \fR[\fParg1 \fR[\fParg2 \fR[.\|.\|.]]]\fP"
+.BI let@sg_ type\~\c
+.IR "name title n is-surname\~" [ SG-arg\~ .\|.\|.]]
.B .SG
-is calling this macro only for letters;
-memorandums have its own processing.
+calls this macro only for letters;
+memoranda have their own processing.
.
.I name
and
@@ -4244,13 +4242,17 @@ are specified through
.BR .WA / .WB .
.
.IR n \~is
-the counter, 1-max, and
-.I flag
+the index of the
+.IR n th
+author,
+and
+.I is-surname
is true for the last name.
.
-Any other argument to
+Further
.B .SG
-is appended.
+arguments are appended to the signature line.
+.
.
.TP
.BI let@fc_ "type closing"
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [groff] 06/34: groff_mm(7): Fix style nits.,
G. Branden Robinson <=