Rewrite parts of the installation dependencies list.

doc/install.txt

@@ -16,42 +16,50 @@ Requirements
 In order to use Theano, the following libraries and software will need
 to be installed:
 
-    Linux, OS-X or Windows operating system
+    Linux, Mac OS X or Windows operating system
         We develop mainly on 64-bit Linux machines. 32-bit architectures are
         not well-tested.
 
-    python >= 2.5 (2.4 should be supported as well)
+    Python >= 2.5 (2.4 should be supported as well)
         Including the development package(python-dev or python-devel on most OS)
 
-    g++, python-dev
-        Highly recommended, to compile generated C code.
-	We currently compile when we import theano. This could be moved to when we compile c code
-	to allow using theano without c code generation. If someone has the time to do it,
-	it would be welcome. We still would recommend to have them to have faster time.
+    ``g++``, ``python-dev``
+	Not technically required but *highly* recommended, in order to compile
+	generated C code. Theano `can` fall back on a NumPy-based execution model,
+	but a C compiler allows for vastly faster execution.
 
-    `numpy <http://numpy.scipy.org/>`_ >= 1.3.0
+    `NumPy <http://numpy.scipy.org/>`_ >= 1.3.0
         Earlier versions have memory leaks.
 
     `SciPy <http://scipy.org>`_
-        Specifically numpy, sparse, and weave. We recommend scipy
-        >=0.7 if you are using sparse matrices, because scipy.sparse
-        is buggy in 0.6. (scipy.csc_matrix dot has a bug with singleton
-        dimensions. There may be more bugs.)
+	Specifically ``scipy.sparse``, and ``scipy.weave``. We recommend SciPy
+	>=0.7 if you are using sparse matrices, because ``scipy.sparse``
+	is buggy in 0.6 (the ``scipy.csc_matrix`` version of ``dot()`` has a
+	bug with singleton dimensions, there may be more bugs).
 
-    A BLAS installation (with Level 3 functionality), including the development
-	headers	(-dev, -devel, depending on your Linux distribution).
+    A `BLAS`_ installation (with Level 3 functionality)
+    	Including the development headers (``-dev``, ``-devel``, depending on
+	your Linux distribution). Mac OS X comes with the `Accelerate
+	framework`_ built in, and various options exist for Windows.
+
+.. _BLAS: http://en.wikipedia.org/wiki/Basic_Linear_Algebra_Subprograms
+.. _Accelerate framework: http://developer.apple.com/performance/accelerateframework.html
 
 The following libraries and software are optional:
 
     `nose <http://somethingaboutorange.com/mrl/projects/nose/>`_
         Recommended, to run Theano's test-suite.
-    `sphinx <http://sphinx.pocoo.org/>`_ >=0.5.1, `pygments <http://pygments.org/>`_
-        Used to build documentation. latex and dvipng
-        are also necessary for math to show up as images.
-    `mercurial <http://www.selenic.com/mercurial/>`_
-        To download bleeding-edge version of Theano.	
-    `nvidia cuda driver and sdk <http://developer.nvidia.com/object/gpucomputing.html>`_
-    	Needed if you want to use the GPU. Only nvidia gpu and float32 dtype supported for now.
+    `Sphinx <http://sphinx.pocoo.org/>`_ >= 0.5.1, `pygments <http://pygments.org/>`_
+	For building the documentation. LaTeX_ and dvipng_ are also necessary for
+	math to show up as images.
+    `Mercurial <http://www.selenic.com/mercurial/>`_
+        To download bleeding-edge versions of Theano.
+    `NVIDIA CUDA drivers and SDK <http://developer.nvidia.com/object/gpucomputing.html>`_
+	Required for GPU code generation/execution. Only NVIDIA GPUs using 32-bit
+	floating point numbers are currently supported.
+
+.. _LaTeX: http://www.latex-project.org/
+.. _dvipng: http://savannah.nongnu.org/projects/dvipng/
 
 .. _install_bleeding_edge: