[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

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

From: Brian Inglis
Subject: man page .SY/.YS synopsis .OP HTML output breaks long options between hyphens
Date: Thu, 16 Mar 2023 19:39:27 -0600
User-agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:102.0) Gecko/20100101 Thunderbird/102.9.0

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


*-c*|*--outputencoding* /outputencoding/

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

Attachment: xlsx2csv.1
Description: Text document

reply via email to

[Prev in Thread] Current Thread [Next in Thread]