Ability to display regular line breaks in help about click

[mitsuhiko]

I had the initial plan to do what markdown does and to support two trailing spaces or more to indicate a mandatory break but it warns in too many editors for trailing whitespace. Maybe I should instead detect certain syntax patterns.

I'm happy for any ideas of how to tackle this.

[fgimian]

Hey Armin, thanks for your reply 😄

Yeah, trailing spaces was my initial idea too but that also makes code fail flake8 compatibility and some editors strip the extra space for you as you said.

The only idea I've had so far (which i'm not totally happy with) is to follow the Sphinx convention, e.g.:

@click.command()
def hello():
    """Here's some help information and here is a little list of things
    you can do:

    | - a
    | - b
    | - c

    Have a nice day
    """
    click.echo('Hi there')

However, I'm just not so convinced about this idea. I'll see if I can think of any other more elegant solutions.

Cheers
Fotis

[mitsuhiko]

Found something I am quite happy with: http://click.pocoo.org/documentation/#preventing-rewrapping

[fgimian]

Thanks heaps Armin! 😄