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

[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 ncurses man pages for a while it became clear to me
> how to modestly revise the way groff man(7)'s SY and YS macros work to
> serve both sets of authors better.

I’m sure this is good and fine, but I do wanna mention this: 
SYNOPSIS items with lines after the first one aligned, possibly 
with something on the first line, is like the one usecase for .HP.  
I think it would be good to mention that, even if Groff deprecates 
.HP (because HTML is incapable of expressing that?  I don’t like 
that reason.  Besides, CSS has `text-indent: $length hanging` 
now).