This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author pitrou
Recipients aliles, asvetlov, brett.cannon, chris.jerdonek, docs@python, eli.bendersky, eric.araujo, ezio.melotti, georg.brandl, pitrou, r.david.murray, sbt, terry.reedy, v+python
Date 2012-09-17.12:30:49
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1347885050.5.0.0338961722505.issue15629@psf.upfronthosting.co.za>
In-reply-to
Content
I think I'm -1 to run doctests as part of regrtest. Documentation examples are meant to be read, not executed: it is fine for them to omit unimportant information or trivial boilerplate (such as imports).

Any complication in the way doc examples must be written will deter us from actually writing examples.

Furthermore, spreading unit tests in the doc files instead of Lib/test files will make maintenance of tests more tedious as well.
History
Date User Action Args
2012-09-17 12:30:50pitrousetrecipients: + pitrou, brett.cannon, georg.brandl, terry.reedy, ezio.melotti, eric.araujo, v+python, r.david.murray, eli.bendersky, asvetlov, chris.jerdonek, docs@python, sbt, aliles
2012-09-17 12:30:50pitrousetmessageid: <1347885050.5.0.0338961722505.issue15629@psf.upfronthosting.co.za>
2012-09-17 12:30:50pitroulinkissue15629 messages
2012-09-17 12:30:49pitroucreate