Proposal for removal of long options from synopsis sections in the manual pages

[0mp]

Hey,

I was wondering, do we actually need to have long options described in the synopsis sections in the manual pages? They add a lot of noise and aren't very readable. E.g.:

 pkg install [--{automatic,force,no-scripts,ignore-missing}]

[bapt]

I have no opinion there, but people seems to want the long option documented so I don't know

[igalic]

having them documented is a must
putting them in the synopsis is questionable.

[pauamma]

So what's the consensus? Remove long options from the synopsis, leaving only the short options there, but keep both in the description? Asking so I have a clear notion of how to revise my pkg-set(8) patch in #2076 and proceed with the rest of the manual pages.

[ghost]

I would really love to see long options removed from synopsis.