Add tox -e api-ref CLI

Closes-Bug: #1989110

Change-Id: I2063f51a38daf74c1e493b334e78045b3dd99d7b

api-ref/source/conf.py

@@ -58,6 +58,7 @@ html_theme_options = {
 # (source start file, target name, title, author, documentclass
 # [howto/manual]).
 latex_documents = [
-    ('index', 'Venus.tex', u'OpenStack Log API Documentation',
+    ('index', 'Venus.tex',
+     u'OpenStack Log Management Service API Documentation',
      u'OpenStack Foundation', 'manual'),
 ]

tox.ini

@@ -66,6 +66,18 @@ commands =
     rm -rf doc/build/html
     sphinx-build -W -b html doc/source doc/build/html
 
+[testenv:api-ref]
+description =
+  Generate the API ref. Called from CI scripts to test and publish to docs.openstack.org.
+# This environment is called from CI scripts to test and publish
+# the API Ref to docs.openstack.org.
+envdir = {toxworkdir}/docs
+deps = {[testenv:docs]deps}
+commands =
+  rm -rf api-ref/build
+  sphinx-build -W -b html -d api-ref/build/doctrees api-ref/source api-ref/build/html
+allowlist_externals = rm
+
 [flake8]
 # Following checks are ignored on purpose.
 #