[groff] 11/33: doc/meref.me.in: Relocate material.

[G. Branden Robinson]

gbranden pushed a commit to branch temp-mail-fail
in repository groff.

commit 286d38603f4936c3acb7eea034dbe15a481bee1a
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Tue Dec 21 12:19:39 2021 +1100

    doc/meref.me.in: Relocate material.
    
    * Move `m[1234]` macros from "Headers and Footers" to "roff Support".
    * Move `ep` macro from "Headers and Footers" to "Miscellaneous".
    
    These seem like more appropriate locations, and further I think it is
    helpful for newcomers to have to absorb less material to learn about
    header and footer manipulation features.
    
    `ep` is explicitly described as being applied to pending footnote
    flushes, and not to do with footers (it in fact does _not_ suppress the
    footer), so again a relocation seems appropriate.
---
 doc/meref.me.in | 100 +++++++++++++++++++++++++-------------------------------
 1 file changed, 45 insertions(+), 55 deletions(-)

diff --git a/doc/meref.me.in b/doc/meref.me.in
index e7940eae..0ff29f35 100644
--- a/doc/meref.me.in
+++ b/doc/meref.me.in
@@ -601,16 +601,6 @@ and
 is the distance from the bottom of the page
 to the bottom of the text
 (nominal).
-The macros
-.b .m1 ,
-.b .m2 ,
-.b .m3 ,
-and
-.b .m4
-are supplied for compatibility
-with old
-.i roff (1)
-documents.
 .TL
 .b .he
 \*(TP
@@ -659,51 +649,6 @@ of every odd-numbered page.
 Suppress headers and footers
 on the next page.
 .TL
-.b .m1
-.i \(+-N
-.DE
-Set/adjust the space between the top of the page
-and the header to/by
-.i \(+-N
-[4v].
-.TL
-.b .m2
-.i \(+-N
-.DE
-Set/adjust the space between the header
-and the first line of text to/by
-.i \(+-N
-[2v].
-.TL
-.b .m3
-.i \(+-N
-.DE
-Set/adjust the space
-between the bottom of the text
-and the footer to/by
-.i \(+-N
-[2v].
-.TL
-.b .m4
-.i \(+-N
-.DE
-Set/adjust the space
-between the footer
-and the bottom of the page to/by
-.i \(+-N
-[4v].
-.TL
-.b .ep
-.DE
-End this page,
-but do not begin the next page.
-Useful for forcing out footnotes,
-but other than
-that hardly ever used.
-Must be followed by a
-.b .bp
-or the end of input.
-.TL
 .b .$h
 .DE
 Output the page header.
@@ -1326,6 +1271,40 @@ inside a
 .b .(b
 block.
 .TL
+.b .m1
+.i \(+-N
+.DE
+Set/adjust the space between the top of the page
+and the header to/by
+.i \(+-N
+[4v].
+.TL
+.b .m2
+.i \(+-N
+.DE
+Set/adjust the space between the header
+and the first line of text to/by
+.i \(+-N
+[2v].
+.TL
+.b .m3
+.i \(+-N
+.DE
+Set/adjust the space
+between the bottom of the text
+and the footer to/by
+.i \(+-N
+[2v].
+.TL
+.b .m4
+.i \(+-N
+.DE
+Set/adjust the space
+between the footer
+and the bottom of the page to/by
+.i \(+-N
+[4v].
+.TL
 .b .pa
 .i \(+-N
 .DE
@@ -1647,6 +1626,17 @@ at the beginning and/or end
 of a floating keep
 to differentiate
 the text from a figure.
+.TL
+.b .ep
+.DE
+End this page,
+but do not begin the next page.
+Useful for forcing out footnotes,
+but other than
+that hardly ever used.
+Must be followed by a
+.b .bp
+or the end of input.
 .sh 1 "Formal Documents"
 .TL
 .b .tp