[Python-bugs-list] [ python-Bugs-532467 ] 6.9 The raise statement is confusing
noreply@sourceforge.net
noreply@sourceforge.net
Wed, 15 May 2002 21:10:25 -0700
Bugs item #532467, was opened at 2002-03-20 08:37
You can respond by visiting:
http://sourceforge.net/tracker/?func=detail&atid=105470&aid=532467&group_id=5470
Category: Documentation
Group: Python 2.2
Status: Open
Resolution: None
Priority: 5
Submitted By: Patrick K. O'Brien (pobrien)
Assigned to: Fred L. Drake, Jr. (fdrake)
Summary: 6.9 The raise statement is confusing
Initial Comment:
The description supplied for "6.9 The raise statement"
is confusing. In particular, it starts by explaining
the intent of each "expresssion" and midway switches
to "object" instead of expression. In particular, I
can't make heads or tails out of the following passage:
"If the first object is a string, it then raises the
exception identified by the first object, with the
second one (or None) as its parameter. If the first
object is a class or instance, it raises the exception
identified by the class of the instance determined in
the previous step, with the instance as its parameter."
----------------------------------------------------------------------
>Comment By: Raymond Hettinger (rhettinger)
Date: 2002-05-15 23:10
Message:
Logged In: YES
user_id=80475
Attached two alternative patches.
The first makes minimal changes to achieve a clear and
consistent use of "objects" versus "expressions".
The second alternative re-paragraphs the text and uses
parallel sentence contruction to provide (IMHO)
greater clarity without getting a headache reading it.
If accepted, please re-assign to Raymond for a commit to
2.3 and to release22-maint.
----------------------------------------------------------------------
You can respond by visiting:
http://sourceforge.net/tracker/?func=detail&atid=105470&aid=532467&group_id=5470