switch documentation job to new PTI

This is a mechanically generated patch to switch the documentation
jobs to use the new PTI versions of the jobs as part of the
python3-first goal.

See the python3-first goal document for details:
https://governance.openstack.org/tc/goals/stein/python3-first.html

Update tox.ini so that tox -e docs works. Remove function exectution
from documentation - the function section includes it, this caused a
duplicate section.

Story: #2002586
Task: #24326

Co-Authored-By: Andreas Jaeger <jaegerandi@gmail.com>
Co-Authored-By: Vieri <15050873171@163.com>
Change-Id: I8604aba14b4e9c35e446e53d997f63d12a65e199

.zuul.yaml

@@ -4,8 +4,8 @@
       - openstack-python35-jobs
       - openstack-python36-jobs
       - check-requirements
-      - publish-openstack-sphinx-docs
-      - release-notes-jobs
+      - publish-openstack-docs-pti
+      - release-notes-jobs-python3
       - openstackclient-plugin-jobs
     check:
       jobs:

doc/source/cli/index.rst

@@ -1 +1,2 @@
+
 .. include:: osc/v1/qinling.rst

doc/source/cli/osc/v1/qinling.rst

@@ -15,13 +15,6 @@ function
 .. autoprogram-cliff:: openstack.function_engine.v1
     :command: function *
 
-==================
-function execution
-==================
-
-.. autoprogram-cliff:: openstack.function_engine.v1
-    :command: function execution *
-
 ===
 job
 ===

doc/source/index.rst

@@ -1,8 +1,3 @@
-.. python-qinlingclient documentation master file, created by
-   sphinx-quickstart on Tue Jul  9 22:26:36 2013.
-   You can adapt this file completely to your liking, but it should at least
-   contain the root `toctree` directive.
-
 Python Qinling Client
 =====================
 

tox.ini

@@ -42,9 +42,11 @@ commands =
 [testenv:docs]
 basepython = python3
 whitelist_externals = rm
+deps = -r{toxinidir}/doc/requirements.txt
 commands =
   rm -rf doc/build
-  python setup.py build_sphinx
+  sphinx-build -E -W -b html doc/source doc/build/html
+
 
 [testenv:debug]
 basepython = python3