[Python-Dev] Unit testing (again)
Guido van Rossum
guido@digicool.com
Tue, 13 Feb 2001 16:45:56 -0500
> Not to my mind. doctest is intentionally picky about exact matches, for
> reasons explained earlier. If the docs for a thing say "integer division or
> modulo by zero" is expected, but running it says something else, the docs
> are wrong and doctest's primary *purpose* is to point that out loudly.
Of course, this is means that *if* you use doctest, all authoritative
docs should be in the docstring, and not elsewhere. Which brings us
back to the eternal question of how to indicate mark-up in
docstrings. Is everything connected to everything?
--Guido van Rossum (home page: http://www.python.org/~guido/)