doctest and exception messages

[aahz]

BPO	654783
Nosy	@tim-one, @freddrake, @nascheme, @facundobatista

^{Note: these values reflect the state of the issue at the time it was migrated and might not reflect the current state.}

Show more details

GitHub fields:

assignee = None
closed_at = <Date 2005-05-30.20:05:35.000>
created_at = <Date 2002-12-16.19:23:49.000>
labels = ['docs']
title = 'doctest and exception messages'
updated_at = <Date 2005-05-30.20:05:35.000>
user = 'https://bugs.python.org/aahz'

bugs.python.org fields:

activity = <Date 2005-05-30.20:05:35.000>
actor = 'facundobatista'
assignee = 'aahz'
closed = True
closed_date = None
closer = None
components = ['Documentation']
creation = <Date 2002-12-16.19:23:49.000>
creator = 'aahz'
dependencies = []
files = []
hgrepos = []
issue_num = 654783
keywords = []
message_count = 8.0
messages = ['13629', '13630', '13631', '13632', '13633', '13634', '13635', '13636']
nosy_count = 5.0
nosy_names = ['tim.peters', 'fdrake', 'nascheme', 'facundobatista', 'aahz']
pr_nums = []
priority = 'normal'
resolution = 'wont fix'
stage = None
status = 'closed'
superseder = None
type = None
url = 'https://bugs.python.org/issue654783'
versions = ['Python 2.2']

[aahz]

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

[nascheme]

Logged In: YES
user_id=35752

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

[tim-one]

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.

[tim-one]

Logged In: YES
user_id=31435

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

[freddrake]

Logged In: YES
user_id=3066

Tim sent this back to Aahz, so I'm assigning it to him as a
reminder.
;-)

[facundobatista]

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

[facundobatista]

Logged In: YES
user_id=752496

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

[facundobatista]

Logged In: YES
user_id=752496

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

. Facundo