Merge pull request #5002 from slefrancois/doc_buildbot

.jenkins/jenkins_buildbot_python2.sh

@@ -15,7 +15,7 @@ echo "Directory of stdout/stderr ${BUILDBOT_DIR}"
 echo
 echo
 
-BASE_COMPILEDIR=$WORKSPACE/compile/theano_compile_dir_theano
+BASE_COMPILEDIR=$WORKSPACE/compile/theano_compile_dir_theano_python2
 ROOT_CWD=$WORKSPACE/nightly_build
 FLAGS=base_compiledir=$BASE_COMPILEDIR
 COMPILEDIR=`THEANO_FLAGS=$FLAGS python -c "from __future__ import print_function; import theano; print(theano.config.compiledir)"`

.jenkins/jenkins_buildbot_python2_32bit.sh

@@ -15,4 +15,4 @@ echo
 
 FILE=${BUILDBOT_DIR}/theano_python32bit_tests.xml
 set -x
-PYTHONPATH=$HOME/anaconda2_32bit/lib/python2.7/site-packages THEANO_FLAGS=device=cpu,force_device=true,lib.amdlibm=False,compiledir=$WORKSPACE/compile/theano_compile_dir_theano32bit,blas.ldflags= $HOME/anaconda2_32bit/bin/python bin/theano-nose ${THEANO_PARAM} ${XUNIT}${FILE}
+PYTHONPATH=$HOME/anaconda2_32bit/lib/python2.7/site-packages THEANO_FLAGS=device=cpu,force_device=true,lib.amdlibm=False,compiledir=$WORKSPACE/compile/theano_compile_dir_theano_python2_32bit,blas.ldflags= $HOME/anaconda2_32bit/bin/python bin/theano-nose ${THEANO_PARAM} ${XUNIT}${FILE}

.jenkins/jenkins_buildbot_python3.sh

@@ -16,4 +16,4 @@ echo
 
 FILE=${BUILDBOT_DIR}/theano_python3_tests.xml
 set -x
-PYTHONPATH= THEANO_FLAGS=$THEANO_FLAGS,compiledir=$WORKSPACE/compile/theano_compile_dir_theano_p3.3.0,mode=FAST_COMPILE,warn.ignore_bug_before=0.5,on_opt_error=raise,on_shape_error=raise python3 bin/theano-nose ${THEANO_PARAM} ${XUNIT}${FILE}
+PYTHONPATH= THEANO_FLAGS=$THEANO_FLAGS,compiledir=$WORKSPACE/compile/theano_compile_dir_theano_python3,mode=FAST_COMPILE,warn.ignore_bug_before=0.5,on_opt_error=raise,on_shape_error=raise python3 bin/theano-nose ${THEANO_PARAM} ${XUNIT}${FILE}

doc/faq.txt

@@ -8,7 +8,7 @@ Frequently Asked Questions
 
 Does Theano support Python 3?
 ------------------------------
-We support both Python 2 >= 2.6 and Python 3 >= 3.3.
+We support both Python 2 >= 2.7 and Python 3 >= 3.3.
 
 Output slight numerical difference
 ----------------------------------

doc/internal/metadocumentation.txt

@@ -116,20 +116,19 @@ Pylint documentation is generated using pylintrc file: ``Theano/doc/pylintrc``
 The nightly build/tests process
 ---------------------------------------
 
-The user ``lisa`` runs a cronjob on the computer ``ceylon``,  this
-happens nightly. (To have the crontab executed, the ``lisa`` user must
-be logged into ``ceylon``, Fred leaves a shell open for that.)
+We use the Jenkins software to run daily buildbots for Theano, libgpuarray and
+the Deep Learning Tutorials. Jenkins downloads/updates the repos and then runs their test
+scripts. Those scripts test the projects under various condition.
+Jenkins also run some tests in 32 bit Python 2.7 and Python 3.4 for Theano.
 
-The cronjob executes a script that download/update the repo of Theano,
-Pylearn, Pylearn2 and the Deep Learning Tutorial, then run their tests
-script under ``*/misc/do_nightly_build``. Those script tests the
-project under various condition. The cron job also run some tests in
-Python 2.4 and Python 3.3 for Theano.
+The output is emailed automatically to the `theano-buildbot`_ mailing list. The
+jenkins log and test reports are published online:
 
