[issue10225] Fix doctest runable examples in python manual

[Alexander Belopolsky]

Changes by Alexander Belopolsky :


--
assignee: belopolsky -> 

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue10225] Fix doctest runable examples in python manual

[Berker Peksag]

Changes by Berker Peksag :


--
nosy: +andymaier, belopolsky, docs@python, eric.araujo, ezio.melotti, 
georg.brandl, lukasz.langa, rhettinger, terry.reedy -lissacoffeyx

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue10225] Fix doctest runable examples in python manual

[Berker Peksag]

Changes by Berker Peksag :


--
Removed message: http://bugs.python.org/msg270297

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue10225] Fix doctest runable examples in python manual

[lissacoffeyx]

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, eric.araujo, 
ezio.melotti, georg.brandl, lukasz.langa, rhettinger, terry.reedy

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue10225] Fix doctest runable examples in python manual

[Terry J. Reedy]

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
http://bugs.python.org/issue10225
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue10225] Fix doctest runable examples in python manual

[Andy Maier]

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 tracker rep...@bugs.python.org
http://bugs.python.org/issue10225
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue10225] Fix doctest runable examples in python manual

[Ezio Melotti]

Changes by Ezio Melotti ezio.melo...@gmail.com:


--
nosy: +ezio.melotti

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue10225
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue10225] Fix doctest runable examples in python manual

[Alexander Belopolsky]

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 the named tuple 
template?

--

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue10225
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue10225] Fix doctest runable examples in python manual

[Raymond Hettinger]

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 newlines instead of '\n'.   The template has been 
considerably beautified for python 3.3, but I don't want to go back in time and 
muck with stable code just to accommodate adding a doctest in old docs.

--

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue10225
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue10225] Fix doctest runable examples in python manual

[Raymond Hettinger]

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.

--
assignee: rhettinger - belopolsky
resolution:  - accepted
versions: +Python 3.3

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue10225
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue10225] Fix doctest runable examples in python manual

[Alexander Belopolsky]

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 clearly 
intended to be doctest-checked.  Of course, there are many perfectly good code 
examples that are now skipped, but this can be addressed in the next step.

I am attaching a patch that makes the following command succeed in py3k Doc 
directory:

$ sphinx-build --version
Sphinx v1.1pre
..
$ sphinx-build -b doctest -d build/doctrees . build/doctest
..
Doctest summary
===
  581 tests
0 failures ..

Most of the changes in issue10225-py3k.diff are non-controvercial with the 
exception of code fixes in collections and difflib.

In collections, I removed trailing whitespace from generated namedtuple code 
and in difflib I changed get_close_matches() return value from map object to a 
list.   I would appreciate comments on these two changes.

--
Added file: http://bugs.python.org/file20375/issue10225-py3k.diff

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue10225
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue10225] Fix doctest runable examples in python manual

[Alexander Belopolsky]

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
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue10225] Fix doctest runable examples in python manual

[Alexander Belopolsky]

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
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue10225] Fix doctest runable examples in python manual

[Alexander Belopolsky]

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 tracker rep...@bugs.python.org
http://bugs.python.org/issue10225
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue10225] Fix doctest runable examples in python manual

[Alexander Belopolsky]

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
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue10225] Fix doctest runable examples in python manual

[Terry J. Reedy]

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 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 rep...@bugs.python.org
http://bugs.python.org/issue10225
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue10225] Fix doctest runable examples in python manual

[Alexander Belopolsky]

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 #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 rep...@bugs.python.org
http://bugs.python.org/issue10225
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue10225] Fix doctest runable examples in python manual

[Raymond Hettinger]

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 ... 
PS1 and PS2 prompts and they can no longer be readily cut and pasted into the 
interpreter so that people can experiment with them.

--
nosy: +rhettinger

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue10225
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue10225] Fix doctest runable examples in python manual

[Terry J. Reedy]

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 doc (probably original; my fixes were 
augmented and committed by GB, I believe), and several in the re howto (due to 
non-update after re changes). There have been other error reports on the 
tracker and I presume more (other than missing '...') shown in AB's patch. (I 
just started with the first file changed in the patch.) So I thought it pretty 
well settled that getting doc examples correct (and test-ready) is be a good 
idea.

