summaryrefslogtreecommitdiff
path: root/doc/meref.me.in
diff options
context:
space:
mode:
authorG. Branden Robinson <g.branden.robinson@gmail.com>2022-11-19 09:23:32 -0600
committerG. Branden Robinson <g.branden.robinson@gmail.com>2022-11-19 09:39:31 -0600
commit1eade7afc1aa31042604578dfbb0f22eda5bac41 (patch)
tree250f0b63152d5b1a63f7fdadd8aa50e1c85da2af /doc/meref.me.in
parent64b913691a0406ce2dd4ba188eb68c3492972b6b (diff)
downloadgroff-git-1eade7afc1aa31042604578dfbb0f22eda5bac41.tar.gz
doc/meref.me.in: Fix content nits.
* Remove Allman's address block. He probably hasn't worked for Project INGRES in 30+ years <https://web.archive.org/web/20140126085541/\ http://db.cs.berkeley.edu/w/source-code/>. This also frees up some much-needed space on page 1 when formatting for U.S. letter paper. * Use that space to introduce the concept of hook macros in the introduction rather than inline later. * Document preferred method of hook suppression. * Adjust dead tree pagination for "Paragraphing" section. * Clear `$H` hook macro after feature summary table. * End multi-column mode gracefully.
Diffstat (limited to 'doc/meref.me.in')
-rw-r--r--doc/meref.me.in31
1 files changed, 15 insertions, 16 deletions
diff --git a/doc/meref.me.in b/doc/meref.me.in
index b80609293..c2325ed4b 100644
--- a/doc/meref.me.in
+++ b/doc/meref.me.in
@@ -94,11 +94,6 @@
.ul
Eric P. Allman
.sp
-Project INGRES
-Electronics Research Laboratory
-University of California, Berkeley
-Berkeley, California 94720
-.sp 2
.i "Adapted for \fR\*(UG\fP by James Clark and G.\& Branden Robinson"
.ce 0
.sp 4
@@ -196,13 +191,17 @@ but should not be changed.
Macros with names of the form
.b $ \c
.bi x
-are called internally by \*(ME
+are
+.i hooks,
+called internally by \*(ME,
and can be redefined
to alter their function.
This may be a sensitive operation;
look at the macro definition in the
.i e.tmac
file before changing it.
+If you don't require a given hook,
+(re)define it as empty instead of removing it.
.pp
Objects in \*(ME
follow a rigid naming convention.
@@ -225,6 +224,9 @@ and avoid names starting with
The names employed
by any preprocessors in use
should also not be repurposed.
+.\" dead-tree pagination
+.br
+.ne 8v
.sh 1 "Paragraphing"
.TL
.b .lp
@@ -495,10 +497,8 @@ times\~\c
.i B
.i n
.DE
-This
-.i hook
-macro,
-normally undefined,
+This hook macro,
+normally empty,
is called automatically
by
.b .sh
@@ -2414,12 +2414,11 @@ and a square \(sq labels \*G extensions.
\e\(ti F\(sc\(sq unbreakable word space
.)l
.if n .)c
-.\" If we add material after this point, leave multi-column mode. But
-.\" don't do so if there is no further content, because if one column is
-.\" already full, `1c` will produce an unnecessary empty page with the
-.\" `$H` table header.
-.\"if t .1c
-.rm $H
+.ds $H \" empty
+.\" If we're laying out the final column, `1c` will produce an
+.\" unnecessary empty page. If we're not, omitting `1c` will format a
+.\" column of headers with nothing underneath.
+.if \n($c<\n($m .1c
.\" Local Variables:
.\" mode: nroff
.\" End: