[groff] 21/23: [man pages]: Fix style and markup nits.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 1d130bcf9e5814c5533b9e18a5449cb778e6e06e
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sat Jul 30 12:25:21 2022 -0500

    [man pages]: Fix style and markup nits.
    
    * Explicitly place paragraphing macros before tables that should be
      preceded with vertical space, in anticipation of the resolution of
      Savannah #62841.
    * Improve dead-tree typography: when preventing a page break early in a
      table (or "keeping" the entire thing), account for the fact that
      horizontal rules take up 1v of vertical space on nroff devices.
    * Put an empty request where a break is expected.
---
 man/groff_char.7.man    | 56 ++++++++++++++++++++++++++++++++++++++-----------
 tmac/groff_man.7.man.in | 24 ++++++++++++++-------
 tmac/groff_ms.7.man     |  3 +++
 3 files changed, 63 insertions(+), 20 deletions(-)

diff --git a/man/groff_char.7.man b/man/groff_char.7.man
index 45e72c7bf..6eab81746 100644
--- a/man/groff_char.7.man
+++ b/man/groff_char.7.man
@@ -261,6 +261,7 @@ in the next subsection.
 .
 .P
 All of the following characters map to glyphs as you would expect.
+.
 .TS
 center box;
 Lf(CR).
@@ -946,9 +947,12 @@ minus,
 and equals
 signs normally drawn from this range.
 .
+.
+.P
+.if t .ne 2v
+.if n .ne 3v \" account for horizontal rule
 .TS
 L L L Lx.
-.ne 3v
 Output Input   Unicode Notes
 _
 .T&
@@ -991,9 +995,12 @@ but rather to \[lq]SS\[rq].
 \[lq]Lowercase f with hook\[rq] is also used as a function symbol;
 see subsection \[lq]Mathematical symbols\[rq] below.
 .
+.
+.P
+.if t .ne 2v
+.if n .ne 3v \" account for horizontal rule
 .TS
 L L L Lx.
-.ne 3v
 Output Input   Unicode Notes
 _
 .T&
@@ -1067,9 +1074,11 @@ and
 .RB \[lq] "caf\[rs][aa]e" \[rq]).
 .
 .
+.P
+.if t .ne 2v
+.if n .ne 3v \" account for horizontal rule
 .TS
 L L L Lx.
-.ne 3v
 Output Input   Unicode Notes
 _
 .T&
@@ -1098,9 +1107,12 @@ All of these glyphs can be composed using combining 
glyph names as
 described in subsection \[lq]Special character escape forms\[rq] above;
 the names below are short aliases for convenience.
 .
+.
+.P
+.if t .ne 2v
+.if n .ne 3v \" account for horizontal rule
 .TS
 L L L Lx.
-.ne 3v
 Output Input   Unicode Notes
 _
 .T&
@@ -1185,9 +1197,12 @@ is also available as a special character for convenient 
embedding in
 macro arguments;
 see subsection \[lq]Fundamental character set\[rq] above.
 .
+.
+.P
+.if t .ne 2v
+.if n .ne 3v \" account for horizontal rule
 .TS
 L L L Lx.
-.ne 3v
 Output Input   Unicode Notes
 _
 .T&
@@ -1219,9 +1234,12 @@ mnemonic for the visually similar but semantically 
distinct
 multiplication dot;
 see subsection \[lq]Mathematical symbols\[rq] below.
 .
+.
+.P
+.if t .ne 2v
+.if n .ne 3v \" account for horizontal rule
 .TS
 L L L Lx.
-.ne 3v
 Output Input   Unicode Notes
 _
 .T&
@@ -1335,9 +1353,11 @@ only glyphs with long names are guaranteed to pile up 
correctly for all
 devices\[em]provided those glyphs are available.
 .
 .
+.P
+.if t .ne 2v
+.if n .ne 3v \" account for horizontal rule
 .TS
 L L L Lx.
