DOC: Fixes to docs

fsl/__init__.py

@@ -13,6 +13,7 @@ following sub-packages:
    fsl.data
    fsl.utils
    fsl.scripts
+   fsl.transform
    fsl.version
    fsl.wrappers
 
@@ -22,4 +23,4 @@ following sub-packages:
           for details.
 """
 
-__path__ = __import__('pkgutil').extend_path(__path__, __name__)
+__path__ = __import__('pkgutil').extend_path(__path__, __name__)  # noqa

fsl/data/image.py

@@ -224,7 +224,7 @@ class Nifti(notifier.Notifier, meta.Meta):
     =============== ========================================================
     ``'transform'`` The affine transformation matrix has changed. This topic
                     will occur when the :meth:`voxToWorldMat` is changed.
-    ``'header       A header field has changed. This will occur when the
+    ``'header'``    A header field has changed. This will occur when the
                     :meth:`intent` is changed.
     =============== ========================================================
     """  # noqa

fsl/transform/nonlinear.py

@@ -139,7 +139,7 @@ class NonLinearTransform(fslimage.Image):
                      reference space.
         :arg from_:  Reference image space that ``coords`` are defined in
         :arg to:     Source image space to transform ``coords`` into
-        :returns    ``coords``, transformed into the source image space
+        :returns:    ``coords``, transformed into the source image space
         """
         raise NotImplementedError()
 
@@ -217,7 +217,7 @@ class DisplacementField(NonLinearTransform):
                      reference space.
         :arg from_:  Reference image space that ``coords`` are defined in
         :arg to:     Source image space to transform ``coords`` into
-        :returns     ``coords``, transformed into the source image space
+        :returns:    ``coords``, transformed into the source image space
         """
 
         if from_ is None: from_ = self.refSpace
@@ -400,11 +400,11 @@ class CoefficientField(NonLinearTransform):
 
         :arg to:     Source image space to transform ``coords`` into
 
-        :returns    ``coords``, transformed into the source image space
-
         :arg premat: If ``True``, the inverse :meth:`srcToRefMat` is applied
                      to the coordinates after the displacements have been
                      addd.
+
+        :returns:    ``coords``, transformed into the source image space
         """
         df = self.asDisplacementField(premat=premat)
         return df.transform(coords, from_, to)
@@ -629,7 +629,7 @@ def coefficientFieldToDisplacementField(field,
 
     :arg field:    :class:`CoefficientField` to convert
 
-    :arg dispType: The type of displcaement field - either ``'relative'`` (the
+    :arg dispType: The type of displacement field - either ``'relative'`` (the
                    default) or ``'absolute'``.
 
     :arg premat:   If ``True`` (the default), the :meth:`srcToRefMat` is