DOC: Fix spelling and adjust formatting

Author: pauldmccarthy

nibabel/freesurfer/io.py

@@ -85,17 +85,17 @@ def _pack_rgba(rgba):
     """Pack an RGBA sequence into a single integer.
 
     Used by :func:`read_annot` and :func:`write_annot` to generate
-    "annotation values" for a Freesuerfer ``.annot`` file.
+    "annotation values" for a Freesurfer ``.annot`` file.
 
     Parameters
     ----------
     rgba : ndarray, shape (n, 4)
-        RGBA colours
+        RGBA colors
 
     Returns
     -------
     out : ndarray, shape (n, 1)
-        Annotation values for each colour.
+        Annotation values for each color.
     """
     bitshifts = 2 ** np.array([[0], [8], [16], [24]], dtype=rgba.dtype)
     return rgba.dot(bitshifts)
@@ -328,14 +328,14 @@ def read_annot(filepath, orig_ids=False):
 
     An ``.annot`` file contains a sequence of vertices with a label (also known
     as an "annotation value") associated with each vertex, and then a sequence
-    of colours corresponding to each label.
+    of colors corresponding to each label.
 
     Annotation file format versions 1 and 2 are supported, corresponding to
     the "old-style" and "new-style" color table layout.
 
     See:
-    https://surfer.nmr.mgh.harvard.edu/fswiki/LabelsClutsAnnotationFiles#Annotation
-    https://github.com/freesurfer/freesurfer/blob/dev/matlab/read_annotation.m
+     * https://surfer.nmr.mgh.harvard.edu/fswiki/LabelsClutsAnnotationFiles#Annotation
+     * https://github.com/freesurfer/freesurfer/blob/dev/matlab/read_annotation.m
 
     Parameters
     ----------
@@ -366,13 +366,13 @@ def read_annot(filepath, orig_ids=False):
         data = np.fromfile(fobj, dt, vnum * 2).reshape(vnum, 2)
         labels = data[:, 1]
 
-        # is there a colour table?
+        # is there a color table?
         ctab_exists = np.fromfile(fobj, dt, 1)[0]
         if not ctab_exists:
             raise Exception('Color table not found in annotation file')
 
         # in old-format files, the next field will contain the number of
-        # entries in the colour table. In new-format files, this must be
+        # entries in the color table. In new-format files, this must be
         # equal to -2
         n_entries = np.fromfile(fobj, dt, 1)[0]
 
@@ -395,18 +395,18 @@ def read_annot(filepath, orig_ids=False):
 
 
 def _read_annot_ctab_old_format(fobj, n_entries):
-    """Read in an old-style Freesurfer colour table from `fobj`.
+    """Read in an old-style Freesurfer color table from `fobj`.
 
     This function is used by :func:`read_annot`.
 
     Parameters
     ----------
 
-    fobj : file-like
+    fobj : file
         Open file handle to a Freesurfer `.annot` file, with seek point
-        at the beginning of the colour table data.
+        at the beginning of the color table data.
     n_entries : int
-        Number of entries in the colour table.
+        Number of entries in the color table.
 
     Returns
     -------
@@ -436,18 +436,18 @@ def _read_annot_ctab_old_format(fobj, n_entries):
 
 
 def _read_annot_ctab_new_format(fobj, ctab_version):
-    """Read in a new-style Freesurfer colour table from `fobj`.
+    """Read in a new-style Freesurfer color table from `fobj`.
 
     This function is used by :func:`read_annot`.
 
     Parameters
     ----------
 
-    fobj : file-like
+    fobj : file
         Open file handle to a Freesurfer `.annot` file, with seek point
-        at the beginning of the colour table data.
+        at the beginning of the color table data.
     ctab_version : int
-        Colour table format version - must be equal to 2
+        Color table format version - must be equal to 2
 
     Returns
     -------
@@ -487,8 +487,8 @@ def write_annot(filepath, labels, ctab, names, fill_ctab=True):
     """Write out a "new-style" Freesurfer annotation file.
 
     See:
-    https://surfer.nmr.mgh.harvard.edu/fswiki/LabelsClutsAnnotationFiles#Annotation
-    https://github.com/freesurfer/freesurfer/blob/dev/matlab/write_annotation.m
+     * https://surfer.nmr.mgh.harvard.edu/fswiki/LabelsClutsAnnotationFiles#Annotation
+     * https://github.com/freesurfer/freesurfer/blob/dev/matlab/write_annotation.m
 
     Parameters
     ----------