This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

classification
Title: doctest and exception messages
Type: Stage:
Components: Documentation Versions: Python 2.2
process
Status: closed Resolution: wont fix
Dependencies: Superseder:
Assigned To: aahz Nosy List: aahz, facundobatista, fdrake, nascheme, tim.peters
Priority: normal Keywords:

Created on 2002-12-16 19:23 by aahz, last changed 2022-04-10 16:06 by admin. This issue is now closed.

Messages (8)
msg13629 - (view) Author: Aahz (aahz) * (Python triager) Date: 2002-12-16 19:23
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).
msg13630 - (view) Author: Neil Schemenauer (nascheme) * (Python committer) Date: 2002-12-16 22:01
Logged In: YES 
user_id=35752

Couldn't doctest be modified so that it only compares the
exception
name only?
msg13631 - (view) Author: Tim Peters (tim.peters) * (Python committer) Date: 2002-12-16 23:39
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.
msg13632 - (view) Author: Tim Peters (tim.peters) * (Python committer) Date: 2003-04-25 19:08
Logged In: YES 
user_id=31435

Back to Aahz.  I don't mind if you change this -- edit the docs 
and check it in.
msg13633 - (view) Author: Fred Drake (fdrake) (Python committer) Date: 2003-09-23 22:01
Logged In: YES 
user_id=3066

Tim sent this back to Aahz, so I'm assigning it to him as a
reminder.
;-)
msg13634 - (view) Author: Facundo Batista (facundobatista) * (Python committer) Date: 2005-01-11 03:30
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
msg13635 - (view) Author: Facundo Batista (facundobatista) * (Python committer) Date: 2005-01-11 03:30
Logged In: YES 
user_id=752496

What should change Aahz in the docs? Not clear to me...
msg13636 - (view) Author: Facundo Batista (facundobatista) * (Python committer) Date: 2005-05-30 20:05
Logged In: YES 
user_id=752496

Deprecated. Reopen only if still happens in 2.3 or newer. 

.    Facundo
History
Date User Action Args
2022-04-10 16:06:02adminsetgithub: 37618
2002-12-16 19:23:49aahzcreate