[bug #62182] [man] automatically prevent page break between (sub)section heading and tagged paragraph

[G. Branden Robinson]

URL:
  <https://savannah.gnu.org/bugs/?62182>

                 Summary: [man] automatically prevent page break between
(sub)section heading and tagged paragraph
                 Project: GNU troff
            Submitted by: gbranden
            Submitted on: Mon 14 Mar 2022 06:17:55 AM UTC
                Category: Macro man
                Severity: 1 - Wish
              Item Group: Feature change
                  Status: None
                 Privacy: Public
             Assigned to: None
             Open/Closed: Open
         Discussion Lock: Any
         Planned Release: None

    _______________________________________________________

Details:

Right now our man(7) implementation isn't smart enough to automatically
suppress a page break if the first thing after a (sub)section heading is a
tagged paragraph.


$ cat EXPERIMENTS/breaky-section-heading.man
.TH foo 1 "groff test suite" 2022-03-13
.SH Name
foo \- frobnicate a bar
.sp 49v
.SH Environment
.TP
.B MISFORTUNE
The kind of fortune that never misses.
$ groff -b -ww -a -man EXPERIMENTS/breaky-section-heading.man
<beginning of page>
foo(1) General Commands Manual foo(1)
Name 
 foo <-> frobnicate a bar
Environment 
2022-03-13 groff test suite 1
<beginning of page>
foo(1) General Commands Manual foo(1)
 MISFORTUNE
 The kind of fortune that never misses.
2022-03-13 groff test suite 2


This bug is present in groff 1.22.4 and persists in Git HEAD.

I'm not sure how to fix this.  We could read each paragraph into a diversion. 
If we do that we might as well do the four-line window window/orphan control
thing.

Most man(7) implementations have problems like this.  I don't think ours is
worst than most.

But I'd like it to be better.




    _______________________________________________________

Reply to this item at:

  <https://savannah.gnu.org/bugs/?62182>

_______________________________________________
  Message sent via Savannah
  https://savannah.gnu.org/