Building keystoneclient docs generates several warnings

[Steve Martinelli]

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.

[Brant Knudson (blk-u)]

The fix for the oslo-incubator doc build issues are here: https://review.openstack.org/#/c/73879/

[Openstack Gerrit (openstack-gerrit)]

Reviewed: https://review.openstack.org/91893
Committed: https://git.openstack.org/cgit/openstack/python-keystoneclient/commit/?id=8cf2829d536ed6a6fcaec91d090d4b04f74b96c0
Submitter: Jenkins
Branch: master

commit 8cf2829d536ed6a6fcaec91d090d4b04f74b96c0
Author: Steve Martinelli <email address hidden>
Date: Fri May 2 15:38:49 2014 -0500

    Fix docstrings in keystoneclient

    Trusts and service catalog had a few malformed docstrings
    that caused warnings when building docs.

    Change-Id: Iea8612c3aaebea54c00b02c73c77f0c9e79f86bc
    Partial-Bug: #1315523

[OpenStack Infra (hudson-openstack)]

Related fix proposed to branch: master
Review: https://review.openstack.org/95845

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.openstack.org/95845
Committed: https://git.openstack.org/cgit/openstack/python-keystoneclient/commit/?id=54cc999a4def0bcf6faef4da9bc2f7caf131044f
Submitter: Jenkins
Branch: master

commit 54cc999a4def0bcf6faef4da9bc2f7caf131044f
Author: Steve Martinelli <email address hidden>
Date: Tue May 27 13:53:58 2014 -0400

    Sync with oslo-incubator caed79d

    This syncs python-keystoneclient with oslo-incubator commit hash
    caed79d8239679cb74476bb0d9e5011b4fcc39da

    First, remove the existing code to cleanup:
     $ rm -r keystoneclient/openstack/*

    Then, sync from oslo-incubator:
     $ python update.py ../python-keystoneclient

    Commits since last sync (2640847):
    ----------------------------------
    1173e46 Remove ValueError when accessing sys.modules
    90ae24b Remove redundant default=None for config options
    18f2bc1 Enforce unicode json output for jsonutils.load[s]()
    4a777e5 Fix warnings in doc build for apiclient

    Related-Bug: #1315523
    Closes-Bug: #1314129
    Change-Id: Id53ea2d4828e81bc6270f186849f391e7bc73101

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.openstack.org/99745
Committed: https://git.openstack.org/cgit/openstack/python-keystoneclient/commit/?id=6659902a731767b3405d68e515c8edcc3af81119
Submitter: Jenkins
Branch: master

commit 6659902a731767b3405d68e515c8edcc3af81119
Author: Brant Knudson <email address hidden>
Date: Thu Jun 12 14:40:56 2014 -0500

    Imports to fix build warnings

    There were warnings generated during the build due to missing
    attributes, like this:

     keystoneclient.rst:7: WARNING: missing attribute mentioned in
       :members: or __all__: module keystoneclient.__init__, attribute
       v2_0

    This is fixed by importing the symbol in __init__.

    Closes-Bug: #1315523

    Change-Id: I565c78ef8910353c4e1ce1641b42fba7cdbd77d8