fix docs/links for 1.14.0 release

This patch addresses the following issues in prep for the neutron-lib
1.14.0 release:
- Updates the tox linkcheck target to get it working.
- Removes the glob for modules/* in doc/source/reference/index.rst as
this causes local build errors when not finding anything with the glob.
- Fixes any issues found by running the linkcheck tox target.

Change-Id: I0e96068cd7b6733adc35503b40500b80692cfd6d

api-ref/source/v2/intro.inc

@@ -94,9 +94,9 @@ Query extension
 A ``.json`` extension can be added to the request URI. For example, the
 ``.json`` extension in the following requests are equivalent:
 
-    - ``GET`` *publicURL*/networks
+- GET *publicURL*/networks
 
-    - ``GET`` *publicURL*/networks.json
+- GET *publicURL*/networks.json
 
 Tenant and project attributes in responses
 ------------------------------------------

doc/source/reference/index.rst

@@ -25,9 +25,6 @@ Module Reference
 
 .. toctree::
    :maxdepth: 1
-   :glob:
-
-   modules/*
 
 * :ref:`genindex`
 * :ref:`search`

tox.ini

@@ -50,12 +50,15 @@ commands =
   sphinx-build -W -b html -d api-ref/build/doctrees api-ref/source api-ref/build/html
 
 [testenv:linkcheck]
+deps =
+  -c{env:UPPER_CONSTRAINTS_FILE:https://git.openstack.org/cgit/openstack/requirements/plain/upper-constraints.txt}
+  -r{toxinidir}/requirements.txt
+  -r{toxinidir}/doc/requirements.txt
 whitelist_externals = rm
 commands =
   rm -rf api-ref/build
   sphinx-build -W -b linkcheck api-ref/source api-ref/build/linkcheck
   rm -rf doc/build
-  python setup.py build_sphinx
   sphinx-build -W -b linkcheck doc/source doc/build/linkcheck
 
 [testenv:debug]