authors, changelog, and docs for 'pip list'

AUTHORS.txt

@@ -14,6 +14,7 @@ Clay McClure
 Cody Soyland
 Daniel Holth
 Dave Abrahams
+Dmitry Gladkov
 Donald Stufft
 Francesco
 Georgi Valkov
@@ -38,6 +39,7 @@ Marcus Smith
 Markus Hametner
 Matt Maker
 Maxime R.
+Miguel Araujo
 Nick Stenning
 Nowell Strite
 Oliver Tonnhofer

docs/news.txt

@@ -14,6 +14,9 @@ Beta and final releases planned for the end of 2012.
 develop (unreleased)
 --------------------
 
+* Added "pip list" for listing installed packages and the latest version
+  available. Thanks Rafael Caricio, Miguel Araujo, Dmitry Gladkov (Pull #752)
+
 * Split help output into general vs command-specific option groups.
   Thanks Georgi Valkov. (Pull #744; Pull #721 contains preceding refactor)
 

docs/usage.txt

@@ -134,8 +134,37 @@ old version of the package is automatically restored if the new version
 fails to download or install.
 
 
-Searching for packages
+List installed packages
-----------------------
+--------------------------
+
+To list installed packages::
+
+    $ pip list
+
+To only list editables::
+
+    $ pip list --editable
+
+To list outdated packages (excluding editables), and the latest version available::
+
+    $ pip list --outdated
+
+To list uptodate packages (excluding editables)::
+
+    $ pip list --uptodate
+
+
+Show package status
+-------------------
+
+To get info about an installed package, including its location and included
+files::
+
+    $ pip show SomePackage
+
+
+Search for packages
+-------------------
 
 pip can search :term:`PyPI` for packages using the ``pip search``
 command::
@@ -147,13 +176,6 @@ packages. With the ``--index`` option you can search in a different
 repository.
 
 
-Checking installed package status
----------------------------------
-
-To get info about an installed package, including its location and included
-files, run ``pip show ProjectName``.
-
-
 Bundles
 -------