Some more precisions in the documentation.

doc/library/tensor/basic.txt

@@ -495,7 +495,7 @@ dimensions, see :meth:`_tensor_py_operators.dimshuffle`.
 
 .. function:: shape(x)
 
-    Returns lvector representing shape of `x`
+    Returns an lvector representing the shape of `x`.
 
 .. function:: reshape(x, newshape, ndim=None)
 
@@ -553,7 +553,8 @@ dimensions, see :meth:`_tensor_py_operators.dimshuffle`.
 
     Make `x` broadcastable in the specified axes `axes`. For
     example, `unbroadcast(x,0)` will make the first dimension of `x`
-    broadcastable.
+    broadcastable. When performing the function, if the length of `x`
+    along that dimension is not 1, a ``ValueError`` will be raised.
 
 .. function:: flatten(x, outdim=1)