fix based on comments

theano/gof/callcache.py

@@ -30,12 +30,12 @@ class CallCache(object):
         Retrieve item from the cache(if available)
         based on a key
 
-        Parameters
-        ------------
+        Parameters:
+        ----------
         key
-          parameter to retrieve cache item
+            parameter to retrieve cache item
         fn,args
-          key to retrieve if "key" is None
+            key to retrieve if "key" is None
         """
         if key is None:
             key = (fn, tuple(args))

theano/gof/cc.py

@@ -154,7 +154,7 @@ def code_gen(blocks):
         }
 
     Parameters:
-    ----------------
+    ----------
     blocks
          List of CodeBlock instances such that
          * declarations, behavior and cleanup are in the run()
@@ -1170,7 +1170,10 @@ class CLinker(link.Linker):
             be allocated.
         storage_map: dict that map variables to storages.
             This is used when you need to customize the storage of
-            this thunk.keep_lock
+            this thunk
+        keep_lock:
+            If True, we won't release the lock on the compiledir
+            at the end of this function call.
         Returns: thunk, input_storage, output_storage
 
         The return values can be used as follows:
@@ -1559,7 +1562,7 @@ class CLinker(link.Linker):
         can carry on the computation of this linker's fgraph
 
         Parameters:
-        ---------------
+        ----------
         error_storage -> list of length 3
         in_storage -> list of lists of length 1, one per input
         out_storage -> list of lists of length 1, one per output
@@ -1840,10 +1843,12 @@ def _default_checker(x, y):
     """
     Default checker for DualLinker. This checks that the
     variables contain the same data using ==.
-    Parameters
-    -------------
+
+
+    Parameters:
+    ----------
     x,y
-    the variables to compare data
+        the variables to compare data
     """
     if x[0] != y[0]:
         raise Exception("Output mismatch.",

theano/gof/cmodule.py

@@ -1481,7 +1481,8 @@ def _rmtree(parent, ignore_nocleanup=False, msg='', level=logging.DEBUG,
     So instead, some commands in this file will respond to a
     failed rmtree() by touching a 'delete.me' file.  This file is a message
     for a future process to try deleting the directory.
-    Paramters
+
+    Parameters:
     ----------
     parent
         Root node to start deleting from

theano/gof/link.py

@@ -60,14 +60,15 @@ def thunk_hook(type, value, trace):
     and prints it out on L{stderr}.
 
     The normal excepthook is then called.
-    Parameters
-    ------------
+
+    Parameters:
+    ----------
     type
-      Exception class
+        Exception class
     value
-      Exception instance
+        Exception instance
     trace
-      Traceback object
+        Traceback object
 
     Notes
     -----