[Python-Dev] Building Py3K branch docs with Sphinx

[andrew cooke]

Tim Golden wrote:
> Tim Golden wrote:
>> Can I ask which flavour of Sphinx is being used to build the py3k docs?
>> I've taken the naive approach of simply pulling the sources from
>> branches/py3k and then calling make checkout to fetch the appropriate
>> sources, but these are from http://svn.python.org/projects and are
>> the same for 2.x and 3.x (and don't work under 3.x).
>
>
> ... or I could just use an existing Python 2.x installation to build
> the 3.x docs. Obviously. (slaps forehead)

I asked about this on the Sphinx list a while back.  I didn't get any
response at the time, but checking now I see that a week later someone
(the author I assume) commented -
http://groups.google.com/group/sphinx-dev/browse_thread/thread/9a0286f5deeb2912/778a02c397295add

So it seems that there is no public solution until release 0.6, and that
you cannot be able to run doctests when running with a "different" Python
version (my code should work with 3.0 and 2.6, so tests might work; for
some reason I can no longer remember I disabled that).

Anyway, I generate docs for 3.x code using 2.x and it does work (without
doctests).

Andrew