[groff] 41/53: doc/meref.me: Revise "Columnated Output" section.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 170ee5261e122f49dd7e8c864d1d31fd6bd949cf
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sat Dec 11 14:22:54 2021 +1100

    doc/meref.me: Revise "Columnated Output" section.
    
    ...under its new title.
---
 doc/meref.me | 63 +++++++++++++++++++++++++++++++-----------------------------
 1 file changed, 33 insertions(+), 30 deletions(-)

diff --git a/doc/meref.me b/doc/meref.me
index fda4dd0..3dd7f9b 100644
--- a/doc/meref.me
+++ b/doc/meref.me
@@ -1093,51 +1093,54 @@ in effect at the time
 .b .xp
 is called,
 not those of the entries when they were collected.
-.sh 1 "Columned Output"
+.sh 1 "Columnated Output"
 .TL
 .b .2c
-.i +S
+.i \(+-S
 .i N
 .DE
-Enter two-column mode.
-The column separation is set to
-.i +S
+Enter multi-column mode,
+formatting text in
+.i N
+[2]
+columns of equal width.
+The column separation
+(\c
+.q gutter )
+is set to
+.i \(+-S
 [4n]
-(saved in
-.NR ($s ).
-The column width,
-calculated to fill the single-column line length
-with both columns,
+and saved
+in
+.NR ($s .
+The
+.i N
+columns with
+.i N \-1
+gutters
+fill the single-column line length;
+each column's line length
 is stored in
 .NR ($l .
-The current column
+The current column number
 is in
-.NR ($c .
-You can test register
-.NR ($m
-[1]
-to see if you are in single-column
-or double-column mode.
-Actually,
-the macro enters
-.i N-
-[2-]column output.
+.NR ($c
+and the number of columns in
+.NR ($m .
 .TL
 .b .1c
 .DE
-Revert to single-column mode.
+Leave multi-column mode;
+return to single-column layout.
 .TL
 .b .bc
 .DE
-Begin column.
-This is like
-.b .bp
-except that it begins a new column
+Begin new column.
+Like
+.b .bp ,
+but begin a column
 on a new page
-only if necessary,
-rather than forcing a whole new page
-if there is another column left
-on the current page.
+only if necessary.
 .sh 1 "Fonts and Sizes"
 .TL
 .b .sz