-The output is emailed automatically to the `theano-buildbot`_ mailing list.
+* `Theano buildbot <http://darjeeling.iro.umontreal.ca:8080/job/Theano_buildbot_multijob/>`__
+* `gpuarray buildbot <http://darjeeling.iro.umontreal.ca:8080/job/Buildbot_gpuarray/>`__
 
-.. _theano-buildbot: https://groups.google.com/group/theano-buildbot
 
+.. _theano-buildbot: https://groups.google.com/group/theano-buildbot
 
 TO WRITE
 ---------------------------------------

doc/tutorial/conv_arithmetic.txt

@@ -77,7 +77,7 @@ in the input).
 
 Here is an example of a discrete convolution:
 
-.. figure:: conv_arithmetic_figures/numerical_no_padding_no_strides.gif
+.. figure:: conv_arithmetic_figures/numerical_no_padding_no_strides.*
     :figclass: align-center
 
 The light blue grid is called the *input feature map*. A *kernel* (shaded area)
@@ -149,7 +149,7 @@ For instance, here is a :math:`3 \times 3` kernel applied to a
 :math:`5 \times 5` input padded with a :math:`1 \times 1` border of zeros using
 :math:`2 \times 2` strides:
 
-.. figure:: conv_arithmetic_figures/numerical_padding_strides.gif
+.. figure:: conv_arithmetic_figures/numerical_padding_strides.*
     :figclass: align-center
 
 The analysis of the relationship between convolutional layer properties is eased
@@ -206,7 +206,7 @@ The simplest case to analyze is when the kernel just slides across every
 position of the input (i.e., :math:`s = 1` and :math:`p = 0`).
 Here is an example for :math:`i = 4` and :math:`k = 3`:
 
-.. figure:: conv_arithmetic_figures/no_padding_no_strides.gif
+.. figure:: conv_arithmetic_figures/no_padding_no_strides.*
     :figclass: align-center
 
 One way of defining the output size in this case is by the number of possible
@@ -265,7 +265,7 @@ relationship:
 
 Here is an example for :math:`i = 5`, :math:`k = 4` and :math:`p = 2`:
 
-.. figure:: conv_arithmetic_figures/arbitrary_padding_no_strides.gif
+.. figure:: conv_arithmetic_figures/arbitrary_padding_no_strides.*
     :figclass: align-center
 
 Special cases
@@ -305,7 +305,7 @@ be a desirable property:
 This is sometimes referred to as *half* (or *same*) padding. Here is an example
 for :math:`i = 5`, :math:`k = 3` and (therefore) :math:`p = 1`:
 
-.. figure:: conv_arithmetic_figures/same_padding_no_strides.gif
+.. figure:: conv_arithmetic_figures/same_padding_no_strides.*
     :figclass: align-center
 
 Note that half padding also works for even-valued :math:`k` and for :math:`s >
@@ -347,7 +347,7 @@ possible partial or complete superimposition of the kernel on the input feature
 map is taken into account. Here is an example for :math:`i = 5`, :math:`k = 3`
 and (therefore) :math:`p = 2`:
 
-.. figure:: conv_arithmetic_figures/full_padding_no_strides.gif
+.. figure:: conv_arithmetic_figures/full_padding_no_strides.*
     :figclass: align-center
 
 No zero padding, non-unit strides
@@ -359,7 +359,7 @@ the analysis, let's momentarily ignore zero padding (i.e., :math:`s > 1` and
 :math:`p = 0`). Here is an example for :math:`i = 5`, :math:`k = 3` and :math:`s
 = 2`:
 
-.. figure:: conv_arithmetic_figures/no_padding_strides.gif
+.. figure:: conv_arithmetic_figures/no_padding_strides.*
     :figclass: align-center
 
 Once again, the output size can be defined in terms of the number of possible
@@ -428,13 +428,13 @@ that this ambiguity applies only for :math:`s > 1`.
 Here is an example for :math:`i = 5`, :math:`k = 3`, :math:`s = 2` and :math:`p
 = 1`:
 
-.. figure:: conv_arithmetic_figures/padding_strides.gif
+.. figure:: conv_arithmetic_figures/padding_strides.*
     :figclass: align-center
 
 Here is an example for :math:`i = 6`, :math:`k = 3`, :math:`s = 2` and :math:`p
 = 1`:
 
-.. figure:: conv_arithmetic_figures/padding_strides_odd.gif
+.. figure:: conv_arithmetic_figures/padding_strides_odd.*
     :figclass: align-center
 
 Interestingly, despite having different input sizes these convolutions share the
@@ -478,7 +478,7 @@ Convolution as a matrix operation
 Take for example the convolution presented in the *No zero padding, unit
 strides* subsection:
 
-.. figure:: conv_arithmetic_figures/no_padding_no_strides.gif
+.. figure:: conv_arithmetic_figures/no_padding_no_strides.*
     :figclass: align-center
 
 If the input and output were to be unrolled into vectors from left to right, top
@@ -572,7 +572,7 @@ Let's consider the convolution of a :math:`3 \times 3` kernel on a :math:`4
 :math:`k = 3`, :math:`s = 1` and :math:`p = 0`). As depicted in the convolution
 below, this produces a :math:`2 \times 2` output:
 
