Use a separate doc requirements file

As per the OpenStack TC decision [1], the doc requirements should
be listed separately.

This also simplifies the requirements handling. At them moment,
we're facing some issues due to conflicting doc related lower
constraints.

[1] https://governance.openstack.org/tc/reference/project-testing-interface.html

Change-Id: Ifa2d545d1be6615bca1a85c471322c7e9a3da3b3

lower-constraints.txt

@@ -1,6 +1,4 @@
-alabaster==0.7.10
 appdirs==1.4.3
-Babel==2.3.4
 certifi==2018.1.18
 cffi==1.11.5
 chardet==3.0.4
@@ -9,8 +7,6 @@ cmd2==0.8.1
 coverage==4.0
 ddt==1.0.1
 debtcollector==1.19.0
-docutils==0.14
-dulwich==0.19.0
 enum-compat==0.0.2
 eventlet==0.18.2
 extras==1.0.0
@@ -18,7 +14,6 @@ fasteners==0.14.1
 fixtures==3.0.0
 greenlet==0.4.13
 idna==2.6
-imagesize==1.0.0
 iso8601==0.1.12
 Jinja2==2.10
 keystoneauth1==3.4.0
@@ -30,7 +25,6 @@ mox3==0.25.0
 msgpack==0.5.6
 netaddr==0.7.19
 netifaces==0.10.6
-openstackdocstheme==2.2.1
 os-brick==2.2.0
 os-client-config==1.29.0
 os-win==5.2.0
@@ -49,7 +43,6 @@ PasteDeploy==1.5.2
 pbr==2.0.0
 prettytable==0.7.2
 pycparser==2.18
-Pygments==2.2.0
 pyinotify==0.9.6
 pyparsing==2.2.0
 pyperclip==1.6.0
@@ -59,7 +52,6 @@ python-mimeparse==1.6.0
 python-subunit==1.0.0
 pytz==2018.3
 PyYAML==3.12
-reno==3.1.0
 repoze.lru==0.7
 requests==2.18.4
 requestsexceptions==1.4.0
@@ -68,8 +60,6 @@ rfc3986==1.1.0
 Routes==2.4.1
 six==1.11.0
 snowballstemmer==1.2.1
-Sphinx==2.0.0
-sphinxcontrib-websupport==1.0.1
 stestr==2.0.0
 stevedore==1.28.0
 testrepository==0.0.20

test-requirements.txt

@@ -8,15 +8,9 @@ coverage!=4.4,>=4.0 # Apache-2.0
 ddt>=1.0.1 # MIT
 mock>=3.0.0 # BSD
 python-subunit>=1.0.0 # Apache-2.0/BSD
-sphinx>=2.0.0,!=2.1.0 # BSD
-oslo.config>=5.2.0 # Apache-2.0
 oslotest>=3.2.0 # Apache-2.0
 stestr>=2.0.0 # Apache-2.0
 testtools>=2.2.0 # MIT
-openstackdocstheme>=2.2.1 # Apache-2.0
 
 # placement functional tests
 wsgi-intercept>=1.4.1 # MIT License
-
-# releasenotes
-reno>=3.1.0 # Apache-2.0

tox.ini

@@ -19,6 +19,7 @@ setenv = VIRTUAL_ENV={envdir}
 deps =
        -r{toxinidir}/requirements.txt
        -r{toxinidir}/test-requirements.txt
+       -r{toxinidir}/doc/requirements.txt
        -egit+https://github.com/openstack/nova#egg=nova
 commands =
   find . -type f -name "*.pyc" -delete
@@ -48,8 +49,7 @@ commands =
 commands = {posargs}
 
 [testenv:docs]
-deps =
-       -r{toxinidir}/test-requirements.txt
+deps = -r{toxinidir}/doc/requirements.txt
        -egit+https://github.com/openstack/nova#egg=nova
 commands =
   # We cannot use -W here since nova docs contain links to the nova tree