[Python-bugs-list] [ python-Bugs-654783 ] doctest and exception messages

[SourceForge.net]

Bugs item #654783, was opened at 2002-12-16 14:23
Message generated for change (Settings changed) made by rhettinger
You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=105470&aid=654783&group_id=5470

Category: Documentation
Group: Python 2.2.2
Status: Open
Resolution: None
Priority: 5
Submitted By: Aahz (aahz)
>Assigned to: Raymond Hettinger (rhettinger)
Summary: doctest and exception messages

Initial Comment:
doctest should include information something like this:

    doctest docstrings should not rely on the text of internal Python
    exceptions.  Notice the way factorial() uses its own error messages
    with the standard Python exceptions.  The internal messages can
    change even in bugfix releases (as in 2.2.1 to 2.2.2).


----------------------------------------------------------------------

Comment By: Tim Peters (tim_one)
Date: 2003-04-25 14:08

Message:
Logged In: YES 
user_id=31435

Back to Aahz.  I don't mind if you change this -- edit the docs 
and check it in.

----------------------------------------------------------------------

Comment By: Tim Peters (tim_one)
Date: 2002-12-16 18:39

Message:
Logged In: YES 
user_id=31435

It could, but it shouldn't:  error msgs in docs that don't match 
reality are also an insult to users.  doctest should grow some 
sort of option here, though, as its uses outgrew its original 
purposes.

----------------------------------------------------------------------

Comment By: Neil Schemenauer (nascheme)
Date: 2002-12-16 17:01

Message:
Logged In: YES 
user_id=35752

Couldn't doctest be modified so that it only compares the
exception
name only?

----------------------------------------------------------------------

You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=105470&aid=654783&group_id=5470