diff --git a/AUTHORS.txt b/AUTHORS.txt index ec4f5c91c..fcd1240dd 100644 --- a/AUTHORS.txt +++ b/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 diff --git a/docs/news.txt b/docs/news.txt index e19f26e5b..2cc1b06a5 100644 --- a/docs/news.txt +++ b/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) diff --git a/docs/usage.txt b/docs/usage.txt index 02309f2d6..ea3323a93 100644 --- a/docs/usage.txt +++ b/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 -------