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