[issue10225] Fix doctest runable examples in python manual

Changes by Alexander Belopolsky : -- assignee: belopolsky -> ___ Python tracker ___

[issue10225] Fix doctest runable examples in python manual

Changes by Berker Peksag : -- nosy: +andymaier, belopolsky, docs@python, eric.araujo, ezio.melotti, georg.brandl, lukasz.langa, rhettinger, terry.reedy -lissacoffeyx ___ Python tracker

[issue10225] Fix doctest runable examples in python manual

Changes by Berker Peksag : -- Removed message: http://bugs.python.org/msg270297 ___ Python tracker ___

[issue10225] Fix doctest runable examples in python manual

lissacoffeyx added the comment: I had a thought that it made the template more readable, but the better solution was to just use real newlines instead of '\n'. Thanks http://www.fixithere.net/sky-customer-service/ -- nosy: +lissacoffeyx -andymaier, belopolsky, docs@python,

[issue10225] Fix doctest runable examples in python manual

Terry J. Reedy added the comment: For whatever difference it makes, the 3.x docs now *are* being built with 3.x. -- versions: +Python 3.4, Python 3.5 -Python 3.1, Python 3.2, Python 3.3 ___ Python tracker rep...@bugs.python.org

[issue10225] Fix doctest runable examples in python manual

Andy Maier added the comment: Hi, I would like to revive this issue and have added a review comment to issue10225-py3k.diff. Otherwise, I have reviewed the changes in both diffs and think they are good to go. Andy -- nosy: +andymaier ___ Python

[issue10225] Fix doctest runable examples in python manual

Changes by Ezio Melotti ezio.melo...@gmail.com: -- nosy: +ezio.melotti ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue10225 ___ ___

[issue10225] Fix doctest runable examples in python manual

Alexander Belopolsky belopol...@users.sourceforge.net added the comment: Please leave the deployed code for named tuple as-is. Doctest may have issues with trailing whitespace, but that is doctest's problem, not named tuple's. I am curious, what was the reason to add trailing whitespace in

[issue10225] Fix doctest runable examples in python manual

Raymond Hettinger raymond.hettin...@gmail.com added the comment: I am curious, what was the reason to add trailing whitespace in the named tuple template? To make it hard to doctest ;-) I had a thought that it made the template more readable, but the better solution was to just use real

[issue10225] Fix doctest runable examples in python manual

Raymond Hettinger raymond.hettin...@gmail.com added the comment: These are fine except for the changes to collections.py. Please leave the deployed code for named tuple as-is. Doctest may have issues with trailing whitespace, but that is doctest's problem, not named tuple's. --

[issue10225] Fix doctest runable examples in python manual

Alexander Belopolsky belopol...@users.sourceforge.net added the comment: I have updated Sphinx and rerun py3k doctests. It looks like the newest Sphinx does not check examples unless the file has a .. testsetup:: directive somewhere. This is nice because it focuses on the files that are

[issue10225] Fix doctest runable examples in python manual

Changes by Alexander Belopolsky belopol...@users.sourceforge.net: Added file: http://bugs.python.org/file20376/issue10225-py3k.diff ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue10225 ___

[issue10225] Fix doctest runable examples in python manual

Changes by Alexander Belopolsky belopol...@users.sourceforge.net: Removed file: http://bugs.python.org/file20375/issue10225-py3k.diff ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue10225 ___

[issue10225] Fix doctest runable examples in python manual

Alexander Belopolsky belopol...@users.sourceforge.net added the comment: Committed the simple fixes in r87957. Updated the patch to include only the remaining changes. -- Added file: http://bugs.python.org/file20377/issue10225-py3k.diff ___ Python

[issue10225] Fix doctest runable examples in python manual

Changes by Alexander Belopolsky belopol...@users.sourceforge.net: Removed file: http://bugs.python.org/file20376/issue10225-py3k.diff ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue10225 ___

[issue10225] Fix doctest runable examples in python manual

Terry J. Reedy tjre...@udel.edu added the comment: Doctest runs on .rst files, which are plain text files, finds and reports errors, and reports no errors when the errors are fixed. See #10875 where is was very helpful. So your last comment puzzles me. In any case, your patch is too big to

[issue10225] Fix doctest runable examples in python manual

Alexander Belopolsky belopol...@users.sourceforge.net added the comment: On Tue, Jan 11, 2011 at 6:10 PM, Terry J. Reedy rep...@bugs.python.org wrote: .. Doctest runs on .rst files, which are plain text files, finds and reports errors, and reports no errors when the errors are fixed. See

[issue10225] Fix doctest runable examples in python manual

