[issue10225] Fix doctest runable examples in python manual
Terry J. Reedy <tjreedy@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 digest at once. I extracted the part for howto/sorting.rst and tried to apply to 3.2, but the file has changed too much (at least for TortoiseSVN). So I pasted the '... 's (and adjusted spacing) where needed, and did the two other changes you had. This left just two failures -- for the 2.7 code using 'cmp=xxx' args. With '# doctest: +SKIP' added twice, doctest passes. Patch commited for 3.2 as r87946.
instances when human and computer reader's interests are in conflict. What is one (or more) that you were thinking of?
---------- _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue10225> _______________________________________
Alexander Belopolsky <belopolsky@users.sourceforge.net> added the comment: On Tue, Jan 11, 2011 at 6:10 PM, Terry J. Reedy <report@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 #10875 where is was very helpful. So your last comment puzzles me.
Sphinx doctest runner supports doctest fixtures that plain doctest does not. Some of the examples in the docs rely on these. See http://sphinx.pocoo.org/ext/doctest.html . ---------- _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue10225> _______________________________________
participants (2)
-
Alexander Belopolsky
-
Terry J. Reedy