Re: [PATCH v3] man/man2/statmount.2: Document STATMOUNT_BY_FD

["G. Branden Robinson" <g.branden.robinson@gmail.com>]

[-- Attachment #1: Type: text/plain, Size: 2614 bytes --]

Hi Alex,

At 2026-03-05T23:45:14+0100, Alejandro Colomar wrote:
> On 2026-03-05T16:24:31-0600, G. Branden Robinson wrote:
> > [CC list trimmed way down since this is a *roff/formatting issue]
> > 
> > Hi Alex,
> > 
> > At 2026-03-05T18:19:30+0100, Alejandro Colomar wrote:
> > > BTW, Branden, I'm getting a diagnostic from groff:
> > > 
> > > 	TROFF		.tmp/man/man2/statmount.2.pdf.set
> > > 	! (troff -mandoc -Tpdf -wbreak -rS12 -rU0  <.tmp/man/man2/statmount.2.pdf.troff 2>&1 >.tmp/man/man2/statmount.2.pdf.set) \
> > > 	| grep ^ >&2
> > > 	.tmp/man/man2/statmount.2:155: warning: table row does not fit on page 2
> > > 
> > > But the PDF looks good to me.  Would you mind looking at that page and
> > > telling me what you'd do with that diagnostic, and whether I should care
> > > about it?
> > 
> > I can't reproduce this diagnostic with groff 1.23.0 or 1.24.0.
> 
> Huh...  I'm reproducing it on my server, but not on my desktop.
> On my server, I have:
> 
> 	GNU troff (groff) version 1.23.0.1254-19a18
> 
> On my desktop, I have:
> 
> 	GNU grops (groff) version 1.23.0.2695-49927

Hmm.  Revision 19a18 is 9 May 2024, and 49927 is 22 December 2024.

Both are a little old.  :)

> I'll assume this is a fixed issue, since the newer groff(1) from my
> desktop doesn't reproduce it.

If I get stuck on the other stuff I'm working on,[1] I'll see if I can
reproduce the problem with 1.23.0.1254-19a18 and then bisect it down.

> > > 	.tmp/man/man2/statmount.2:155: warning: table row does not fit on page 2
> > 
> > This warning means that a row of the table might be vertically
> > encroaching into the footer margin; in extreme cases, might
> > overprint the page footer itself; and in really loony cases, format
> > text beyond the bottom of the page.
> 
> Yeah, that's what I was expecting, but the page renders fine, and I
> don't see anything near the margins, which made it weird.

The warning will issue if the table row is overset by as little as 1
"basic unit", which for PostScript and PDF is 1/72,000 of an inch.

That's 0.0000353 centimeters.  It's microscopically small.

If there's a way to get the _amount_ of overset into that diagnostic
message, it would be helpful to the document maintainer to decide
whether it's a problem they want to deal with.

Your other data explains why I couldn't reproduce it.  It could have
been a bug that got squashed between May and December of 2024.

If I find out it's still there, latent, I'll go at it with guns blazing.

Regards,
Branden

[1] largely https://savannah.gnu.org/bugs/?67978

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]