DOC: start API documents with package summary

Author: pavoljuhas

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

@@ -1,6 +1,13 @@
+:tocdepth: 2
+
 diffpy.srreal package
 =====================
 
+.. automodule:: diffpy.srreal
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
 Submodules
 ----------
 
@@ -164,12 +171,3 @@ diffpy.srreal.wraputils module
     :members:
     :undoc-members:
     :show-inheritance:
-
-
-Module contents
----------------
-
-.. automodule:: diffpy.srreal
-    :members:
-    :undoc-members:
-    :show-inheritance:

doc/manual/source/index.rst

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