Switch to module-per-file for the module index.

Rename development guide to development reference.

doc/Makefile

@@ -33,11 +33,12 @@ help:
 clean:
 	-rm -rf $(BUILDDIR)/*
 	-rm -rf nova.sqlite
-	-rm $(SPHINXSOURCE)/code.rst
+	cat .autogenerated | xargs rm 
+	rm .autogenerated
 
 module_autodoc: generate_autodoc_index.sh
-	@echo "Generating module autodoc index."
+	@echo "Generating module autodocs."
-	./generate_autodoc_index.sh > $(SPHINXSOURCE)/code.rst
+	./generate_autodoc_index.sh
 
 source/code.rst: module_autodoc
 	@# pass

doc/generate_autodoc_index.sh

@@ -1,8 +1,19 @@
 #!/bin/sh
+SOURCEDIR=source
 
 for x in `./find_autodoc_modules.sh`;
 do
-  echo ".. automodule:: ${x}"
+  echo "Generating ${SOURCEDIR}/${x}.rst"
-  echo "  :members:"
+  echo "${SOURCEDIR}/${x}.rst" >> .autogenerated 
+  ( cat <<EOF
+The :mod:\`${x}\` Module
+=====================
+.. automodule:: ${x}
+  :members:
+  :undoc-members:
+  :show-inheritance:
+EOF
+) > ${SOURCEDIR}/${x}.rst
+
 done
 

doc/source/devref/index.rst

@@ -15,8 +15,8 @@
       License for the specific language governing permissions and limitations
       under the License.
 
-Nova Development Guide
+Nova Development Reference
-======================
+==========================
 
 Nova is written in python.
 
@@ -34,7 +34,7 @@ Contents
 --------
 
 .. toctree::
-   :maxdepth: 1
+   :maxdepth: 3
 
    services
    database

doc/source/index.rst

@@ -45,7 +45,7 @@ Contents
 
    concepts.and.introduction
    adminguide/index
-   devguide/index
+   devref/index
    reaching.out
 
 Recommended System Configuration