Test that the documentation builds successfully

Author: dstufft

.travis.yml

@@ -2,6 +2,7 @@ language: python
 
 env:
   - TOXENV=collect
+  - TOXENV=docs
   - TOXENV=py26
   - TOXENV=py27
   - TOXENV=py32

docs/logic.rst

@@ -105,8 +105,7 @@ files without a hash, or files that are linked from either the home page or the
 download url of a package.
 
 In order to get the future behavior in v1.4 the ``pip install`` command
-supports a :ref:`--no-allow-external <--no-allow-external>` and
-:ref:`--no-allow-insecure <--no-allow-external>` flags.
+supports a ``--no-allow-external`` and ``--no-allow-insecure`` flags.
 
 .. _`VCS Support`:
 

tox.ini

@@ -1,6 +1,6 @@
 [tox]
 envlist =
-    collect,py26,py27,py32,py33,pypy
+    collect,docs,py26,py27,py32,py33,pypy
 
 [testenv]
 deps =
@@ -16,6 +16,12 @@ commands =
 commands =
     py.test --collectonly
 
+[testenv:docs]
+deps = sphinx
+basepython = python2.7
+commands =
+    sphinx-build -W -b html -d {envtmpdir}/doctrees docs docs/_build/html
+
 [testenv:py32]
 commands =
     py.test