many additions to doc/library

doc/conf.py

@@ -64,7 +64,7 @@ today_fmt = '%B %d, %Y'
 
 # List of directories, relative to source directories, that shouldn't be searched
 # for source files.
-exclude_dirs = ['images', 'scripts', 'trac']
+exclude_dirs = ['images', 'scripts', 'sandbox']
 
 # The reST default role (used for this markup: `text`) to use for all documents.
 #default_role = None

doc/contents.txt

@@ -20,5 +20,5 @@ Contents
    internal/index
    NEWS
    examples/index
-   sandbox/index
+   proposals/index
 

doc/indexes/index.txt

-
-=======
-Indexes
-=======
-
-The following indexes are generated automatically and cover most
-:ref:`Ops <op>`, :ref:`Types <type>` and :ref:`Optimizers <optimization>`
-in Theano.
-
-.. toctree::
-   :maxdepth: 1
-   
-   oplist
-   typelist
-

doc/library/compile/module.txt

 
-============
-Using Module
-============
+=======================================
+:mod:`module` -- a theano object system
+=======================================
+
+.. note::
+
+    Module addresses similar needs to `shared`.  New code is encouraged to
+    use `shared` variables.
 
 Now that we're familiar with the basics, we introduce Theano's more
 advanced interface, Module. This interface allows you to define Theano

doc/library/floatX.txt

-.. _floatX:
 
-========================
-Special data type floatX
-========================
+.. _libdoc_floatX:
 
-Intro
-=====
+=======================================================================
+:mod:`floatX` -- easy switching between float32 and float64 [doc TODO]
+=======================================================================
 
 Their is a special data type called floatX. It is not a real datatype. It is never present in the theano graph, but their exist constructor and function that will change the floatX to float32 or float64(default) in your graph. You can change the value of floatX when you start the execution of python by setting the environement variables THEANO_GPU=floatX=float{32,64}(case sensitive). You can have the value of floatX with::
 

doc/proposals/pfunc.txt

 
-======================================
-Proposal for pfunc  Function Interface
-======================================
+=============================================
+Proposal for pfunc  Function Interface [DONE]
+=============================================
 
 .. note::
 

doc/scripts/docgen.py

@@ -75,11 +75,13 @@ if __name__ == '__main__':
 
     options['--all'] = not (bool(options['--epydoc']) ^ bool(options['--rst']))
 
+    if 0:
         import gen_oplist
         print 'Generating oplist...'
         gen_oplist.print_file(open('%s/doc/indexes/oplist.txt' % throot, 'w'))
         print 'oplist done!'
 
+    if 0:
         import gen_typelist
         print 'Generating typelist...'
         gen_typelist.print_file(open('%s/doc/indexes/typelist.txt' % throot, 'w'))