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

[Lennart Jablonka <humm@ljabl.com>]

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).