fix(help): Don't wrap URLs

[epage]

Confusingly, there are two similar but slightly different settings in
textwrap. We need both set.

Fixes #3222

[mgeisler]

Confusingly, there are two similar but slightly different settings in textwrap. We need both set.

Hi @epage,

Yeah, the break_words setting is about (forcibly) breaking words which are too wide to fit on the line. The word_splitter setting is about finding legal split points inside words (e.g., for hyphenation).

If you like, you could use a custom word splitter which would detect URLs and not split on embedded hyphens — but which would still allow splitting at other hyphens. Let me know if you would be interested in that kind of functionality?

[epage]

Yeah, the break_words setting is about (forcibly) breaking words which are too wide to fit on the line. The word_splitter setting is about finding legal split points inside words (e.g., for hyphenation).

The issue was more so in seeing and using one, thinking that that was all that was needed.

[mgeisler]

The issue was more so in seeing and using one, thinking that that was all that was needed.

Yeah, I'm not sure the option names are the best, to be honest. I've considered renaming them to something like break_long_words and hyphenation instead to make their purpose more clear... Thanks for the feedback, these data points are useful!

[epage]

I think cross-linking them in the docs would be a big help.

[mgeisler]

Great idea, this is now done: mgeisler/textwrap#471 :-)