Warnings and errors when generating docs

[Tom Cocozzello]

There are many warnings and errors when docs are generated.

This can be be reproduced by `tox -e docs`

/home/tom/Documents/python-glanceclient/glanceclient/v2/metadefs.py:docstring of glanceclient.v2.metadefs.NamespaceController.list:14: WARNING: Field list ends without a blank line; unexpected unindent.
/home/tom/Documents/python-glanceclient/glanceclient/v2/tasks.py:docstring of glanceclient.v2.tasks.Controller.list:4: WARNING: Field list ends without a blank line; unexpected unindent.
looking for now-outdated files... none found
pickling environment... done
checking consistency... /home/tom/Documents/python-glanceclient/doc/source/apiv2.rst:: WARNING: document isn't included in any toctree
/home/tom/Documents/python-glanceclient/doc/source/man/glance.rst:: WARNING: document isn't included in any toctree

/home/tom/Documents/python-glanceclient/glanceclient/v2/metadefs.py:docstring of glanceclient.v2.metadefs.NamespaceController.list:14: WARNING: Field list ends without a blank line; unexpected unindent.
/home/tom/Documents/python-glanceclient/glanceclient/v2/tasks.py:docstring of glanceclient.v2.tasks.Controller.list:4: WARNING: Field list ends without a blank line; unexpected unindent.
looking for now-outdated files... none found

checking consistency... /home/tom/Documents/python-glanceclient/doc/source/apiv2.rst:: WARNING: document isn't included in any toctree
/home/tom/Documents/python-glanceclient/doc/source/man/glance.rst:: WARNING: document isn't included in any toctree

[OpenStack Infra (hudson-openstack)]

Fix proposed to branch: master
Review: https://review.openstack.org/293724

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.openstack.org/293724
Committed: https://git.openstack.org/cgit/openstack/python-glanceclient/commit/?id=c6904d033265a61143a7fa39a0108741ba3856ff
Submitter: Jenkins
Branch: master

commit c6904d033265a61143a7fa39a0108741ba3856ff
Author: Tom Cocozzello <email address hidden>
Date: Wed Mar 16 16:34:46 2016 -0500

    Docs are generated incorrectly

    When docs are generated with pbr command 'warnerrors = True'
    there are many doc problems that are shown. This patch fixes
    these problems.

    Change-Id: Idb804ab924782b6d7d379494987bdba2acbce568
    Closes-Bug: #1557235

[Doug Hellmann (doug-hellmann)]

This issue was fixed in the openstack/python-glanceclient 2.1.0 release.