Hum, the same goes for output-path vs. output-dir .. not sure which way to go? ofc i'd like to change both, the main question .. to ..-path or ..-dir which one do you like more @zircote @bfanger ?

Some thoughts on the CLI parameters:

• Remove "-path" and "-dir" from the options go with just "--output", "--exclude", etc.
• Remove the --project option. Example: $ swagger.phar /path/to/my-project/ -o docs
• Rename -f --format to "--pretty-print" to avoid confusion (I associate -f with force and format with xml/json)
• Rename -i --include to "-b --bootstrap" to avoid confusion with the sematics of the -exclude option.

What do you think?

I agree with and support all of these.

I've changed the cli parameters in the 0.7 branch (as it's a breaking change)
Testing and feedback is appreciated.

But I think 0.7 needs more features (like #90) before releasing it as 0.7.0