Module docs are not generated

since the pbr section setup.cfg is not defined the module docs
are not being output.  This is also causing dead links in the
driver [0]. Since there is an empty section in the docs [1]
also show the module docs there for ease of use.

[0] http://docs.openstack.org/developer/glance_store/drivers/index.html#indices-and-tables
[1] http://docs.openstack.org/developer/glance_store/index.html#contents

Closes-Bug: #1554689
Change-Id: Ia0a81bf9514be1cdd2310c3ec0385470e8f33d51

doc/source/conf.py

@@ -49,6 +49,8 @@ html_static_path = ['static']
 # Output file base name for HTML help builder.
 htmlhelp_basename = '%sdoc' % project
 
+modindex_common_prefix = ['glance_store.']
+
 git_cmd = ["git", "log", "--pretty=format:'%ad, commit %h'", "--date=local",
            "-n1"]
 html_last_updated_fmt = subprocess.Popen(git_cmd,

doc/source/index.rst

@@ -4,12 +4,14 @@ glance_store
 The glance_store library supports the creation, deletion and gather of data
 assets from/to a set of several, different, storage technologies.
 
-Contents
-========
+glance_store Manual Pages
+=========================
 
 .. toctree::
    :maxdepth: 1
 
+* :ref:`modindex`
+
 Store Drivers
 =============
 

setup.cfg

@@ -72,6 +72,9 @@ source-dir = doc/source
 build-dir = doc/build
 all_files = 1
 
+[pbr]
+autodoc_tree_index_modules = True
+
 [upload_sphinx]
 upload-dir = doc/build/html