-.. figure:: conv_arithmetic_figures/no_padding_no_strides.gif
+.. figure:: conv_arithmetic_figures/no_padding_no_strides.*
     :figclass: align-center
 
 The transpose of this convolution will then have an output of shape :math:`4
@@ -585,7 +585,7 @@ a :math:`2 \times 2` input padded with a :math:`2 \times 2` border of zeros
 using unit strides (i.e., :math:`i' = 2`, :math:`k' = k`, :math:`s' = 1` and
 :math:`p' = 2`), as shown here:
 
-.. figure:: conv_arithmetic_figures/no_padding_no_strides_transposed.gif
+.. figure:: conv_arithmetic_figures/no_padding_no_strides_transposed.*
     :figclass: align-center
 
 Notably, the kernel's and stride's sizes remain the same, but the input of the
@@ -646,7 +646,7 @@ padded with *less* zeros.
 It is indeed the case, as shown in here for :math:`i = 5`, :math:`k = 4` and
 :math:`p = 2`:
 
-.. figure:: conv_arithmetic_figures/arbitrary_padding_no_strides_transposed.gif
+.. figure:: conv_arithmetic_figures/arbitrary_padding_no_strides_transposed.*
     :figclass: align-center
 
 Formally, the following relationship applies for zero padded convolutions:
@@ -713,7 +713,7 @@ applies:
 Here is an example for :math:`i = 5`, :math:`k = 3` and (therefore) :math:`p =
 1`:
 
-.. figure:: conv_arithmetic_figures/same_padding_no_strides_transposed.gif
+.. figure:: conv_arithmetic_figures/same_padding_no_strides_transposed.*
     :figclass: align-center
 
 Full padding, transposed
@@ -749,7 +749,7 @@ the transpose of a fully padded convolution is a non-padded convolution:
 Here is an example for :math:`i = 5`, :math:`k = 3` and (therefore) :math:`p =
 2`:
 
-.. figure:: conv_arithmetic_figures/full_padding_no_strides_transposed.gif
+.. figure:: conv_arithmetic_figures/full_padding_no_strides_transposed.*
     :figclass: align-center
 
 No zero padding, non-unit strides, transposed
@@ -763,7 +763,7 @@ intuition, which is why transposed convolutions are sometimes called
 
 Here is an example for :math:`i = 5`, :math:`k = 3` and :math:`s = 2`:
 
-.. figure:: conv_arithmetic_figures/no_padding_strides_transposed.gif
+.. figure:: conv_arithmetic_figures/no_padding_strides_transposed.*
     :figclass: align-center
 
 This should help understand what fractional strides involve: zeros
@@ -840,7 +840,7 @@ combining :ref:`Relationship 8 <Relationship8>` and
 Here is an example for :math:`i = 5`, :math:`k = 3`, :math:`s = 2` and :math:`p
 = 1`:
 
-.. figure:: conv_arithmetic_figures/padding_strides_transposed.gif
+.. figure:: conv_arithmetic_figures/padding_strides_transposed.*
     :figclass: align-center
 
 The constraint on the size of the input :math:`i` can be relaxed by introducing
@@ -875,7 +875,7 @@ between the :math:`s` different cases that all lead to the same :math:`i'`:
 Here is an example for :math:`i = 6`, :math:`k = 3`, :math:`s = 2` and :math:`p
 = 1`:
 
-.. figure:: conv_arithmetic_figures/padding_strides_odd_transposed.gif
+.. figure:: conv_arithmetic_figures/padding_strides_odd_transposed.*
     :figclass: align-center
 
 .. [#] Dumoulin, Vincent, and Visin, Francesco. "A guide to convolution