New debug/profiling mode description

doc/install.txt

@@ -109,7 +109,7 @@ automatic code generation, but that way is much, much slower.
 - ``THEANO_DEFAULT_MODE``:
     String value specifying the default mode to use when compiling Theano
     graphs. This can be one of the strings defined in
-    :api:`theano.compile.mode`.
+    :ref:`using_modes`.
     Possible values so far are:
 
     - ``'FAST_COMPILE'``

doc/internal/dev_start_guide.txt

@@ -6,10 +6,10 @@ Developer Start Guide
 =====================
 
 
-- Learn some `non-basic python`_ to understand what's going on in some of the
+- Learn some non-basic python to understand what's going on in some of the
   tricker files (like tensor.py).
 
-- BasicNumpy_ essential things to know about numpy.
+- Roughly go through the numpy documentation.
 
 - Learn to write reStructuredText_ for epydoc_.
 
@@ -134,6 +134,7 @@ so there might be some latency in the process.
 For more detail :ref:`see <metadocumentation_nightly_build>`.
 
 
+.. TODO: fix this links
 
 .. _non-basic python: http://pylearn.org/theano/wiki/NonbasicPython
 .. _reStructuredText: http://docutils.sourceforge.net/rst.html

doc/introduction.txt

@@ -125,18 +125,16 @@ Getting started
 :ref:`install`
   Instructions to download and install Theano on your system.
 
-:ref:`basictutorial`
-  Getting started with Theano's basic features. Go there if you are
+:ref:`tutorial`
+  Getting started with Theano's basic features. Go here if you are
   new!
 
-:ref:`advtutorial`
-  This tutorial is for more advanced users who want to define their
-  own operations and optimizations. It is recommended to go through
-  the :ref:`basictutorial` first.
+:ref:`libdoc`
+  The library documentation can be found here. It is recommended to go through
+  the :ref:`tutorial` first.
 
-For a complete map of the documentation you may check the
-:ref:`contents`. Also, a PDF version of the online documentation may
-be found `here <theano.pdf>`_.
+
+A PDF version of the online documentation may be found `here <theano.pdf>`_.
 
 
 Contact us

doc/tutorial/examples.txt

@@ -289,28 +289,5 @@ substitution to be co-dependent, the order of substitution is not defined, so
 the substitutions have to work in any order.
 
 
-Mode
-====
-
-The ``mode`` parameter to :ref:`theano.function <libdoc_compile_function>` 
-controls how the inputs-to-outputs graph is transformed into a callable 
-object.
-
-Theano defines the following modes by name:
-
-- ``FAST_COMPILE``: Apply just a few optimizations, but use C op implementations where possible.
-- ``FAST_RUN``: Apply all optimizations, and use C op implementations where possible.
-- ``DEBUG_MODE``: Verify the correctness of all optimizations, and compare C and python 
-    implementations. This mode can take much longer than the other modes, 
-    but can identify many kinds of problems.
-
-The default mode is typically ``FAST_RUN``, but it can be controlled via
-the environment variable ``THEANO_DEFAULT_MODE``, which can in turn be
-overridden by setting `theano.compile.mode.default_mode` directly,
-which can in turn be overridden by passing the keyword argument to
-:ref:`theano.function <libdoc_compile_function>`.
-
-
-
 
 

doc/tutorial/index.txt

@@ -24,6 +24,7 @@ installation (see :ref:`install`).
     adding
     examples
     loading_and_saving
+    modes
     remarks
     debug_faq
     tools