Re: [BUG] man(7) page not showing footer

[Alex Colomar]

Hi Branden!

On 11/2/22 09:30, G. Branden Robinson wrote:
> At 2022-11-02T01:16:12-0500, G. Branden Robinson wrote:
> > That isn't confirmed yet, but after also seeing the problem in
> > filesystems(5), slabinfo(5), and utmp(5), that's the way my nose hairs
> > are blowing.
>
> Guess I should break out the trimmers; disabling the abbreviation logic
> did not remedy the problem.
>
> Nevertheless I found it after further sniffing.  I have now undergone a
> rite of passage that many writers of *roff macro packages experience:
> stumbling over the landmine of end-of-input trap page-ejection behavior.

Heh, I've been reading the patch, and it very much sounds like Chinese 
to me.  Good that it was easy for you :)

> This bug did not affect groff man(7) in 1.22.4; that isn't too much of a
> surprise because I rewrote continuous rendering support afterward.  I
> _think_ the bug was latent in groff 1.22.4 mdoc(7), but I am not
> positive because headers and footers generally failed to appear in
> continuous rendering mode in that release for that package.  Regardless,
> it's certainly present in groff Git master on Savannah now.  But, not
> long ago I ported over groff man(7)'s continuous rendering handling to
> our mdoc(7), replacing the method it had been using--I don't know if I
> exposed the bug or merely created it.
>
> Rest assured, I have regression tests for this for both packages now.
>
> Please apply the attached patch to your groff sources.  This will be in
> my next push.

I'll get it from git soon.  I'm not in a hurry for it ;)

> I have tried to explain the bug and fix clearly in comments and the
> ChangeLog but the problem is in one of the more damnably subtle aspects
> of formatter; witness the lengthy comment (that I recast), introduced by
> Werner way back in 2001.  I welcome suggestions for clarification.

I wonder why so much duplication.  The ChangeLog seems like an exact 
_duplicate_ of the git history.

I chopped the Linux man-pages 'Changes' file considerably by having a 
high level overview of the changes, and deferring to git(1) for further 
details.

> Thank you very much for using the Linux man-pages corpus to help
> solidify groff man(7) for release.

Thank you very much for giving me the tools to improve the Linux 
man-pages :-}

Cheers,
Alex

--
<http://www.alejandro-colomar.es/>

OpenPGP_signature
Description: OpenPGP digital signature