[ python-Bugs-654783 ] doctest and exception messages

[SourceForge.net]

Bugs item #654783, was opened at 2002-12-16 16:23
Message generated for change (Comment added) made by facundobatista
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: Facundo Batista (facundobatista)
Date: 2005-01-11 00:30

Message:
Logged In: YES 
user_id=752496

What should change Aahz in the docs? Not clear to me...

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

Comment By: Facundo Batista (facundobatista)
Date: 2005-01-11 00:30

Message:
Logged In: YES 
user_id=752496

Please, could you verify if this problem persists in Python 2.3.4
or 2.4?

If yes, in which version? Can you provide a test case?

If the problem is solved, from which version?

Note that if you fail to answer in one month, I'll close this bug
as "Won't fix".

Thank you! 

.    Facundo

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

Comment By: Fred L. Drake, Jr. (fdrake)
Date: 2003-09-23 19: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 16: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 20: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 19: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