numpydoc for theano/compile/builders.py

theano/compile/builders.py

@@ -10,10 +10,11 @@ from functools import reduce
 
 
 class OpFromGraph(gof.Op):
-    """This creates an `Op` from inputs and outputs lists of variables.
+    """
+    This creates an `Op` from inputs and outputs lists of variables.
 
     The signature is similar to theano.function() and the resulting
-    `Op`'s perform will do the same operation as::
+    `Op`'s perform will do the same operation as:
 
         orig_function(inputs, outputs, **kwargs)
 
@@ -31,12 +32,16 @@ class OpFromGraph(gof.Op):
         - Add support to pickle this Op.
         - Add support/test with random generator
 
-    :note:
+    Notes
+    -----
     - We support shared variables in the inner graph. This is automatic and
       invisible to the user. They can be as input to the node or in the
       inner graph.
     - We support unused inputs. This is needed for the grad.
 
+    Examples
+    --------
+
     Example 1:
 
     .. code-block:: python
@@ -49,8 +54,6 @@ class OpFromGraph(gof.Op):
         e2 = op(x, y, z) + op(z, y, x)
         fn = function([x, y, z], [e2])
 
-
-
     Example 2 with shared variable:
 
     .. code-block:: python
@@ -139,7 +142,8 @@ class OpFromGraph(gof.Op):
 
     def connection_pattern(self, node):
         """
-        Return connection pattern of subfgraph defined by inputs and outputs
+        Return connection pattern of subfgraph defined by inputs and outputs.
+
         """
         return io_connection_pattern(self.new_inputs, self.new_outputs)