Hello,
I've noted that the Python script `doc/compile-doc.py' used for
generating HTML documentation works only with Python 2.x. Furthermore
it is called in the rake file by `sh doc/compile-doc.py ...'. Thus
locating of the Python command to use relies on the
`#!/usr/bin/python' line in the script.
Therefore the working of `doc/compile-doc.py' makes the asumption that
there is a Python 2 command at `/usr/bin/python'. This does not work,
for instance, for Arch Linux: On such a system `/usr/bin/python' is
Python 3; the Python 2 command would be at `/usr/bin/python2'. It
would also not work with Python 2 installation below `/usr/local'.
Thus I've implemented a in the rake file a search for a Python 2
command following the following heuristics: First we try to locate
`python2' whithin $PATH, and if this fails, we are looking for
`python' in $PATH. The diff appended patches `Rakefile' for doing
this.
Two caveats for my patch. I am not a Ruby programmer, so my
implementation my be a little bit clumsy. And and works only for
UNIX-like systems - but could easily enhanced for platform
independence (by enhancing the `which' function - see, for instance,
http://stackoverflow.com/questions/2108727/which-in-ruby-checking-if-...).
Dirk
