pypa/pip — pull request #743 by gvalkov (2012-12-09 22:30:19+00:00)
Title: CLI Look and Feel

These changes attempt to improve the overall look and feel of pip's command line interface. They fall into the following categories:

- Group related options into `optparse.OptionGroups`.
- Reword help messages for clarity and brevity.
- Prevent excessive word wrap.
- Iron out any inconsistencies.

I'm sending this pull request in early with the hopes that a healthy discussion will form around it. So far, I've 'converted' `pip help` and `pip help install`. Their current outputs looks like [this](https://gist.github.com/4247261#file_gistfile1.txt).

Some points worth commenting on:

- Upper vs lower case everything.
- What to do with very long help messages (`--editable`, `--proxy` etc). One option is to put more verbose help info in the epilog of the command's option parser.

I'd really like to hear everyone's troughs and suggestion, before I carry on working on this. Oh, and English isn't my first language, so no surprise if some of the things I've 'reworded' turned out worse :)