on master help sign in
Updated README to warn about sphinx version.
af1569cJan de Muijnck-Hughes
docs/README.md+7−1
@@ -10,7 +10,13 @@ To build the manual the following dependencies must be met. We assume that you h
10### Sphinx-Doc
10### Sphinx-Doc
11
11
12Python should be installed by default on most systems.
12Python should be installed by default on most systems.
13−Sphinx can be installed wither through your hosts package manager or using pip/easy_install.
13+Sphinx can be installed either through your hosts package manager or using pip/easy_install.
14+
15+*Note* [ReadTheDocs](http://www.readthedocs.org) works with Sphinx
16+ `v1.2.2`. If you install a more recent version of sphinx then
17+ 'incorrectly' marked up documentation may get passed the build system
18+ of readthedocs and be ignored. In the past we had several code-blocks
19+ disappear because of that.
14
20
15### LaTeX
21### LaTeX
16
22