2. Examples with output always start with ' ' to differentiate input from 
output. I thought it pretty standard that continuation lines start with '... '. 
This is true of all applicable examples in re howto, module chapters for 
difflib, json, bisect, and 4 of 5 applicable examples in the Built-in Types 
chapter. Other chapters for binhex, itertools, and tkinter have no multiline 
interactive examples, so provide no precedent either way.

What is the alternative? The current sorting howto is not consistent:

For some examples, '... ' is just deleted:
 student_tuples = [
('john', 'A', 15),
('jane', 'B', 12),
('dave', 'B', 10),
]

For others, '... ' is replaced with '':
 class Student:
def __init__(self, name, grade, age):
self.name = name
self.grade = grade
self.age = age

The cmp_to_key function def is a special case: there is no output in the same 
box with the def and so (normally) should not have prompts. The only reason I 
followed AB's patch here and added them is because the definition is used in 
the next box. If the next example were changed for 3.2 to use the new-in-3.2  
functools.cmp_to_key(), then the def would not be needed.  (I already planned 
to suggest thisOr the followup example could just be marked SKIP. With either 
change, I would remove the prompts added to this function, which are the ones I 
presume bother you the most.


Summary: according to my current (and subject-to-update ;-) understanding of 
precedent and policy, the changes other than for cmp_to_key seem correct. The 
rationale for cmp_to_key changes could easily be negated, in which case they 
should be reverted.

I will put my thoughts on cut-and-paste in a separate message.

--
nosy: +georg.brandl

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue10225
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue10225] Fix doctest runable examples in python manual

[Raymond Hettinger]

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 
consistency not withstanding).

--

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue10225
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue10225] Fix doctest runable examples in python manual

[Alexander Belopolsky]

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 tools/sphinx-build.py -b doctest -d build/doctrees .
build/doctest howto/sorting.rst
...

Doctest summary
===
   34 tests
0 failures in tests
0 failures in setup code
build succeeded.

Unfortunately, Sphinx does not support Ramond's preferred style, but
my patch comes close.

--
Added file: http://bugs.python.org/file20359/sorting-howto.diff

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue10225
___Index: howto/sorting.rst
===
--- howto/sorting.rst   (revision 87942)
+++ howto/sorting.rst   (working copy)
@@ -58,30 +58,44 @@
 A common pattern is to sort complex objects using some of the object's indices
 as keys. For example:
 
- student_tuples = [
+.. testcode::
+
+student_tuples = [
 ('john', 'A', 15),
 ('jane', 'B', 12),
 ('dave', 'B', 10),
 ]
- sorted(student_tuples, key=lambda student: student[2])   # sort by age
+
+Sort by age:
+
+.. doctest::
+
+ sorted(student_tuples, key=lambda student: student[2])
 [('dave', 'B', 10), ('jane', 'B', 12), ('john', 'A', 15)]
 
 The same technique works for objects with named attributes. For example:
 
- class Student:
-def __init__(self, name, grade, age):
-self.name = name
-self.grade = grade
-self.age = age
-def __repr__(self):
-return repr((self.name, self.grade, self.age))
+.. testcode::
 
- student_objects = [
+class Student:
+def __init__(self, name, grade, age):
+self.name = name
+self.grade = grade
+self.age = age
+def __repr__(self):
+return repr((self.name, self.grade, self.age))
+
+student_objects = [
 Student('john', 'A', 15),
 Student('jane', 'B', 12),
 Student('dave', 'B', 10),
 ]
- sorted(student_objects, key=lambda student: student.age)   # sort by 
age
+
+Sort by age:
+
+.. doctest::
+
+ sorted(student_objects, key=lambda student: student.age)
 [('dave', 'B', 10), ('jane', 'B', 12), ('john', 'A', 15)]
 
 Operator Module Functions
@@ -210,22 +224,34 @@
 return a negative value for less-than, return zero if they are equal, or return
 a positive value for greater-than. For example, we can do:
 
- def numeric_compare(x, y):
-return x - y
+.. testcode::
+
+def numeric_compare(x, y):
+return x - y
+
+.. doctest::
+
  sorted([5, 2, 4, 1, 3], cmp=numeric_compare)
 [1, 2, 3, 4, 5]
 
 Or you can reverse the order of comparison with:
 
- def reverse_numeric(x, y):
-return y - x
+.. testcode::
+
+def reverse_numeric(x, y):
+return y - x
+
+.. doctest::
+
  sorted([5, 2, 4, 1, 3], cmp=reverse_numeric)
 [5, 4, 3, 2, 1]
 
 When porting code from Python 2.x to 3.x, the situation can arise when you have
 the user supplying a comparison function and you need to convert that to a key
-function. The following wrapper makes that easy to do::
+function. The following wrapper makes that easy to do:
 
+.. testcode::
+
 def cmp_to_key(mycmp):
 'Convert a cmp= function into a key= function'
 class K(object):
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue10225] Fix doctest runable examples in python manual

[Raymond Hettinger]

Changes by Raymond Hettinger rhettin...@users.sourceforge.net:


--
assignee: belopolsky - rhettinger

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue10225
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue10225] Fix doctest runable examples in python manual

