summaryrefslogtreecommitdiff
path: root/doc/meref.me.in
diff options
context:
space:
mode:
authorG. Branden Robinson <g.branden.robinson@gmail.com>2022-11-26 13:41:47 -0600
committerG. Branden Robinson <g.branden.robinson@gmail.com>2022-11-26 13:41:47 -0600
commite79eee63ad722928ff9da0ca68ec7e0f74993b0c (patch)
tree401f2180292dfacb0e52ee4a049f8b23df7c7e34 /doc/meref.me.in
parent9183fe5eecec7b11c9f445dda23071579e589add (diff)
downloadgroff-git-e79eee63ad722928ff9da0ca68ec7e0f74993b0c.tar.gz
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.)]
Diffstat (limited to 'doc/meref.me.in')
-rw-r--r--doc/meref.me.in95
1 files 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