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

[Eric Firing]

David Cournapeau wrote:
> 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:

David,

A few days ago I was trying to build it on linux.  I could not build it 
with 0.5.1 or with 0.6dev.  I submitted tickets to sphinx for the 
latter, and I think the first three problems were fixed before I hit one 
that required a change on the numpy side.  I was not (and still am not) 
prepared to work on it, so that was the end of it.

http://www.mail-archive.com/numpy-discussion@scipy.org/msg15953.html

Eric


> 
> ...
> 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
> _______________________________________________
> Numpy-discussion mailing list
> Numpy-discussion at scipy.org
> http://mail.scipy.org/mailman/listinfo/numpy-discussion