Cleanup docs building

a few cleanups:
- Remove obsolete sections from setup.cfg
- Switch to using sphinx-build
- Remove install_command from tox.ini, the default is fine
- Update pbr requirements
- Fix problems, mainly "Could not lex literal block"
- Use py38 job for Victoria cycle

Change-Id: Id706786bed4b20682704d524986850b7c71e225d

.zuul.yaml

@@ -3,7 +3,7 @@
       - openstack-specs-jobs
     check:
       jobs:
-        - openstack-tox-py37
+        - openstack-tox-py38
     gate:
       jobs:
-        - openstack-tox-py37
+        - openstack-tox-py38

requirements.txt

@@ -1,4 +1,4 @@
-pbr>=0.6,<1.0
+pbr!=2.1.0,>=2.0.0 # Apache-2.0
 openstackdocstheme>=2.2.1 # Apache-2.0
 sphinx>=2.0.0,!=2.1.0 # BSD
 yasfb>=0.8.0

setup.cfg

@@ -11,14 +11,3 @@ classifier =
     Intended Audience :: Developers
     License :: OSI Approved :: Apache Software License
     Operating System :: POSIX :: Linux
-
-[build_sphinx]
-source-dir = doc/source
-build-dir = doc/build
-all_files = 1
-
-[pbr]
-warnerrors = True
-
-[upload_sphinx]
-upload-dir = doc/build/html

specs/backlog/resource-capabilities.rst

@@ -275,7 +275,7 @@ For example, given the :ref:`Puppet <capabilities-ex-puppet>` and
 
 Which would return:
 
-.. code-block:: json
+.. code-block::
 
   {
     'deployment': ['puppet', 'docker']
@@ -284,7 +284,7 @@ Which would return:
 A similar version of the call exists if the
 :ref:`capabilities-annotation-type` annotation is used:
 
-.. code-block:: json
+.. code-block::
 
   {
     'OS::TripleO::Controller': ['puppet/controller.yaml',

specs/mitaka/mistral-wf-signal-json-format.rst

@@ -24,7 +24,7 @@ or even from ceilometer, the signaling request may have a predefined body,
 which is not compatible with the json format expected by the workflow resource.
 The os::mistral::workflow expects the body to be in this format:
 
-.. code-block:: json
+.. code-block::
 
     {
         "input":{
@@ -37,7 +37,7 @@ The os::mistral::workflow expects the body to be in this format:
 
 however, ceilometer, for example, sends this body in the request:
 
-.. code-block:: json
+.. code-block::
 
     {
          "severity": "low",
@@ -134,4 +134,4 @@ Work Items
 
 Dependencies
 ============
-None
+None

specs/newton/cinder-quota-resource.rst

@@ -119,7 +119,7 @@ template:
 We will add a default policy rule for this resource to be limited to
 administrators.
 
-.. code-block:: json
+.. code-block::
 
   "resource_types:OS::Cinder::Quota": "rule:project_admin"
 

specs/ocata/neutron-quota-resource.rst

@@ -165,7 +165,7 @@ template:
 A default policy rule will be added for this resource to be limited to
 administrators.
 
-.. code-block:: json
+.. code-block::
 
   "resource_types:OS::Neutron::Quota": "rule:project_admin"
 

specs/ocata/nova-quota-resource.rst

@@ -179,7 +179,7 @@ updated. Otherwise, the project's quota will be updated.
 A default policy rule will be added for this resource to be limited to
 administrators.
 
-.. code-block:: json
+.. code-block::
 
   "resource_types:OS::Nova::Quota": "rule:project_admin"
 

tox.ini

@@ -6,7 +6,6 @@ skipsdist = True
 [testenv]
 basepython = python3
 usedevelop = True
-install_command = pip install -U {opts} {packages}
 setenv =
    VIRTUAL_ENV={envdir}
 deps = -r{toxinidir}/requirements.txt
@@ -20,7 +19,7 @@ commands =
 commands = {posargs}
 
 [testenv:docs]
-commands = python setup.py build_sphinx
+commands = sphinx-build -W -a -b html doc/source doc/build/html
 
 [testenv:spelling]
 deps =