DOC: various documentation fixes

Remove custom matplotlib directives in favor of matplotlib.

Rewrite and fix up a few docstrings to match numpy standard.

Author: matthew-brett

doc/source/api.rst

@@ -32,9 +32,9 @@ File Formats
    nifti2
    ecat
    parrec
+   streamlines
    trackvis
 
-
 Image Utilities
 ===============
 

doc/source/conf.py

@@ -61,8 +61,7 @@
               'sphinx.ext.autosummary',
               'texext.math_dollar',  # has to go before numpydoc
               'numpydoc',
-              'only_directives',
-              'plot_directive',
+              'matplotlib.sphinxext.plot_directive',
               ]
 
 # the following doesn't work with sphinx < 1.0, but will make a separate

doc/source/devel/advanced_testing.rst

@@ -9,22 +9,22 @@
 
 .. _advanced_testing:
 
-************
+****************
 Advanced Testing
-************
+****************
 
 Setup
 -----
 
-Before running advanced tests, please update all submodules of nibabel, by running ``git submodule update --init``
-
+Before running advanced tests, please update all submodules of nibabel, by
+running ``git submodule update --init``
 
 Long-running tests
 ------------------
 
 Long-running tests are not enabled by default, and can be resource-intensive. To run these tests:
 
-* Set environment variable ``NIPY_EXTRA_TESTS=slow``
+* Set environment variable ``NIPY_EXTRA_TESTS=slow``;
 * Run ``nosetests``.
 
 Note that some tests may require a machine with >4GB of RAM.

doc/source/installation.rst

@@ -27,7 +27,7 @@ setup.py install``.
 Installer and packages
 ======================
 
-.. _install_pypi:
+.. _install-pypi:
 
 pip and the Python package index
 --------------------------------