* Change: In documentation/CMakeLists.txt, for add_custom_targets(),
add_dependencies() no longer allow to give files (only others
*target* in the sense of cmake). We must use the DEPENDS option
of add_custom_target().
* Change: In documentation/UsersGuide, it seems that docutils no longer
handle correctly '$' and/or '_' in verbatim in the LaTeX backend.
(i.e. they are *not* escaped, resulting in math mode errors).
Remove those characters as we can use others...
* Commit a snaphot of the current documentation.
* New: In documentation, reorganise all the various documents into one
Sphinx coherent one. The index also provide a link toward the
Doxygen generated doc (C++ APIs) and the venerable LaTeX2HTML ones
(for Stratus).
This will make easier all future extensions to the doc corpus.
The generated documentation is commited into Git so a new user
can use it directly after cloning the repository.
The HTML doc is truly generated by Sphinx, but the pdf one is
created rst2latex. The Sphinx pdf writer is buggy when a "tabular"
contain a multicol and a multirow in the same area of the table.
rst2latex handles it correctly.
We use a theme borrowed for Read The Doc (half of it).
It seems that some Javascripts are not working correctly,
namely the folding of the navigation sub-menus and the index
generation and search mode.
Jean-Paul Chaput