Mailman 3 October 2010 - docs

[issue10225] Fix doctest runable examples in python manual
by Alexander Belopolsky 29 Oct '10

29 Oct '10

Alexander Belopolsky <belopolsky(a)users.sourceforge.net> added the comment: I am attaching a new patch which fixes all but two doctest examples. I suspect that the remaining failures are due to a bug in sphinx. (The examples are executed even though marked up with ::). ---------- stage: needs patch -> patch review Added file: http://bugs.python.org/file19413/issue10225a-r27.diff _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue10225> _______________________________________

1 0

[issue10225] Fix doctest runable examples in python manual
by Alexander Belopolsky 29 Oct '10

29 Oct '10

Changes by Alexander Belopolsky <belopolsky(a)users.sourceforge.net>: ---------- nosy: +docs@python _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue10225> _______________________________________

1 0

[issue10224] Build 3.x documentation using python3.x
by Georg Brandl 29 Oct '10

29 Oct '10

Georg Brandl <georg(a)python.org> added the comment: (The usual build process via Makefile still uses Python 2, and that won't change for 3.2.) ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue10224> _______________________________________

1 0

[issue10224] Build 3.x documentation using python3.x
by Georg Brandl 29 Oct '10

29 Oct '10

Georg Brandl <georg(a)python.org> added the comment: Nope, these files run just as fine in Python 2. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue10224> _______________________________________

1 0

[issue10224] Build 3.x documentation using python3.x
by Martin v. Löwis 29 Oct '10

29 Oct '10

Martin v. Löwis <martin(a)v.loewis.de> added the comment: Did you know break building the 3.x documentation with Python 2? If so, please revert that change. ---------- nosy: +loewis _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue10224> _______________________________________

1 0

bug at http://docs.python.org/py3k/library/re.html#module-re
by keith.briggs＠bt.com 29 Oct '10

29 Oct '10

> (?:...) > A non-grouping version of regular parentheses. Shouldn't that be A non-capturing version of regular parentheses. ? It still groups; it just doesn't capture. Keith

2 1

[issue10224] Build 3.x documentation using python3.x
by Georg Brandl 29 Oct '10

29 Oct '10

Georg Brandl <georg(a)python.org> added the comment: In r85910, I ported the Python-specific modules in tools/ so that they don't need to be 2to3-converted. Now you can basically easy_install Sphinx on 3.1 and run its sphinx-build without touching the Doc/ tree. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue10224> _______________________________________

1 0

[issue10224] Build 3.x documentation using python3.x
by Georg Brandl 29 Oct '10

29 Oct '10

Georg Brandl <georg(a)python.org> added the comment: I fixed that bug in Sphinx rev 49747f5b0c70 (which I will push as soon as bitbucket is up again); incremental build now works for me. ---------- versions: +Python 3.3 -Python 3.2 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue10224> _______________________________________

1 0

[issue10224] Build 3.x documentation using python3.x
by Alexander Belopolsky 29 Oct '10

29 Oct '10

Alexander Belopolsky <belopolsky(a)users.sourceforge.net> added the comment: Incremental build was not that successful. After editing Doc/faq/programming.rst, I get the following in the error log: # Sphinx version: 1.1pre # Python version: 3.2a3+.0 # Docutils version: 0.7 release # Jinja2 version: 2.5.5 Traceback (most recent call last): File "/Users/sasha/Apps/lib/python3.2/site-packages/Sphinx-1.1predev_20101028-py3.2.egg/sphinx/cmdline.py", line 173, in main app.build(force_all, filenames) File "/Users/sasha/Apps/lib/python3.2/site-packages/Sphinx-1.1predev_20101028-py3.2.egg/sphinx/application.py", line 203, in build self.builder.build_update() File "/Users/sasha/Apps/lib/python3.2/site-packages/Sphinx-1.1predev_20101028-py3.2.egg/sphinx/builders/__init__.py", line 193, in build_update 'out of date' % len(to_build)) File "/Users/sasha/Apps/lib/python3.2/site-packages/Sphinx-1.1predev_20101028-py3.2.egg/sphinx/builders/__init__.py", line 249, in build self.write(docnames, list(updated_docnames), method) File "/Users/sasha/Apps/lib/python3.2/site-packages/Sphinx-1.1predev_20101028-py3.2.egg/sphinx/builders/__init__.py", line 279, in write self.prepare_writing(docnames) File "/Users/sasha/Apps/lib/python3.2/site-packages/Sphinx-1.1predev_20101028-py3.2.egg/sphinx/builders/html.py", line 231, in prepare_writing self.load_indexer(docnames) File "/Users/sasha/Apps/lib/python3.2/site-packages/Sphinx-1.1predev_20101028-py3.2.egg/sphinx/builders/html.py", line 619, in load_indexer self.indexer.load(f, self.indexer_format) File "/Users/sasha/Apps/lib/python3.2/site-packages/Sphinx-1.1predev_20101028-py3.2.egg/sphinx/search.py", line 131, in load frozen = format.load(stream) File "/Users/sasha/Apps/lib/python3.2/site-packages/Sphinx-1.1predev_20101028-py3.2.egg/sphinx/search.py", line 64, in load return self.loads(f.read()) File "/Users/sasha/Apps/lib/python3.2/site-packages/Sphinx-1.1predev_20101028-py3.2.egg/sphinx/search.py", line 55, in loads if not data or not s.startswith(self.PREFIX) or not \ TypeError: expected an object with the buffer interface ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue10224> _______________________________________

1 0

[issue10224] Build 3.x documentation using python3.x
by Alexander Belopolsky 28 Oct '10

28 Oct '10

Alexander Belopolsky <belopolsky(a)users.sourceforge.net> added the comment: I had some success after running 2to3 on Doc/conf.py and Doc/tools. The build succeeded, but I have not compared the output yet. Running doctest, however, still reported lots of errors and hang in turtle.rst. $ sphinx-build -b doctest -d Doc/build3/doctrees -D latex_paper_size= Doc Doc/build3/html ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue10224> _______________________________________

1 0