DOC: docstring fixes for LaTex generation

LaTeX gets very confused for list-like things inside docstring
descriptions.

Author: matthew-brett

nibabel/arrayproxy.py

@@ -78,20 +78,18 @@ def __init__(self, file_like, spec, mmap=True):
             File-like object or filename. If file-like object, should implement
             at least ``read`` and ``seek``.
         spec : object or tuple
-            Tuple must have length 2-5, with the following values.
-                - shape : tuple
-                    tuple of ints describing shape of data
-                - storage_dtype : dtype specifier
-                    dtype of array inside proxied file, or input to ``numpy.dtype``
-                    to specify array dtype
-                - offset : int
-                    Offset, in bytes, of data array from start of file
-                    (default: 0)
-                - slope : float
-                    Scaling factor for resulting data (default: 1.0)
-                - inter : float
-                    Intercept for rescaled data (default: 0.0)
+            Tuple must have length 2-5, with the following values:
+
+            #. shape: tuple - tuple of ints describing shape of data;
+            #. storage_dtype: dtype specifier - dtype of array inside proxied
+               file, or input to ``numpy.dtype`` to specify array dtype;
+            #. offset: int - offset, in bytes, of data array from start of file
+               (default: 0);
+            #. slope: float - scaling factor for resulting data (default: 1.0);
+            #. inter: float - intercept for rescaled data (default: 0.0).
+
             OR
+
             Header object implementing ``get_data_shape``, ``get_data_dtype``,
             ``get_data_offset``, ``get_slope_inter``
         mmap : {True, False, 'c', 'r'}, optional, keyword only

nibabel/ecat.py

@@ -20,13 +20,14 @@
 
 Columns in the matrix list are:
 
-* 0 - Matrix identifier (frame number)
-* 1 - matrix data start block number (subheader followed by image data)
-* 2 - Last block number of matrix (image) data
-* 3 - Matrix status:
-    * 1 - exists - rw
-    * 2 - exists - ro
-    * 3 - matrix deleted
+* 0: Matrix identifier (frame number)
+* 1: matrix data start block number (subheader followed by image data)
+* 2: Last block number of matrix (image) data
+* 3: Matrix status
+
+    * 1: hxists - rw
+    * 2: exists - ro
+    * 3: matrix deleted
 
 There is one sub-header for each image frame (or matrix in the terminology
 above).  A sub-header can also be called an *image header*.  The sub-header is
@@ -339,13 +340,14 @@ def read_mlist(fileobj, endianness):
     mlist : (nframes, 4) ndarray
         matrix list is an array with ``nframes`` rows and columns:
 
-        * 0 - Matrix identifier (frame number)
-        * 1 - matrix data start block number (subheader followed by image data)
-        * 2 - Last block number of matrix (image) data
-        * 3 - Matrix status:
-            * 1 - exists - rw
-            * 2 - exists - ro
-            * 3 - matrix deleted
+        * 0: Matrix identifier (frame number)
+        * 1: matrix data start block number (subheader followed by image data)
+        * 2: Last block number of matrix (image) data
+        * 3: Matrix status
+
+            * 1: hxists - rw
+            * 2: exists - ro
+            * 3: matrix deleted
 
     Notes
     -----
@@ -487,7 +489,7 @@ def read_subheaders(fileobj, mlist, endianness):
         * 0 - Matrix identifier.
         * 1 - subheader block number
         * 2 - Last block number of matrix data block.
-        * 3 - Matrix status:
+        * 3 - Matrix status
     endianness : {'<', '>'}
         little / big endian code