DOC: correct form of Raises section

I never bothered to look it up; raises should have error then
description indented on a new line underneath.

Author: matthew-brett

nibabel/casting.py

@@ -199,7 +199,8 @@ def type_info(np_type):
 
     Raises
     ------
-    FloatingError : for floating point types we don't recognize
+    FloatingError
+        for floating point types we don't recognize
 
     Notes
     -----

nibabel/mriutils.py

@@ -40,7 +40,8 @@ def calculate_dwell_time(water_fat_shift, echo_train_length, field_strength):
 
     Raises
     ------
-    MRIError if values are out of range
+    MRIError
+        if values are out of range
     """
     if field_strength < 0:
         raise MRIError("Field strength should be positive")

nibabel/nifti1.py

@@ -1835,8 +1835,10 @@ def load(filename):
 
     Raises
     ------
-    ImageFileError: if `filename` doesn't look like NIfTI1
-    IOError : if `filename` does not exist
+    ImageFileError
+        if `filename` doesn't look like NIfTI1;
+    IOError
+        if `filename` does not exist.
     """
     try:
         img = Nifti1Image.load(filename)

nibabel/nifti2.py

@@ -255,8 +255,10 @@ def load(filename):
 
     Raises
     ------
-    ImageFileError: if `filename` doesn't look like nifti2
-    IOError : if `filename` does not exist
+    ImageFileError
+        if `filename` doesn't look like nifti2;
+    IOError
+        if `filename` does not exist.
     """
     try:
         img = Nifti2Image.load(filename)

nibabel/parrec.py

@@ -375,7 +375,8 @@ def vol_is_full(slice_nos, slice_max, slice_min=1):
 
     Raises
     ------
-    ValueError if any `slice_nos` value is outside slice set.
+    ValueError
+        if any `slice_nos` value is outside slice set.
     """
     slice_set = set(range(slice_min, slice_max + 1))
     if not slice_set.issuperset(slice_nos):
@@ -721,8 +722,8 @@ def _get_unique_image_prop(self, name):
 
         Raises
         ------
-        PARRECError - if the rows of ``self.image_defs[name]`` do not all
-        compare equal
+        PARRECError
+            if the rows of ``self.image_defs[name]`` do not all compare equal.
         """
         props = self.image_defs[name]
         if np.any(np.diff(props, axis=0)):

nibabel/spatialimages.py

@@ -738,8 +738,9 @@ def filespec_to_file_map(klass, filespec):
 
         Raises
         ------
-        ImageFileError - if `filespec` is not recognizable as being a filename
-        for this image type.
+        ImageFileError
+            if `filespec` is not recognizable as being a filename for this
+            image type.
         """
         try:
             filenames = types_filenames(filespec,

nibabel/wrapstruct.py

@@ -509,7 +509,8 @@ def get_value_label(self, fieldname):
 
         Raises
         ------
-        ValueError : if field is not coded
+        ValueError
+            if field is not coded.
 
         Examples
         --------

nisext/testers.py

@@ -72,7 +72,8 @@ def back_tick(cmd, ret_err=False, as_str=True):
 
     Raises
     ------
-    Raises RuntimeError if command returns non-zero exit code
+    RuntimeError
+        if command returns non-zero exit code.
     """
     proc = Popen(cmd, stdout=PIPE, stderr=PIPE, shell=NEEDS_SHELL)
     out, err = proc.communicate()