[groff] 09/14: groff_mm(7): Recast descriptions of 1C/2C/MC/NCOL.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 23bc215556e1a14fdcaf57ca4b564ee8a4f83f7b
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Wed Jan 18 12:38:01 2023 -0600

    groff_mm(7): Recast descriptions of 1C/2C/MC/NCOL.
---
 contrib/mm/groff_mm.7.man | 77 +++++++++++++++++++++++++++--------------------
 1 file changed, 44 insertions(+), 33 deletions(-)

diff --git a/contrib/mm/groff_mm.7.man b/contrib/mm/groff_mm.7.man
index 8c5c4df76..d25613444 100644
--- a/contrib/mm/groff_mm.7.man
+++ b/contrib/mm/groff_mm.7.man
@@ -492,25 +492,32 @@ to enable customized tables of contents.
 .
 .
 .TP
-.BR 1C\  [ 1 ]
-Begin one-column processing.
+.BR 1C\~ [ 1 ]
+Begin one-column formatting after breaking the page.
 .
-A\~\c
-.B 1
-as an argument disables the page break.
+.RB A\~ 1
+argument suppresses the page break,
+but if a footnote is pending,
+it may be overprinted.
+.
+See
+.BR 2C ,
+.BR MC ,
+and
+.BR NCOL .
 .
-Use wide footnotes, small footnotes may be overprinted.
 .
 .TP
 .B 2C
-Begin two-column processing.
-.
-Splits the page in two columns.
+Begin two-column formatting.
 .
-It is a special case of
+This is a special case of
 .BR MC .
-See also
-.BR 1C .
+.
+See
+.B 1C
+and
+.BR NCOL .
 .
 .
 .TP
@@ -2457,28 +2464,30 @@ T}
 .
 .
 .TP
-.BI MC\  "column-size \fR[\fPcolumn-separation\fR]\fP"
-Begin multiple columns.
+.BI MC\~ column-width\~\c
+.RI [ gutter-width ]
+Begin multi-column layout.
 .
-Return to normal with
-.BR 1C .
+.I groff mm
+creates as many columns of
+.I column-width
+as the line length will permit.
 .
-.B MC
-creates as many columns as the current line length permits.
+.I gutter-width
+is the interior spacing between columns.
 .
-.I column-size
-is the width of each column,
-and
-.I column-separation
-is the space between two columns.
+It defaults to
+.IR column-width /15.
 .
-Default separation is
-.IR column-size /15.
+.B 1C
+returns to single-column layout.
 .
+.B MC
+is a GNU extension.
 .
-This is a GNU extension;
-see also
-.BR 1C .
+See
+.B MULB
+for an alternative.
 .
 .
 .TP
@@ -2596,12 +2605,14 @@ End alternative multi-column mode and emit the columns.
 .
 .TP
 .B NCOL
-Force printing to the next column.
+Move to the start of the next column
+(only when using
+.B 2C
+or
+.BR MC ).
 .
-Don't use this together with the
-.B MUL*
-macros, see
-.BR 2C .
+Contrast with
+.BR MULN .
 .
 .
 .TP