[groff] 04/12: tbl(1): Adjust dead-tree typography (page breaks).

[G. Branden Robinson]

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
 .\" ====================================================================