pip/docs/index.txt

pip
===

pip is a tool for installing and managing Python packages, such as those
found in the `Python Package Index <http://pypi.python.org/pypi>`_.

pip is a replacement for `easy_install
<http://peak.telecommunity.com/DevCenter/EasyInstall>`_.  It mostly
uses the same techniques for finding packages, so packages that are
easy_installable should be pip-installable as well.  This means that
you can use ``pip install SomePackage`` instead of ``easy_install
SomePackage``.

In order to use pip, you must first install `setuptools
<http://pypi.python.org/pypi/setuptools>`_ or `distribute
<http://pypi.python.org/pypi/distribute>`_.  If you use `virtualenv
<http://www.virtualenv.org>`_, a copy of pip will be automatically be
installed in each virtual environment you create.

.. comment: split here

.. toctree::
   :maxdepth: 1

   news
   installing
   usage
   requirements
   configuration
   other-tools
   contributing

.. comment: split here

Community
---------

The homepage for pip is at `pip-installer.org <http://www.pip-installer.org/>`_.
Bugs can be filed in the `pip issue tracker
<https://github.com/pypa/pip/issues/>`_.  Discussion happens on the
`virtualenv email group
<http://groups.google.com/group/python-virtualenv?hl=en>`_.