Document --terminal-width=0 vs --wrap=never

[luckydonald]

I tried having it to not wrap.
But --terminal-width=0 results in a never ending loop of empty lines.
I later learned that --wrap=never was there, but maybe --terminal-width=0 could imply no wrapping.

In any way, I'd recommend including a mention of --wrap and --terminal-width into the comment of each others at the help output.

  --wrap <mode>                 
              Specify the text-wrapping mode (*auto*, never, character).
+             See '--terminal-width' to set when to wrap.
  --terminal-width <width>      
              Explicitly set the width of the terminal instead of determining it automatically. If
              prefixed with '+' or '-', the value will be treated as an offset to the actual terminal
-             width.
+             width. This controls when text should wrap, see  '--wrap'.

[sharkdp]

Thank you for reporting this.

The endless-loop should definitely be fixed.

What would --terminal-width=0 imply for decorations such as the grid? Does it really make sense to allow for width 0 or should we disallow it and improve the documentation, as you suggested?

[luckydonald]

Yeah probably adding references in the --help command and making it burp with a "did you mean" would be a cleaner solution.

[sharkdp]

Closed via #559 by @eth-p.

[luckydonald]

Does it refer to wrap=never now?

[eth-p]

The documentation still needs to be updated, but it makes --terminal-width=0 an explicit error now.

[luckydonald]

Can we keep this open please, until we get the documentation done?