Improve documentation build

Fix some problems found during documentation build:
* Remove reference to obsolete files
* Fix warning about too short title underlining
* Include api reference in index page
* Include man page in index page
* We have no _static files, so don't set the config option for it
* Fix reference for tests.share

Change-Id: I798d1ab65184689d75c559de9bffdf5969b9f013

doc/source/conf.py

@@ -164,7 +164,7 @@ html_theme_options = {'incubating': True}
 # Add any paths that contain custom static files (such as style sheets) here,
 # relative to this directory. They are copied after the builtin static files,
 # so a file named "default.css" will overwrite the builtin "default.css".
-html_static_path = ['_static']
+#html_static_path = ['_static']
 
 # If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
 # using the given strftime format.

doc/source/devref/auth.rst

@@ -31,7 +31,7 @@ The :mod:`manila.quota` Module
     :show-inheritance:
 
 The :mod:`manila.policy` Module
-------------------------------
+-------------------------------
 
 .. automodule:: manila.policy
     :noindex:

doc/source/devref/database.rst

@@ -46,15 +46,6 @@ The :mod:`manila.db.sqlalchemy.models` Module
     :undoc-members:
     :show-inheritance:
 
-The :mod:`manila.db.sqlalchemy.session` Module
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-.. automodule:: manila.db.sqlalchemy.session
-    :noindex:
-    :members:
-    :undoc-members:
-    :show-inheritance:
-
 
 Tests
 -----

doc/source/devref/share.rst

@@ -39,19 +39,3 @@ The :mod:`manila.share.driver` Module
     :undoc-members:
     :show-inheritance:
     :exclude-members: FakeAOEDriver
-
-Tests
------
-
-The :mod:`test_share` Module
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-.. automodule:: manila.tests.test_share
-    :noindex:
-    :members:
-    :undoc-members:
-    :show-inheritance:
-
-
-
-

doc/source/index.rst

@@ -42,6 +42,8 @@ Developer Docs
    :maxdepth: 1
 
    devref/index
+   man/index
+   api/autoindex
 
 API Extensions
 ==============

doc/source/man/index.rst

@@ -0,0 +1,11 @@
+Command-Line Utilities
+======================
+
+In this section you will find information on Manila's command-line utilities.
+
+Reference
+---------
+.. toctree::
+   :maxdepth: 3
+
+   manila-manage