[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

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

From: G. Branden Robinson
Subject: [groff] 02/20: doc/ Fix content nits.
Date: Thu, 24 Nov 2022 22:11:30 -0500 (EST)

gbranden pushed a commit to branch master
in repository groff.

commit 1eade7afc1aa31042604578dfbb0f22eda5bac41
Author: G. Branden Robinson <>
AuthorDate: Sat Nov 19 09:23:32 2022 -0600

    doc/ Fix content nits.
    * Remove Allman's address block.  He probably hasn't worked for Project
      INGRES in 30+ years <\>.  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/ | 31 +++++++++++++++----------------
 1 file changed, 15 insertions(+), 16 deletions(-)

diff --git a/doc/ b/doc/
index b80609293..c2325ed4b 100644
--- a/doc/
+++ b/doc/
@@ -94,11 +94,6 @@
 Eric P. Allman
-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
+.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.
 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 8v
 .sh 1 "Paragraphing"
 .b .lp
@@ -495,10 +497,8 @@ times\~\c
 .i B
 .i n
-.i hook
-normally undefined,
+This hook macro,
+normally empty,
 is called automatically
 .b .sh
@@ -2414,12 +2414,11 @@ and a square \(sq labels \*G extensions.
 \e\(ti F\(sc\(sq       unbreakable word space
 .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:

reply via email to

[Prev in Thread] Current Thread [Next in Thread]