[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[bug #60653] [man] align header/footer spacing with mdoc when continuous
From: |
G. Branden Robinson |
Subject: |
[bug #60653] [man] align header/footer spacing with mdoc when continuously rendering |
Date: |
Fri, 21 May 2021 22:43:49 -0400 (EDT) |
User-agent: |
Mozilla/5.0 (X11; Linux x86_64; rv:78.0) Gecko/20100101 Firefox/78.0 |
Update of bug #60653 (project groff):
Summary: [man] align header/footer spacing when continuously
rendering with mdoc => [man] align header/footer spacing with mdoc when
continuously rendering
_______________________________________________________
Follow-up Comment #1:
Filed report prematurely. Trying again.
man(7) historically puts 3v, or half an inch, between header/footer lines and
body text. (Note: this has nothing to do with vertical space before the
header line or after the footer line.)
Per Ingo Schwarze, mdoc(7) has always put only one blank like (1v) in those
places, going back to the original Livingston implementations ca. 1990.
Furthermore, man-db man(1) filters supernumerary blank lines out of groff -man
output when rendering to the terminal[1], so many (most?) consumers of
rendered man(7) pages already don't see any such lines beyond the first in
either location.
These blank lines don't serve much purpose when continuously rendering, so
dispose of them.
It also might be a good idea to indirect this spacing through a
package-private register. Magic constants are just as bad in *roff code as in
C.
[1] src/man.c:1546-1590 in man-db 2.9.4 (Feburary 2021); the code dates back
to August 2015. Maybe some day, long after groff 1.23.0 is released, man-db
can kill off this code.
_______________________________________________________
Reply to this item at:
<https://savannah.gnu.org/bugs/?60653>
_______________________________________________
Message sent via Savannah
https://savannah.gnu.org/