[pypy-dev] Reducing Sphinx doc verbosity on command line help

[anatoly techtonik]

I find that documentation for pip is hard to read,
because it contains too much filler whitespace
and repeated obvious headings.

Take this as example:
http://www.pip-installer.org/en/latest/usage.html#pip-show

-----[cut now]-------------------------
pip show
Usage <http://www.pip-installer.org/en/latest/usage.html#id18>

pip show [options] <package> ...

Description

Show information about one or more installed packages.
 Options

*Show Options:*

-f, --files

Show the full list of installed files for each package.

*Other Options:*

   - *General Options*<http://www.pip-installer.org/en/latest/usage.html#general-options>

Examples

   1. Show information about a package:


$ pip show sphinx
---
Name: Sphinx
Version: 1.1.3
Location: /my/env/lib/pythonx.x/site-packages
Requires: Pygments, Jinja2, docutils

-----[cut proposed]-----------------------------
pip show

pip show [options] <package> ...

Show information about one or more installed packages.
 Options

-f, --files      Show the full list of installed files for each package.

*Examples*
*Show information about a package (html anchor)*


$ pip show sphinx
---
Name: Sphinx
Version: 1.1.3
Location: /my/env/lib/pythonx.x/site-packages
Requires: Pygments, Jinja2, docutils

--
anatoly t.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/pypy-dev/attachments/20140114/c91220f3/attachment.html>