Use autoprogram-cliff for remaining plugin docs

Sphinx errors have been fixed in the plugin projects for octavia, rsd,
trove, watcher, and zun, so we can now use autoprogram-cliff to generate
the docs for those.

Change-Id: Ia7790c5e86957afd0aec8f9a04ffc7aa968b4eeb
Story: #1735016
Task: #37241

doc/requirements.txt

@@ -21,12 +21,12 @@ python-karborclient>=0.6.0 # Apache-2.0
 python-mistralclient!=3.2.0,>=3.1.0 # Apache-2.0
 python-muranoclient>=0.8.2 # Apache-2.0
 python-neutronclient>=6.7.0 # Apache-2.0
-python-octaviaclient>=1.3.0 # Apache-2.0
+python-octaviaclient>=1.11.0 # Apache-2.0
-python-rsdclient>=0.1.0 # Apache-2.0
+python-rsdclient>=1.0.1 # Apache-2.0
 python-saharaclient>=1.4.0 # Apache-2.0
 python-searchlightclient>=1.0.0 #Apache-2.0
 python-senlinclient>=1.1.0 # Apache-2.0
-python-troveclient>=2.2.0 # Apache-2.0
+python-troveclient>=3.1.0 # Apache-2.0
-python-watcherclient>=2.4.0 # Apache-2.0
+python-watcherclient>=2.5.0 # Apache-2.0
 python-zaqarclient>=1.0.0 # Apache-2.0
-python-zunclient>=3.4.0 # Apache-2.0
+python-zunclient>=3.6.0 # Apache-2.0

doc/source/cli/plugin-commands/octavia.rst

@@ -1,10 +1,4 @@
 octavia
 -------
 
-.. TODO(efried): cut over to autoprogram-cliff once doc build is fixed
+.. autoprogram-cliff:: openstack.load_balancer.v2
-
-For more details, see the :python-octaviaclient-doc:`python-octaviaclient
-plugin documentation </cli/index>`.
-
-.. list-plugins:: openstack.load_balancer.v2
-   :detailed:

doc/source/cli/plugin-commands/rsd.rst

@@ -1,7 +1,4 @@
 rsd
 ---
 
-.. TODO(efried): Cut over to autoprogram-cliff once rsd plugin docs build
+.. autoprogram-cliff:: openstack.rsd.v2
-
-.. list-plugins:: openstack.rsd.v1
-   :detailed:

doc/source/cli/plugin-commands/trove.rst

@@ -1,7 +1,4 @@
 trove
 -----
 
-.. TODO(efried): cut over to autoprogram-cliff once doc build is fixed
+.. autoprogram-cliff:: openstack.database.v1
-
-.. list-plugins:: openstack.database.v1
-   :detailed:

doc/source/cli/plugin-commands/watcher.rst

@@ -1,10 +1,4 @@
 watcher
 -------
 
-.. TODO(efried): cut over to autoprogram-cliff once doc build is fixed
+.. autoprogram-cliff:: openstack.infra_optim.v1
-
-For more details, see the :python-watcherclient-doc:`python-watcherclient
-plugin documentation </cli/openstack_cli>`.
-
-.. list-plugins:: openstack.infra_optim.v1
-   :detailed:

doc/source/cli/plugin-commands/zun.rst

@@ -1,10 +1,4 @@
 zun
 ---
 
-.. TODO(efried): cut over to autoprogram-cliff once doc build is fixed
+.. autoprogram-cliff:: openstack.container.v1
-
-For more details, see the :python-zunclient-doc:`python-zunclient plugin
-documentation </cli/command-list>`.
-
-.. list-plugins:: openstack.container.v1
-   :detailed:

doc/source/conf.py

@@ -34,11 +34,8 @@ extensions = ['sphinx.ext.autodoc',
 repository_name = 'openstack/python-openstackclient'
 use_storyboard = True
 
-openstack_projects = [
+# Add project 'foo' to this list to enable the :foo-doc: role
-    'python-octaviaclient',
+# openstack_projects = []
-    'python-watcherclient',
-    'python-zunclient',
-]
 
 # Add any paths that contain templates here, relative to this directory.
 #templates_path = ['_templates']

lower-constraints.txt

@@ -101,17 +101,17 @@ python-mistralclient==3.1.0
 python-muranoclient==0.8.2
 python-neutronclient==6.7.0
 python-novaclient==15.0.0
-python-octaviaclient==1.3.0
+python-octaviaclient==1.11.0
-python-rsdclient==0.1.0
+python-rsdclient==1.0.1
 python-saharaclient==1.4.0
 python-searchlightclient==1.0.0
 python-senlinclient==1.1.0
 python-subunit==1.0.0
 python-swiftclient==3.2.0
-python-troveclient==2.2.0
+python-troveclient==3.1.0
-python-watcherclient==2.4.0
+python-watcherclient==2.5.0
 python-zaqarclient==1.0.0
-python-zunclient==3.4.0
+python-zunclient==3.6.0
 pytz==2013.6
 PyYAML==3.12
 repoze.lru==0.7