[groff] 06/32: doc/meref.me.in: Relocate material and update.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit e79eee63ad722928ff9da0ca68ec7e0f74993b0c
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sat Nov 26 13:41:47 2022 -0600

    doc/meref.me.in: Relocate material and update.
    
    * Relocate discussion of horizontal margins (line length, page offset)
      earlier in the document, since they seem like a fairly basic thing
      that a package user would also want to know about.  This also groups
      them with the _vertical_ margin discussion.
    * Retitle applicable section to "Headers, Footers, and Margins".
    * Adjust dead-tree pagination.
    
    I feel myself starting to itch for a pair of "KISS" keep macros that
    truly do nothing more than opening a diversion and, upon closure,
    measuring it to see if it will fit, breaking if it won't.  me(7)'s
    displays and keeps all seem to want to also manipulate filling, adjust
    margins, and all kinds of stuff inessential to widow and orphan control.
    
    [Maybe `.(b` and `.)b` will do this if you give the former "L" and "F"
    arguments.  Sure does seem like the long way around.  (Even then,
    there's that damn "block threshold" feature complicating things.)]
---
 doc/meref.me.in | 95 +++++++++++++++++++++++++++++++--------------------------
 1 file changed, 51 insertions(+), 44 deletions(-)

diff --git a/doc/meref.me.in b/doc/meref.me.in
index 500d2ec5f..d07ce7e32 100644
--- a/doc/meref.me.in
+++ b/doc/meref.me.in
@@ -536,7 +536,7 @@ of depth
 .\" future non-introductory me(7) usage manual.
 They could be used
 to obtain section depth-dependent spacing.
-.sh 1 "Headers and Footers"
+.sh 1 "Headers, Footers, and Margins"
 .ds TP \(aq\,\fIL\/\fP\(aq\,\fIM\/\fP\(aq\,\fIR\/\fP\(aq
 .pp
 Headers and footers
@@ -596,6 +596,50 @@ and
 [6v]
 that from the bottom of the page
 to the (nominal) bottom of the text.
+.pp
+\*(ME uses \*T's environment 0 for body text,
+1 for keeps
+(see below),
+and 2 for headers and footers.
+The default line length is two inches less than the page width
+(e.g.,
+6.5i on U.S.\& letter paper).
+The default page offset
+(left margin)
+is determined by the output device;
+it is typically 1.0i on typesetting devices and 0 on terminals.
+.TL
+.b .xl
+.i \(+-n
+.DE
+Set line length to
+.i n
+[see above]
+only in the current environment.
+.TL
+.b .ll
+.i \(+-n
+.DE
+Set line length to
+to
+.i n
+[see above]
+in all environments used by \*(ME,\**
+.(f
+\**
+\*(ME uses only the three environments of AT&T \*T,
+but in GNU \*T,
+the user can create additional ones.
+.b .ll
+works like
+.b .xl
+for the latter.
+.)f
+and store it in
+.NR ($l .
+This macro should not be used
+after output has begun,
+and particularly not in multi-column layouts.
 .TL
 .b .he
 \*(TP
@@ -749,6 +793,9 @@ filling is enabled.
 .b .)l
 .DE
 End list.
+.\" dead-tree pagination
+.br
+.ne 4v
 .TL
 .b .(q
 .DE
@@ -1032,6 +1079,9 @@ using the current font and type size
 with display vertical spacing
 (\c
 .NR (dv ).
+.\" dead-tree pagination
+.br
+.ne 4v
 .sh 1 "Columnated Output"
 .TL
 .b .2c
@@ -1691,49 +1741,6 @@ that hardly ever used.
 Must be followed by a
 .b .bp
 request or the end of input.
-.pp
-\*(ME uses \*T's environment 0 for body text,
-1 for keeps,
-and 2 for headers and footers.
-The default line length is two inches less than the page width
-(e.g.,
-6.5i on U.S.\& letter paper).
-The default page offset
-(left margin)
-is determined by the output device;
-it is usually 1.0i on typesetting devices and 0 on terminals.
-.TL
-.b .xl
-.i \(+-n
-.DE
-Set line length to
-.i n
-[see above]
-only in the current environment.
-.TL
-.b .ll
-.i \(+-n
-.DE
-Set line length to
-to
-.i n
-[see above]
-in all environments used by \*(ME,\**
-.(f
-\**
-\*(ME uses only the three environments of AT&T \*T,
-but in GNU \*T,
-the user can create additional ones.
-.b .ll
-works like
-.b .xl
-for the latter.
-.)f
-and store it in
-.NR ($l .
-This macro should not be used
-after output has begun,
-and particularly not in multi-column layouts.
 .\" dead-tree pagination
 .br
 .ne 6v