-.ne 3v
 Output Input   Unicode Notes
 _
 .T&
@@ -1467,9 +1487,11 @@ for this purpose;
 see subsection \[lq]Mathematical symbols\[rq] below.
 .
 .
+.P
+.if t .ne 2v
+.if n .ne 3v \" account for horizontal rule
 .TS
 L L L Lx.
-.ne 3v
 Output Input   Unicode Notes
 _
 .T&
@@ -1525,9 +1547,12 @@ L Lf(CR) L Lx.
 The Bell System logo is not supported in
 .IR groff .
 .
+.
+.P
+.if t .ne 2v
+.if n .ne 3v \" account for horizontal rule
 .TS
 L L L Lx.
-.ne 3v
 Output Input   Unicode Notes
 _
 .T&
@@ -1601,9 +1626,12 @@ Terminal devices unify
 and
 .BR \[rs][or] .
 .
+.
+.P
+.if t .ne 2v
+.if n .ne 3v \" account for horizontal rule
 .TS
 L L L Lx.
-.ne 3v
 Output Input   Unicode Notes
 _
 .T&
@@ -1679,9 +1707,11 @@ and
 are their counterparts with mathematical spacing.
 .
 .
+.P
+.if t .ne 2v
+.if n .ne 3v \" account for horizontal rule
 .TS
 L L L Lx.
-.ne 3v
 Output Input   Unicode Notes
 _
 .T&
@@ -1786,9 +1816,11 @@ the uppercase letters have upright shape,
 and the lowercase ones are slanted.
 .
 .
+.P
+.if t .ne 2v
+.if n .ne 3v \" account for horizontal rule
 .TS
 L L L Lx.
-.ne 3v
 Output Input   Unicode Notes
 _
 .T&
diff --git a/tmac/groff_man.7.man.in b/tmac/groff_man.7.man.in
index 5088162ba..8230c64f1 100644
--- a/tmac/groff_man.7.man.in
+++ b/tmac/groff_man.7.man.in
@@ -3604,8 +3604,10 @@ When documenting GNU/Linux command or C language syntax,
 however,
 this translation is sometimes not desirable.
 .
-.br
-.ne 3v
+.
+.IP
+.if t .ne 2v
+.if n .ne 3v \" account for horizontal rule
 .TS
 c c
 rfCB lfCB.
@@ -3650,8 +3652,10 @@ Probably not.
 When this seems necessary,
 often a shorter or clearer alternative is available.
 .
-.br
-.ne 10v
+.
+.IP
+.if t .ne 10v
+.if n .ne 16v \" account for horizontal rules
 .TS
 c c
 lfCB lfCB.
@@ -3840,8 +3844,10 @@ Not if you don't want to change it.
 .
 Review subsection \(lqHorizontal and vertical spacing\(rq above.
 .
-.br
-.ne 4v
+.
+.IP
+.if t .ne 5v
+.if n .ne 7v \" account for horizontal rules
 .TS
 c c
 lfCB lfCB.
@@ -3893,8 +3899,10 @@ would then need to be suffixed with
 .B \[rs]&
 when not ending a sentence.
 .
-.br
-.ne 4v
+.
+.IP
+.if t .ne 5v
+.if n .ne 7v \" account for horizontal rules
 .TS
 C C
 LfCB LfCB.
diff --git a/tmac/groff_ms.7.man b/tmac/groff_ms.7.man
index b62898fbd..eb9af571b 100644
--- a/tmac/groff_ms.7.man
+++ b/tmac/groff_ms.7.man
@@ -1741,6 +1741,8 @@ Load the desired localization macro package after
 see
 .MR groff_tmac @MAN5EXT@ .
 .
+.
+.P
 .RS
 .TS
 cb   cb
@@ -2639,6 +2641,7 @@ defined
 accent mark strings as follows.
 .
 .
+.P
 .TS
 Cb Lb
 Lf(CR) L.