Re: Proposed v2: revised man(7) synopsis macros

2024-04-26 Thread Alejandro Colomar
Hi Branden, On Fri, Apr 26, 2024 at 12:59:58AM -0500, G. Branden Robinson wrote: > Hi folks, > > Difference from v1 > == > Support reuse of previously computed indentation, to line up function > arguments and similar across multiple synopses. Requested by Alex > Colomar. > > Pro

Re: Proposed v2: revised man(7) synopsis macros

2024-04-26 Thread Lennart Jablonka
Quoth G. Branden Robinson: I have been dissatisfied with groff man(7)'s SY and YS macros for a long time. My primary grievance is one that has frustrated its uptake by documenters of libraries: the macros are designed for synopsizing Unix commands, not C library functions. After working on the

Undeprecating man(7)'s `HP` macro? (was: Proposed v2: revised man(7) synopsis macros)

2024-04-26 Thread G. Branden Robinson
Hi Lennart, At 2024-04-26T21:54:15+, Lennart Jablonka wrote: > Quoth G. Branden Robinson: > > I have been dissatisfied with groff man(7)'s SY and YS macros for a > > long time. My primary grievance is one that has frustrated its > > uptake by documenters of libraries: the macros are designed

man(7) <-> mdoc(7) (approximate) correspondence table?

2024-04-26 Thread flexibeast
[ Not subscribed to the linux-man list, so please cc me if replying there. ] Hi all, As someone who's much more familiar with mdoc(7) than man(7), is there an approximate 'correspondence table' somewhere that gives at least a rough sense of which man(7) macros to use when, in an mdoc(7) c