diff options
author | G. Branden Robinson <g.branden.robinson@gmail.com> | 2022-11-19 09:23:32 -0600 |
---|---|---|
committer | G. Branden Robinson <g.branden.robinson@gmail.com> | 2022-11-19 09:39:31 -0600 |
commit | 1eade7afc1aa31042604578dfbb0f22eda5bac41 (patch) | |
tree | 250f0b63152d5b1a63f7fdadd8aa50e1c85da2af /doc/meref.me.in | |
parent | 64b913691a0406ce2dd4ba188eb68c3492972b6b (diff) | |
download | groff-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.in | 31 |
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: |