DOC: clean up autogenerated API docs

* start with module summary
* remove extra headings

Author: pavoljuhas

doc/manual/source/api/diffpy.utils.parsers.rst

@@ -1,8 +1,10 @@
 diffpy.utils.parsers package
 ============================
 
-Submodules
-----------
+.. automodule:: diffpy.utils.parsers
+    :members:
+    :undoc-members:
+    :show-inheritance:
 
 diffpy.utils.parsers.loaddata module
 ------------------------------------
@@ -19,12 +21,3 @@ diffpy.utils.parsers.resample module
     :members:
     :undoc-members:
     :show-inheritance:
-
-
-Module contents
----------------
-
-.. automodule:: diffpy.utils.parsers
-    :members:
-    :undoc-members:
-    :show-inheritance:

doc/manual/source/api/diffpy.utils.rst

@@ -1,6 +1,13 @@
+:tocdepth: 2
+
 diffpy.utils package
 ====================
 
+.. automodule:: diffpy.utils
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
 Subpackages
 -----------
 
@@ -19,12 +26,3 @@ diffpy.utils.version module
     :members:
     :undoc-members:
     :show-inheritance:
-
-
-Module contents
----------------
-
-.. automodule:: diffpy.utils
-    :members:
-    :undoc-members:
-    :show-inheritance:

doc/manual/source/api/diffpy.utils.wx.rst

@@ -1,22 +1,15 @@
 diffpy.utils.wx package
 =======================
 
-Submodules
-----------
-
-diffpy.utils.wx.gridutils module
---------------------------------
-
-.. automodule:: diffpy.utils.wx.gridutils
+.. automodule:: diffpy.utils.wx
     :members:
     :undoc-members:
     :show-inheritance:
 
+diffpy.utils.wx.gridutils module
+--------------------------------
 
-Module contents
----------------
-
-.. automodule:: diffpy.utils.wx
+.. automodule:: diffpy.utils.wx.gridutils
     :members:
     :undoc-members:
     :show-inheritance:

doc/manual/source/index.rst

@@ -40,7 +40,11 @@ Table of contents
 
    license
    release
-   api/diffpy.utils.rst
+   Package API <api/diffpy.utils>
+
+======================================
+Indices
+======================================
 
 * :ref:`genindex`
 * :ref:`search`