update doc and api doc 1.1b1

Author: XiaohaoYang

Diff for: doc/manual/source/api/diffpy.rst

@@ -1,12 +1,17 @@
-diffpy Package
+diffpy package
 ==============
 
-:mod:`diffpy` Package
----------------------
-
 Subpackages
 -----------
 
 .. toctree::
 
     diffpy.utils
+
+Module contents
+---------------
+
+.. automodule:: diffpy
+    :members:
+    :undoc-members:
+    :show-inheritance:

Diff for: doc/manual/source/api/diffpy.utils.parsers.rst

@@ -1,26 +1,30 @@
-parsers Package
-===============
+diffpy.utils.parsers package
+============================
 
-:mod:`parsers` Package
-----------------------
+Submodules
+----------
 
-.. automodule:: diffpy.utils.parsers
+diffpy.utils.parsers.loaddata module
+------------------------------------
+
+.. automodule:: diffpy.utils.parsers.loaddata
     :members:
     :undoc-members:
     :show-inheritance:
 
-:mod:`loaddata` Module
-----------------------
+diffpy.utils.parsers.resample module
+------------------------------------
 
-.. automodule:: diffpy.utils.parsers.loaddata
+.. automodule:: diffpy.utils.parsers.resample
     :members:
     :undoc-members:
     :show-inheritance:
 
-:mod:`resample` Module
-----------------------
 
-.. automodule:: diffpy.utils.parsers.resample
+Module contents
+---------------
+
+.. automodule:: diffpy.utils.parsers
     :members:
     :undoc-members:
     :show-inheritance:

Diff for: doc/manual/source/api/diffpy.utils.rst

@@ -1,13 +1,5 @@
-utils Package
-=============
-
-:mod:`utils` Package
---------------------
-
-.. automodule:: diffpy.utils
-    :members:
-    :undoc-members:
-    :show-inheritance:
+diffpy.utils package
+====================
 
 Subpackages
 -----------
@@ -16,3 +8,23 @@ Subpackages
 
     diffpy.utils.parsers
     diffpy.utils.wx
+
+Submodules
+----------
+
+diffpy.utils.version module
+---------------------------
+
+.. automodule:: diffpy.utils.version
+    :members:
+    :undoc-members:
+    :show-inheritance:
+
+
+Module contents
+---------------
+
+.. automodule:: diffpy.utils
+    :members:
+    :undoc-members:
+    :show-inheritance:

Diff for: doc/manual/source/api/diffpy.utils.wx.rst

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

Diff for: doc/manual/source/index.rst

@@ -14,28 +14,18 @@ Last updated |today|.
 
 diffpy.utils - general purpose shared utilities for the diffpy libraries.
 
-The diffpy.utils package provides functions to easily find and load data from
-text files, various utilites related to data parsing and manipulation, and a set
-of common functions for grid manipulation used by the GUI front-end
-diffpy.pdfgui.
-
-The data loading utilities can be used with most automatically generated powder
-diffraction and PDF data files.  They work by searching for matrix blocks of
-data containing a constant number of columns and a pre-set minimum number of
-rows. By default all columns will be read and returned as a multi-dimensional
-numpy array or as a tuple of individual columns; a sub-set of columns can also
-be selected to be read and the rest ignored.
-
-The data manipulation tools contains interpolation functions that can be used to
-resample a PDF or other profile function over a new grid. Interpolation is based
-on the Whittaker-Shannon formula.
+The diffpy.utils package provides functions for extracting array data from
+variously formatted text files and wx GUI utilities used by the PDFgui
+program.  The package also includes interpolation function based on the
+Whittaker-Shannon formula that can be used to resample a PDF or other profile
+function over a new grid.
 
 
 ===================
 Disclaimer
 ===================
 
-.. include:: ../../../LICENSE.txt
+.. literalinclude:: ../../../LICENSE.txt
 
 ================
 Acknowledgments
@@ -52,10 +42,12 @@ diffpy.Structure is developed and maintained by
 Installation
 ======================================
 
-.. include:: install.rst
+See the `README.rst <https://github.com/diffpy/diffpy.utils#requirements>`_
+file included with the distribution.
 
+======================================
 API and Index
-==================
+======================================
 
 .. toctree::
    :maxdepth: 3