Merge pull request #2549 from SinaHonari/issue2337

doc/library/tensor/basic.txt

-.. currentmodule:: tensor
+.. currentmodule:: theano.tensor
 
 .. _libdoc_basic_tensor:
 
@@ -583,26 +583,11 @@ dimensions, see :meth:`_tensor_py_operators.dimshuffle`.
     :type n_ones: int
     :type n_ones: number of dimension to be added to `x`
 
-.. function:: unbroadcast(x, *axes)
+.. autofunction:: unbroadcast(x, *axes)
 
-    Make `x` impossible to broadcast in the specified axes `axes`. For
-    example, `unbroadcast(x, 0)` will make the first dimension of `x`
-    unbroadcastable.
+.. autofunction:: addbroadcast(x, *axes)
 
-.. function:: addbroadcast(x, *axes)
-
-    Make `x` broadcastable in the specified axes `axes`. For
-    example, `addbroadcast(x, 0)` will make the first dimension of `x`
-    broadcastable. When performing the function, if the length of `x`
-    along that dimension is not 1, a ``ValueError`` will be raised.
-
-.. function:: patternbroadcast(x, broadcastable)
-
-    Change `x` broadcastable pattern to
-    `broadcastable`. `broadcastable` must be iterable. For example,
-    `patternbroadcast(x, (True, False))` will make the first dimension
-    of `x` broadcastable and the second dimension not broadcastable,
-    so x will now be a `row`.
+.. autofunction:: patternbroadcast(x, broadcastable)
 
 .. function:: flatten(x, outdim=1)
 

theano/tensor/basic.py

@@ -3265,9 +3265,26 @@ class Split(Op):
 def addbroadcast(x, *axes):
     """
     Make the input broadcastable in the specified axes.
+    For example, addbroadcast(x, 0) will make the first dimension of
+    x broadcastable. When performing the function, if the length of
+    x along that dimension is not 1, a ValueError will be raised.
 
     We apply the opt here not to pollute the graph especially during
     the gpu optimization
+
+    Parameters:
+    ------------
+        x : tensor_like
+            Input theano tensor.
+        axis : an int or an iterable object such as list or tuple
+               of int values
+            The dimension along which the tensor x should be broadcastable.
+            if the length of x along these dimensions is not 1,
+            a ValueError will be raised.
+
+    returns:
+    ----------
+        a theano tensor, which is broadcastable along the specified dimensions.
     """
     rval = Rebroadcast(*[(axis, True) for axis in axes])(x)
     return theano.tensor.opt.apply_rebroadcast_opt(rval)
@@ -3276,9 +3293,26 @@ def addbroadcast(x, *axes):
 def unbroadcast(x, *axes):
     """
     Make the input impossible to broadcast in the specified axes.
+    For example, addbroadcast(x, 0) will make the first dimension
+    of x broadcastable. When performing the function, if the length
+    of x along that dimension is not 1, a ValueError will be raised.
 
     We apply the opt here not to pollute the graph especially during
     the gpu optimization
+
+    Parameters:
+    ------------
+        x : tensor_like
+            Input theano tensor.
+        axis : an int or an iterable object such as list or tuple
+               of int values
+            The dimension along which the tensor x should be unbroadcastable.
+            if the length of x along these dimensions is not 1,
+            a ValueError will be raised.
+
+    returns:
+    ----------
+        a theano tensor, which is unbroadcastable along the specified dimensions.
     """
     rval = Rebroadcast(*[(axis, False) for axis in axes])(x)
     return theano.tensor.opt.apply_rebroadcast_opt(rval)
@@ -3287,9 +3321,28 @@ def unbroadcast(x, *axes):
 def patternbroadcast(x, broadcastable):
     """
     Make the input adopt a specific broadcasting pattern.
+    broadcastable must be iterable. For example,
+    patternbroadcast(x, (True, False)) will make the first
+    dimension of x broadcastable and the second dimension
+    not broadcastable, so x will now be a row.
 
     We apply the opt here not to pollute the graph especially during the gpu
     optimization.
+
+    Parameters:
+    ------------
+        x : tensor_like
+            Input theano tensor.
+        broadcastable : an iterable object such as list or tuple
+                        of bool values
+            a set of boolean values indicating whether a dimension
+            should be broadcastable or not.
+            if the length of x along these dimensions is not 1,
+            a ValueError will be raised.
+
+    returns:
+    ----------
+        a theano tensor, which is unbroadcastable along the specified dimensions.
     """
     rval = Rebroadcast(*[(i, broadcastable[i])
                          for i in xrange(len(broadcastable))])(x)