revising libdoc of tensor.basic

doc/library/tensor/index.txt

@@ -10,8 +10,8 @@
 .. moduleauthor:: LISA
 
 Theano's strength is in expressing symbolic calculations involving tensors.  
-There are many types of symbolic expressions for tensors.  For everyone's
-sanity, they are grouped into the following sections:
+There are many types of symbolic expressions for tensors. 
+They are grouped into the following sections:
 
 
 .. toctree::

doc/tutorial/adding.txt

@@ -65,7 +65,7 @@ is the type we assign to "0-dimensional arrays (`scalar`) of doubles
 
 ``dscalar`` is not a class. Therefore, neither ``x`` nor ``y``
 are actually instances of ``dscalar``. They are instances of
-:ref:`TensorVariable <libdoc_tensor_type>`. ``x`` and ``y``
+:class:`TensorVariable`. ``x`` and ``y``
 are, however, assigned the theano Type ``dscalar`` in their ``type``
 field, as you can see here:
 

doc/tutorial/symbolic_graphs.txt

@@ -38,11 +38,20 @@ details about these building blocks see :ref:`variable`, :ref:`op`,
 
 **Diagram**
 
+.. _tutorial-graphfigure: 
+
 .. figure:: apply.png 
     :align: center
 
+    Interaction between instances of Apply (blue), Variable (red), Op (green),
+    and Type (purple).
+
+.. # COMMENT
+    WARNING: hyper-links and ref's seem to break the PDF build when placed
+    into this figure caption.
 
-Arrows represent references to the Python objects pointed at. The blue
+Arrows in this :ref:`figure <tutorial-graphfigure>` represent references to the 
+Python objects pointed at. The blue
 box is an :ref:`apply` node. Red boxes are :ref:`variable` nodes. Green
 circles are :ref:`Ops <op>`. Purple boxes are :ref:`Types <type>`.