Raymond Hettinger rhettin...@users.sourceforge.net added the comment: Terry, I'm unhappy with the changes to the sorting how-to. IMO, it was a not a net win (transforming code that already ran fine in something doctest would swallow). The code snippets now have the visual clutter of the and

[issue10225] Fix doctest runable examples in python manual

Terry J. Reedy tjre...@udel.edu added the comment: There are two reasons I forward ported the changes. 1. Without running doctest on doc examples, they sometimes have errors either originally, after patches to the doc, or after patches to Python. On other issues, I found 4 errors in the json

[issue10225] Fix doctest runable examples in python manual

Raymond Hettinger rhettin...@users.sourceforge.net added the comment: You're welcome to discuss this with me on IRC at some point. For now, the important thing is that I put a good deal of time and effort working on the sorting howto and I like it as it stands (your notions of precedent or

[issue10225] Fix doctest runable examples in python manual

Alexander Belopolsky belopol...@users.sourceforge.net added the comment: On Tue, Jan 11, 2011 at 10:03 PM, Terry J. Reedy rep...@bugs.python.org wrote: .. What is the alternative? I am attaching an alternative patch for sorting howto. You can run the doctests in it as follows: $ python2.7

[issue10225] Fix doctest runable examples in python manual

Changes by Raymond Hettinger rhettin...@users.sourceforge.net: -- assignee: belopolsky - rhettinger ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue10225 ___

[issue10225] Fix doctest runable examples in python manual

Alexander Belopolsky belopol...@users.sourceforge.net added the comment: On Sun, Jan 9, 2011 at 3:52 PM, Terry J. Reedy rep...@bugs.python.org wrote: .. It would be nice to get the fixes into 3.2. Yes, it would be nice, but I don't have a 3.2 patch (yet). As you can see from my last comment,

[issue10225] Fix doctest runable examples in python manual

Terry J. Reedy tjre...@udel.edu added the comment: As I understand this, your patch would fix numerous errors in the docs, but has not been applied. It would be nice to get the fixes into 3.2. What sort of feedback do you want? Proofreading of text? Recheck of doctest? Does sphinx suppress

[issue10225] Fix doctest runable examples in python manual

Changes by Łukasz Langa luk...@langa.pl: -- nosy: +lukasz.langa ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue10225 ___ ___ Python-bugs-list

[issue10225] Fix doctest runable examples in python manual

Alexander Belopolsky belopol...@users.sourceforge.net added the comment: I started with 2.7 branch because some of the issues are the same there, but the tools work better at the moment. I a posting a work-in-progress patch to solicit early feedback. -- versions: +Python 2.7, Python

[issue10225] Fix doctest runable examples in python manual

Changes by Alexander Belopolsky belopol...@users.sourceforge.net: -- keywords: +patch Added file: http://bugs.python.org/file19409/issue10225-r27.diff ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue10225

[issue10225] Fix doctest runable examples in python manual

Changes by Alexander Belopolsky belopol...@users.sourceforge.net: -- nosy: +d...@python ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue10225 ___

[issue10225] Fix doctest runable examples in python manual

Alexander Belopolsky belopol...@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

[issue10225] Fix doctest runable examples in python manual

Alexander Belopolsky belopol...@users.sourceforge.net added the comment: I started porting the patch to 3.x and it looks like I've uncovered another bug in sphinx: $ sphinx-build -b doctest -d build/doctrees . build/doctest library/traceback.rst ..

[issue10225] Fix doctest runable examples in python manual

New submission from Alexander Belopolsky belopol...@users.sourceforge.net: As noted in issue 10224, python 3.x documentation is not being built with python 3.x yet, so a simple cd Doc; make doctest does not work. However, hg trunk version os sphinx works with python 3.x and can be used to

[issue10225] Fix doctest runable examples in python manual

Changes by Alexander Belopolsky belopol...@users.sourceforge.net: -- dependencies: +Build 3.x documentation using python3.x ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue10225 ___

[issue10225] Fix doctest runable examples in python manual

Éric Araujo mer...@netwok.org added the comment: hg trunk version [of] sphinx works with python 3.x and can be used to validate examples in ReST documentation. How do you replace “make doctest”? -- nosy: +eric.araujo ___ Python tracker

[issue10225] Fix doctest runable examples in python manual

Alexander Belopolsky belopol...@users.sourceforge.net added the comment: On Thu, Oct 28, 2010 at 10:20 PM, Éric Araujo rep...@bugs.python.org wrote: How do you replace “make doctest”? $ sphinx-build -b html -d Doc/build3/doctrees -D latex_paper_size= Doc Doc/build3/html but I had to run