[Numpy-discussion] Numpy documentation: status and distribution for 1.3.0

[David Cournapeau]

Hi,

For the upcoming 1.3.0 release, I would like to distribute the (built)
documentation in some way. But first, I need to be able to build it :)
What are the exact requirements to build the documentation ? Is sphinx
0.5 enough ? I can't manage to build it on either mac os x or linux:

...
dumping search index... Exception occurred:
  File "/Users/david/local/stow/sphinx.dev/lib/python2.5/site-packages/sphinx/search.py",
line 151, in get_descrefs
    pdict[name] = (fn2index[doc], i)
KeyError: 'reference/c-api.types-and-structures'
The full traceback has been saved in
/var/folders/b-/b-BC2bPYFouYhoybrvprFE+++TI/-Tmp-/sphinx-err-PKglvL.log,
if you want to report the issue to the author.
Please also report this if it was a user error, so that a better error
message can be provided next time.

There are also some errors on mac os x about too many opened files
(which can be alleviated by running the make html again, but
obviously, that's not great). I don't know if there are easy solutions
to that problem,

cheers,

David