[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 (Comment added) made by fdrake
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: Aahz (aahz)
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: Fred L. Drake, Jr. (fdrake)
Date: 2003-09-23 18:01

Message:
Logged In: YES 
user_id=3066

Tim sent this back to Aahz, so I'm assigning it to him as a

reminder.

;-)

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

Comment By: Tim Peters (tim_one)
Date: 2003-04-25 15: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