[docs] [issue15629] Add to regrtest the ability to run Lib and Doc doctests

Antoine Pitrou report at bugs.python.org
Mon Sep 17 14:30:50 CEST 2012


Antoine Pitrou added the comment:

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.

----------
nosy: +pitrou

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue15629>
_______________________________________


More information about the docs mailing list