When running tox -e docs, the following warnings are produced:
/opt/stack/python-keystoneclient/doc/source/api/keystoneclient.rst:7: WARNING: missing attribute mentioned in :members: or __all__: module keystoneclient.__init__, attribute generic
/opt/stack/python-keystoneclient/doc/source/api/keystoneclient.rst:7: WARNING: missing attribute mentioned in :members: or __all__: module keystoneclient.__init__, attribute v2_0
/opt/stack/python-keystoneclient/doc/source/api/keystoneclient.rst:7: WARNING: missing attribute mentioned in :members: or __all__: module keystoneclient.__init__, attribute v3
/opt/stack/python-keystoneclient/doc/source/api/keystoneclient.rst:7: WARNING: missing attribute mentioned in :members: or __all__: module keystoneclient.__init__, attribute access
/opt/stack/python-keystoneclient/doc/source/api/keystoneclient.rst:7: WARNING: missing attribute mentioned in :members: or __all__: module keystoneclient.__init__, attribute client
/opt/stack/python-keystoneclient/doc/source/api/keystoneclient.rst:7: WARNING: missing attribute mentioned in :members: or __all__: module keystoneclient.__init__, attribute exceptions
/opt/stack/python-keystoneclient/doc/source/api/keystoneclient.rst:7: WARNING: missing attribute mentioned in :members: or __all__: module keystoneclient.__init__, attribute httpclient
/opt/stack/python-keystoneclient/doc/source/api/keystoneclient.rst:7: WARNING: missing attribute mentioned in :members: or __all__: module keystoneclient.__init__, attribute service_catalog
/opt/stack/python-keystoneclient/keystoneclient/service_catalog.py:docstring of keystoneclient.service_catalog.ServiceCatalog.url_for:17: WARNING: Field list ends without a blank line; unexpected unindent.
/opt/stack/python-keystoneclient/doc/source/api/keystoneclient.apiclient.rst:7: WARNING: missing attribute mentioned in :members: or __all__: module keystoneclient.apiclient, attribute exceptions
/opt/stack/python-keystoneclient/keystoneclient/openstack/common/apiclient/auth.py:docstring of keystoneclient.openstack.common.apiclient.auth.BaseAuthPlugin.token_and_endpoint:7: ERROR: Unexpected indentation.
/opt/stack/python-keystoneclient/keystoneclient/openstack/common/apiclient/base.py:docstring of keystoneclient.openstack.common.apiclient.base.HookableMixin.run_hooks:5: WARNING: Inline strong start-string without end-string.
/opt/stack/python-keystoneclient/keystoneclient/openstack/common/apiclient/base.py:docstring of keystoneclient.openstack.common.apiclient.base.HookableMixin.run_hooks:6: WARNING: Inline strong start-string without end-string.
/opt/stack/python-keystoneclient/keystoneclient/openstack/common/apiclient/client.py:docstring of keystoneclient.openstack.common.apiclient.client.HTTPClient:5: ERROR: Unexpected indentation.
/opt/stack/python-keystoneclient/keystoneclient/openstack/common/apiclient/client.py:docstring of keystoneclient.openstack.common.apiclient.client.HTTPClient:6: WARNING: Block quote ends without a blank line; unexpected unindent.
/opt/stack/python-keystoneclient/keystoneclient/openstack/common/apiclient/client.py:docstring of keystoneclient.openstack.common.apiclient.client.HTTPClient.client_request:11: WARNING: Block quote ends without a blank line; unexpected unindent.
/opt/stack/python-keystoneclient/keystoneclient/openstack/common/apiclient/client.py:docstring of keystoneclient.openstack.common.apiclient.client.HTTPClient.request:9: WARNING: Block quote ends without a blank line; unexpected unindent.
/opt/stack/python-keystoneclient/keystoneclient/v3/contrib/trusts.py:docstring of keystoneclient.v3.contrib.trusts.TrustManager.create:9: ERROR: Unexpected indentation.
The trust and service catalog ones should be easy to fix, but we would have to fix the ones in oslo and then update keystoneclient.
The fix for the oslo-incubator doc build issues are here: https:/ /review. openstack. org/#/c/ 73879/