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

 
 

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

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

Add a New Comment (Rich Markup)
   

You are not logged in

Please log in, so followups can be emailed to you.

 

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>
Project AdministratorIn charge of this item.
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>
Project AdministratorIn charge of this item.
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>
Project AdministratorIn charge of this item.

 

(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)
  •  

    Do you think this task is very important?
    If so, you can add your encouragement to it.
    This task has 0 encouragements so far.

    Only logged-in users can vote.

     

     

     

    Follow 6 latest changes.

    Date Changed by Updated Field Previous Value => Replaced by
    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.7