[groff] 13/17: groff_me(7): Document `n1` and `n2` macros.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 623cfd1885d7ee68914e5c9d49981c2a02476553
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sun Aug 8 04:44:34 2021 +1000

    groff_me(7): Document `n1` and `n2` macros.
    
    * tmac/groff_me.7.man: Document `n1` and `n2` macros.
    
    * doc/meref.me: Sync descriptions of `n1` and `n2` with groff_me(7).
---
 ChangeLog           |  4 ++++
 doc/meref.me        | 23 +++++++++++++----------
 tmac/groff_me.7.man | 13 +++++++++++++
 3 files changed, 30 insertions(+), 10 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 9bc00be..9055f32 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,9 @@
 2021-08-08  G. Branden Robinson <g.branden.robinson@gmail.com>
 
+       * tmac/groff_me.7.man: Document `n1` and `n2` macros.
+
+2021-08-08  G. Branden Robinson <g.branden.robinson@gmail.com>
+
        [me]: Fix PS/n1 combination diagnostic spew and apparent logic
        error.
 
diff --git a/doc/meref.me b/doc/meref.me
index 7e7f7af..12a89f0 100644
--- a/doc/meref.me
+++ b/doc/meref.me
@@ -1337,7 +1337,8 @@ Equivalent to
 .TL
 .b .n1
 .DE
-Number lines in margin from one
+Number lines from one,
+in margin,
 on each page.
 .TL
 .b .n2
@@ -1345,20 +1346,22 @@ on each page.
 .i c
 .DE
 Number lines from
-.i N ,
-stop if
-.i N
-missing; resume where stopped with (unsigned) value
-.i N
-or increment
+.i N .
+.
+Stop numbering if
 .i N
-if
+missing;
+resume where stopped if
 .i N
-is \(+-\c
+unsigned,
+or resume with number incremented by
+\(+-\c
 .i N .
+.
 If
 .i c
-is c, maintain compatibility with original
+is c,
+maintain compatibility with original
 .b .n2
 by narrowing line width to accommodate numbers.
 .TL
diff --git a/tmac/groff_me.7.man b/tmac/groff_me.7.man
index ecca2fb..2f269c6 100644
--- a/tmac/groff_me.7.man
+++ b/tmac/groff_me.7.man
@@ -400,6 +400,19 @@ T}
 \&.lp  \-      yes     T{
 Begin paragraph with first line flush left.
 T}
+\&.n1  \-      no      T{
+Number lines from one,
+in margin,
+on each page.
+T}
+\&.n2 [\fIN\fP]        \-      no      T{
+Number lines from \fIN\fP,
+in margin.
+.
+Stop numbering if \fIN\fP missing;
+resume where stopped with number \fIN\fP if unsigned,
+or resume with number incremented by \(+-\fIN\fP.
+T}
 \&.np  1       yes     T{
 Start numbered paragraph.
 T}