bugGNU roff - Bugs: bug #60653, [man] align header/footer spacing...

 
 

bug #60653: [man] align header/footer spacing with mdoc when continuously rendering

Submitter:  G. Branden Robinson <gbranden>
Submitted:  Sat 22 May 2021 02:36:33 AM UTC
   
 
Category:  Macro man Severity:  1 - Wish
Item Group:  Rendering/Cosmetics Status:  Fixed
Privacy:  Public Assigned to:  gbranden
Open/Closed:  Closed Planned Release:  1.23.0
* Mandatory Fields

Add a New Comment Rich Markup
   

Wed 16 Jun 2021 11:56:32 PM UTC, comment #2: 


commit 2278d6ed67c8d85b021c9db35ecb2c44f5d19ae6
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
Date:   Wed Jun 16 04:41:47 2021 +1000

    [man]: Sync continuous rendering space with mdoc.

    * tmac/an-old.tmac (an-end, an-header): In continuous rendering mode,
      use same spacing amount after header and before footer as mdoc in its
      own continuous rendering mode.  Thanks to Ingo Schwarze for the
      suggestion.

    Fixes <https://savannah.gnu.org/bugs/?60653>.


G. Branden Robinson <gbranden>
Group administrator
Sat 22 May 2021 02:43:49 AM UTC, 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.

G. Branden Robinson <gbranden>
Group administrator
Sat 22 May 2021 02:36:33 AM UTC, original submission:  

man(7) historically puts 3v, or half an inch, between header/footer lines and body text.

Per Ingo Schwarze, mdoc(7) has always put only one blank like (1v) in those places, going back to the origin Livingston implementations ca. 1990.

Furthermore, man-db man(1) filters such blank lines out of groff -man output when rendering to the terminal[1], so many (most?) consumers of

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.

G. Branden Robinson <gbranden>
Group administrator

 

(Note: upload size limit is set to 16384 kB, after insertion of the required escape characters.)

Attach Files:
   
   
Comment:
   

No files currently attached

 

Depends on the following items: None found

Items that depend on this one: None found

 

Carbon-Copy List
  • -email is unavailable- added by gbranden (Submitted the item)
  •  

    There are 0 votes so far. Votes easily highlight which items people would like to see resolved in priority, independently of the priority of the item set by tracker managers.

    Only logged-in users can vote.

     

    Follow 7 latest changes.

    Date Changed by Updated Field Previous Value => Replaced by
    2022-01-11 gbranden Item GroupNone Rendering/Cosmetics
    2021-06-16 gbranden StatusIn Progress Fixed
        Open/ClosedOpen Closed
        Planned ReleaseNone 1.23.0
    2021-06-15 gbranden StatusNone In Progress
        Assigned toNone gbranden
    2021-05-22 gbranden Summary[man] align header/footer spacing when continuously rendering with mdoc [man] align header/footer spacing with mdoc when continuously rendering

    Back to the top

    Powered by Savane 3.13-02a9.
    Corresponding source code