[Python-Dev] [Python-3000] Documentation switch imminent

[Georg Brandl]

Neal Norwitz schrieb:
> On 8/15/07, Georg Brandl <g.brandl at gmx.net> wrote:
>> Georg Brandl schrieb:
>> >
>> > Neal will change his build scripts, so that the 2.6 and 3.0 devel
>> > documentation pages at docs.python.org will be built from these new
>> > trees soon.
>>
>> Okay, I made the switch.  I tagged the state of both Python branches
>> before the switch as tags/py{26,3k}-before-rstdocs/.
> 
> http://docs.python.org/dev/
> http://docs.python.org/dev/3.0/

Great!

> 3.0 output:
> Traceback (most recent call last):
>   File "tools/sphinx-build.py", line 13, in <module>
>     from sphinx import main
>   File "/home/neal/python/py3k/Doc/tools/sphinx/__init__.py", line 16,
> in <module>
>     from .builder import builders
>   File "/home/neal/python/py3k/Doc/tools/sphinx/builder.py", line 35,
> in <module>
>     from .environment import BuildEnvironment
>   File "/home/neal/python/py3k/Doc/tools/sphinx/environment.py", line
> 34, in <module>
>     from docutils.parsers.rst.states import Body
>   File "/home/neal/python/py3k/Doc/tools/docutils/parsers/rst/__init__.py",
> line 77, in <module>
>     from docutils.parsers.rst import states
>   File "/home/neal/python/py3k/Doc/tools/docutils/parsers/rst/states.py",
> line 110, in <module>
>     import roman
> ImportError: No module named roman
> 
> After this error, I just linked my tools directory to the one in 2.6
> (trunk) and that worked. I'm not sure if this will create problems in
> the future.

No, it shouldn't. I added roman.py in trunk, but didn't
touch py3k since I don't want to disturb svnmerge more than necessary.

> trying to load pickled env... failed: [Errno 2] No such file or
> directory: 'build/doctrees/environment.pickle'

That is expected.

> writing output...
> ... library/contextlib.rst<string>:3: Warning: 'with' will become a
> reserved keyword in Python 2.6
> library/shutil.rst<string>:17: Warning: 'as' will become a reserved
> keyword in Python 2.6
> library/subprocess.rst<string>:7: Warning: 'as' will become a reserved
> keyword in Python 2.6
> tutorial/errors.rst<string>:1: Warning: 'with' will become a reserved
> keyword in Python 2.6
> 
> I realize none of these are a big deal.  However, it would be nice if
> it was cleaned up so that people unfamiliar with building the docs
> aren't surprised.

I'll have the with/as problem fixed soon, it should be nothing more than
setting the future flag for the call to compile().

Thanks,
Georg

-- 
Thus spake the Lord: Thou shalt indent with four spaces. No more, no less.
Four shall be the number of spaces thou shalt indent, and the number of thy
indenting shall be four. Eight shalt thou not indent, nor either indent thou
two, excepting that thou then proceed to four. Tabs are right out.