mandoc(1)'s man pages, groffed, and Project KIC (was: Milestone reached: hyperlinked mdoc(7) documents in PDF)

2024-03-18 Thread G. Branden Robinson
[dropping Alex from To: header] Hi Lennart, At 2024-03-18T21:13:32+, Lennart Jablonka wrote: > I wouldn’t at all be surprised by what I’d call errors in the mandoc > man pages, as I guess they aren’t tested a whole lot with more general > troffs and the project calls mdoc not a macro package

Re: Milestone reached: hyperlinked mdoc(7) documents in PDF

2024-03-18 Thread Lennart Jablonka
Quoth G. Branden Robinson: There may be some malformedness here complicating matters. My example of .No Ar is not malformed: The No there is useless, yes, but that shouldn’t break anything. The warning is a warning of the uselessness, not a warning of unspecifiedness. I simply wanted to po

Re: Milestone reached: hyperlinked mdoc(7) documents in PDF

2024-03-18 Thread G. Branden Robinson
At 2024-03-18T13:00:19-0500, G. Branden Robinson wrote: > At 2024-03-18T12:56:45-0500, G. Branden Robinson wrote: > > It is not a goal of groff to behave identically to mandoc(1) in the > > face of unspecified input. Is your input specified somewhere? (I > > don't have the command of mdoc(7) that

Re: Milestone reached: hyperlinked mdoc(7) documents in PDF

2024-03-18 Thread G. Branden Robinson
At 2024-03-18T12:56:45-0500, G. Branden Robinson wrote: > It is not a goal of groff to behave identically to mandoc(1) in the face > of unspecified input. Is your input specified somewhere? (I don't have > the command of mdoc(7) that I do of man(7), and as we've seen, my grasp > of the latter is

Re: Milestone reached: hyperlinked mdoc(7) documents in PDF

2024-03-18 Thread G. Branden Robinson
Hi Lennart, At 2024-03-18T02:08:10+, Lennart Jablonka wrote: > .Dd March 18, 2024 > .Dt EMPTY-CALLED-AR > .Os > .Sh NAME > .Nm empty-called-Ar > .Nd a groff \-mdoc bug > .Sh DESCRIPTION > Empty called Ar: > .No Ar > That's it: This text right here shouldn't be oblique. > .Pp > I found this in

Re: groff now undoing .ad settings after .IP

2024-03-18 Thread G. Branden Robinson
[self-follow-up; dropping Russ from CC because it's a pretty obscure point of *roff semantics] At 2024-03-17T15:52:55-0500, G. Branden Robinson wrote: > [6] I've marked `SB` as deprecated in the forthcoming groff 1.24; it > does nothing that modern formatters can't achieve by combining `SM` >

Running the grohtml pipeline as a pipeline

2024-03-18 Thread Alejandro Colomar
Hi Branden, I'm considering using grohtml(1) in the Linux man-pages, to replace man2html(1), which crashes on tzfile(5) --which has correct man(7)--. Currently, I'm running groff(1) as its separate constituents: $ make build-ps -Wman2/membarrier.2 PRECONV .tmp/man/man2/me

Re: groff now undoing .ad settings after .IP

2024-03-18 Thread Frederic Chartier via
On 2024-03-17 15:52 -0500, G. Branden Robinson wrote: > A. GNU roff and Sun troff are, historically, heavyweights in terms of > users served. Apparently, man page users on these systems have been > accepting of adjustment ("full justification") for decades. Perhaps "suffering" would be