[groff] 02/20: doc/meref.me.in: Fix content nits.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 1eade7afc1aa31042604578dfbb0f22eda5bac41
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sat Nov 19 09:23:32 2022 -0600

    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.
---
 doc/meref.me.in | 31 +++++++++++++++----------------
 1 file 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: