Use pypi role to refer to packages in docs.

JNRowe · JNRowe · commit 41de1bbb42e3 · 2011-05-22T07:47:34.000+01:00
diff --git a/doc/contributing.rst b/doc/contributing.rst
@@ -32,13 +32,13 @@ Tests
    Unfortunately there aren't many tests for ``python-github`` at the moment,
    any patches to increase test coverage are greatly appreciated
 
-The preferred way to run the package's tests is with nose_.  ``nosetests``
-provides excellent reporting options and its additional features make it
-invaluable, see the nose_ documentation for usage information.
+The preferred way to run the package's tests is with :pypi:`nose`.
+``nosetests`` provides excellent reporting options and its additional features
+make it invaluable, see the nose_ documentation for usage information.
 
-There is a tox_ configuration file included in the repository, you can use it to
-run the tests against multiple Python versions with a single command.  The
-configuration file also includes targets for testing the documentation.  The
+There is a :pypi:`tox` configuration file included in the repository, you can
+use it to run the tests against multiple Python versions with a single command.
+The configuration file also includes targets for testing the documentation.  The
 tox_ documentation includes a fantastic number of examples on how to use it, and
 advice on adding new testing targets.
 
diff --git a/doc/install.rst b/doc/install.rst
@@ -4,12 +4,12 @@ Installation
 You can install :mod:`github2` either via the Python Package Index (PyPI) or
 from source.
 
-To install using ``pip``::
+To install using :pypi:`pip`::
 
     $ pip install github2  # to install in Python's site-packages
     $ pip install --install-option="--user" github2  # to install for a single user
 
-To install using ``easy_install``::
+To install using :pypi:`easy_install <setuptools>`::
 
     $ easy_install github2
 
@@ -20,8 +20,9 @@ following::
     # python setup.py install  # to install in Python's site-packages
     $ python setup.py install --user  # to install for a single user
 
-:mod:`github2` depends on :pypi:`httplib2`, an excellent package by Joe
-Gregorio for handling HTTP sessions.  :pypi:`simplejson` is also required when
-using :mod:`github2` with Python 2.4 or 2.5.  If you install via ``pip`` or
-``easy_install`` the dependencies should be installed automatically for you.
-:pypi:`SocksiPy-branch` is an optional dependency if proxy support is needed.
+:mod:`github2` depends on :pypi:`httplib2`, an excellent package by Joe Gregorio
+for handling HTTP sessions.  :pypi:`simplejson` is also required when using
+:mod:`github2` with Python 2.4 or 2.5.  If you install via :pypi:`pip` or
+:pypi:`easy_install <setuptools>` the dependencies should be installed
+automatically for you.  :pypi:`SocksiPy-branch` is an optional dependency if
+proxy support is needed.
