[SciPy-Dev] Building docs in scipy?
Fri Jun 4 07:47:02 CDT 2010
Fri, 04 Jun 2010 19:30:57 +0800, Ralf Gommers wrote:
>> Matthew helpfully pointed out some options (thanks!) to do this in git:
> However, none of the options he gave are automatic, so people will keep
> running into this. I think building docs should work out of the box, so
> I see 2 options:
> 1. we copy sphinxext in scipy. it's not like it changes often, so
> keeping things in sync manually is doable.
I'd say this is bad practice, and we should not do this.
Better to have a Makefile rule that checks it out from git before
building the documents, if it comes to that.
> 2. sphinxext becomes a numpy module that can be imported and used from
> Including it in the tarballs while it's not in the repo is not a good
> idea imho - tarballs should be exactly the same as the svn tag.
Matplotlib moved their sphinx stuff into a submodule. I'm a bit leery
doing that either, since the Sphinx stuff has not much to do with Numpy
More information about the SciPy-Dev