man page .SY/.YS synopsis .OP HTML output breaks long options between hyphens

[Brian Inglis]

Hi folks,

Output of man pages with lengthy synopses from grohtml do not disable adjustment 
and hyphenation as for tty, breaking long options between the hyphens and 
anywhere else available.

Attached is a man page I generated from help2man, then fixed to use current 
macros and look okay on the tty.
I then generated HTML output, and added fixes so the output looked as good as on 
the tty.
For each option, I had to use:

‑  U+2011   NON-BREAKING HYPHEN
   U+2060   WORD JOINER
⁠
‑ U+2011 NON-BREAKING HYPHEN ‑ as option flag(s), instead of normal \- 
output, followed by U+2060 WORD JOINER ⁠ to avoid breaks before the 
option character or in a long option.

If you wanted to avoid breaks within long options with multiple hyphenated 
words, you would have to use the same character sequence instead of hyphens.

Similarly, to avoid breaks between alternatives within brackets, vertical bars 
or other punctuation needs to be followed by ⁠ to keep as one word e.g.

*-a*|*--all*
[<b>&#x2011;&#x2060;a</b>|&#x2060;<b>&#x2011;&#x2011;all</b>]

*-c*|*--outputencoding* /outputencoding/
[<b>&#x2011;&#x2060;c</b>|&#x2060;<b>&#x2011;&#x2011;outputencoding&nbsp;</b><i>outputencoding</i>]

--
Take care. Thanks, Brian Inglis              Calgary, Alberta, Canada

La perfection est atteinte                   Perfection is achieved
non pas lorsqu'il n'y a plus rien à ajouter  not when there is no more to add
mais lorsqu'il n'y a plus rien à retirer     but when there is no more to cut
                                -- Antoine de Saint-Exupéry

xlsx2csv.1
Description: Text document