Add roll and PdbBreakpoint to the doc

doc/library/tensor/basic.txt

@@ -656,6 +656,7 @@ dimensions, see :meth:`_tensor_py_operators.dimshuffle`.
         `len(reps)` must be equal and, if specified, `ndim` must be
         equal to both.
 
+.. autofunction:: roll
 
 Creating Tensor
 ===============

doc/tutorial/debug_faq.txt

@@ -567,3 +567,6 @@ the Ops from Theano and Pylearn2.
     # Where filename is a string to a file that we will write to.
 
 Then send us filename.
+
+
+.. autoclass:: theano.tests.breakpoint.PdbBreakpoint

theano/tensor/basic.py

@@ -3968,7 +3968,7 @@ pprint.assign(lambda pstate, r: r.owner and isinstance(r.owner.op, Join),
 
 def roll(x, shift, axis=None):
     """
-    Convenience function to roll `TensorType`s along the given axis.
+    Convenience function to roll TensorTypes along the given axis.
 
     Syntax copies numpy.roll function.
 
@@ -3986,7 +3986,7 @@ def roll(x, shift, axis=None):
     Returns
     -------
     tensor
-        Output tensor, with the same shape as `x`.
+        Output tensor, with the same shape as ``x``.
 
     """
     if axis is None:

theano/tests/breakpoint.py

@@ -12,8 +12,8 @@ class PdbBreakpoint(Op):
     conditional breakpoint, inside a theano function, based on a symbolic
     scalar condition.
 
-    @type name: String
-    @param name: name of the conditional breakpoint. To be printed when the
+    :type name: String
+    :param name: name of the conditional breakpoint. To be printed when the
                  breakpoint is activated.
 
     :note: WARNING. At least one of the outputs of the op must be used