[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[groff] 04/12: tbl(1): Adjust dead-tree typography (page breaks).
From: |
G. Branden Robinson |
Subject: |
[groff] 04/12: tbl(1): Adjust dead-tree typography (page breaks). |
Date: |
Sat, 20 Nov 2021 05:19:10 -0500 (EST) |
gbranden pushed a commit to branch master
in repository groff.
commit b71565c286065068499f208b72a2097cd0a37551
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Thu Nov 18 11:22:18 2021 +1100
tbl(1): Adjust dead-tree typography (page breaks).
* src/preproc/tbl/tbl.1.man: Explicitly break before `ne` request before
(sub)section headings so that we can keep the section heading with the
subsequent material, when we want to keep more than two output lines
with the heading.
Notes to self (and other man page writers concerned with the dead tree
typography of their pages):
* For within-paragraph widow/orphan control, place an `ne` request
_after_ the paragraphing macro call.
* For (sub)section heading grouping with subsequent material (especially
when the (sub)sectioning macro call is followed immediately by another
macro call like `RS`, `IP`, or `TP`--although use of the first two,
and arguably the third, immediately after a section heading with no
characterization of what the indentation or list is for is bad style),
placement of `br` and `ne` requests must come _before_ before the
(sub)sectioning macro.
I could try to implement `KS` and `KE` for man(7), as I keep threatening
to do, which would necessitate solving the nested-diversion problem
(commit b5461ca3). (A nice feature of these is that continuous
renderers could completely ignore them, harmlessly.)
A more ambitious approach would be to have _all_ paragraph macros create
diversions, and implement a sliding window of 4 output lines, but that
might be hard to achieve without output line traps as Heirloom Doctools
troff has.
---
src/preproc/tbl/tbl.1.man | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/src/preproc/tbl/tbl.1.man b/src/preproc/tbl/tbl.1.man
index 526b4f1..913f829 100644
--- a/src/preproc/tbl/tbl.1.man
+++ b/src/preproc/tbl/tbl.1.man
@@ -1320,11 +1320,12 @@ region option so that
will recognize them.
.
.
+.br
+.ne 5v \" Keep enough space for heading, intro sentence, and first item.
.\" ====================================================================
.SS "GNU \f[I]tbl\f[] enhancements"
.\" ====================================================================
.
-.ne 3v
In addition to extensions noted above,
GNU
.I tbl \" GNU
@@ -1451,7 +1452,6 @@ interpret the uninterpreted leader escape sequence
.BR \[rs]a .
.
.
-.ne 3v
.\" ====================================================================
.SH Limitations
.\" ====================================================================
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [groff] 04/12: tbl(1): Adjust dead-tree typography (page breaks).,
G. Branden Robinson <=