[SciPy-Dev] Questions about docs

[Warren Weckesser]

Each package has the file "info.py" (e.g. scipy/linalg/info.py) that 
contains a docstring.  For linalg, roughly the same information is in 
doc/source/linalg.rst.  Which is the file that is currently maintained, 
and which can we get rid of?  Running "make html" in doc/ uses the .rst 
file, but the corresponding web page at docs.scipy.org 
(http://docs.scipy.org/scipy/docs/scipy.linalg/) appears to be from the 
file info.py.

More basic question:  when I have the trunk checked out, what is "the 
way" to build the docs?