[Alexander Belopolsky]

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, I ran into a bug in the alpha version of
sphinx that I used to validate py3k docs.

 What sort of feedback do you want? Proofreading of text? Recheck of doctest?


All of the above.  Some of the fixes may be at the expense of
readability.   I would appreciate feedback in the instances when human
and computer reader's interests are in conflict.   Some examples are
fixed by excluding them from being checked.  Better ideas are
welcome.

 Does sphinx suppress doctest comments like
     #doctest: +IGNORE_EXCEPTION_DETAIL
 ?

Yes.


 doctest.testfile(C:/programs/PyDev/py32/Doc/howto/sorting.rst, 
 module_relative = False)
 fails 23 of 37 attempts, so improvement is needed ;-).

You cannot run documentation examples with a plain doctest.   You have
to use sphinx-build.

--

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue10225
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue10225] Fix doctest runable examples in python manual

[Terry J. Reedy]

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 doctest comments like
 #doctest: +IGNORE_EXCEPTION_DETAIL
?

doctest.testfile(C:/programs/PyDev/py32/Doc/howto/sorting.rst, 
module_relative = False) fails 23 of 37 attempts, so improvement is needed ;-).

--
nosy: +terry.reedy

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue10225
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue10225] Fix doctest runable examples in python manual

[Łukasz Langa]

Changes by Łukasz Langa luk...@langa.pl:


--
nosy: +lukasz.langa

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue10225
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue10225] Fix doctest runable examples in python manual

[Alexander Belopolsky]

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 3.1

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue10225
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue10225] Fix doctest runable examples in python manual

[Alexander Belopolsky]

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
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue10225] Fix doctest runable examples in python manual

[Alexander Belopolsky]

Changes by Alexander Belopolsky belopol...@users.sourceforge.net:


--
nosy: +d...@python

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue10225
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue10225] Fix doctest runable examples in python manual

[Alexander Belopolsky]

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 patch - patch review
Added file: http://bugs.python.org/file19413/issue10225a-r27.diff

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue10225
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue10225] Fix doctest runable examples in python manual

[Alexander Belopolsky]

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
..
**
File library/traceback.rst, line 327, in default
..

Differences (ndiff with -expected +actual):
  *** print_tb:
-   File doctest..., line 10, in module
? ^^^
+   File doctest default[0], line 10, in module
? ^^^
  lumberjack()

(I added +REPORT_NDIFF to testoutput options for clarity.)

I even tried adding +ELLIPSIS to options, but this did not help.  The same 
example works in 2.7.

--

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue10225
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue10225] Fix doctest runable examples in python manual

[Alexander Belopolsky]

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 validate 
examples in ReST documentation.

--
assignee: belopolsky
components: Documentation
messages: 119840
nosy: belopolsky
priority: normal
severity: normal
stage: needs patch
status: open
title: Fix doctest runable examples in python manual
versions: Python 3.2

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue10225
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue10225] Fix doctest runable examples in python manual

[Alexander Belopolsky]

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
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue10225] Fix doctest runable examples in python manual

[Éric Araujo]

É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 rep...@bugs.python.org
http://bugs.python.org/issue10225
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue10225] Fix doctest runable examples in python manual

[Alexander Belopolsky]

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 2to3 on Doc/conf.py and Doc/tools first.

--

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue10225
___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com