[Python-Dev] Unit testing (again)

[Guido van Rossum]

> 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/)