Fixed documentation build error and warnings

doc/source/devel/biaps/biap_0003.rst

@@ -199,8 +199,10 @@ The base level header will usually also have image metadata fields giving
 information about the whole image. A field is an "image metadata field" if it
 is defined at the top level of the header.  For example::
 
->>> hdr = dict(nipy_header_version='1.0',
-...            Manufacturer="SIEMENS")
+.. code-block:: python
+
+  hdr = dict(nipy_header_version='1.0',
+             Manufacturer="SIEMENS")
 
 All image metadata fields are optional.
 
@@ -635,7 +637,7 @@ Use case
 ^^^^^^^^
 
 When doing motion correction on a 4D image, we calculate the required affine
-transformation from |--| say |--| the second image to the first image; the
+transformation from, say, the second image to the first image; the
 third image to the first image; etc. If there are N volumes in the 4D image,
 we would need to store N-1 affine transformations.  If we have registered to
 the mean volume of the volume series instead of one of the volumes in the

nibabel/ecat.py

@@ -520,7 +520,7 @@ def __init__(self, hdr, mlist, fileobj):
         there is one subheader for each frame in the ecat file
 
         Parameters
-        -----------
+        ----------
         hdr : EcatHeader
             ECAT main header
         mlist : array shape (N, 4)

nibabel/gifti/__init__.py

@@ -13,7 +13,6 @@
 .. autosummary::
    :toctree: ../generated
 
-   giftiio
    gifti
 """
 

nibabel/tmpdirs.py

@@ -52,7 +52,7 @@ class InTemporaryDirectory(TemporaryDirectory):
     """ Create, return, and change directory to a temporary directory
 
     Notes
-    ------
+    -----
     As its name suggests, the class temporarily changes the working
     directory of the Python process, and this is not thread-safe.  We suggest
     using it only for tests.