[Patches] [ python-Patches-1156102 ] exception doc updates

[SourceForge.net]

Patches item #1156102, was opened at 2005-03-03 18:57
Message generated for change (Comment added) made by mwh
You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=305470&aid=1156102&group_id=5470

Category: Documentation
Group: Python 2.5
>Status: Closed
Resolution: Accepted
Priority: 5
Submitted By: Michael Hudson (mwh)
Assigned to: Michael Hudson (mwh)
Summary: exception doc updates

Initial Comment:
I was going to bang on the exception docs until I discovered that 
they are already somewhat out-of-date.  This updates the reference 
manual to describe exceptions with the presumption that class 
exceptions are the default, and string exceptions are subsidiary and 
deprecated.

I'll probably check this in soon unless someone complains :) 

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

>Comment By: Michael Hudson (mwh)
Date: 2005-03-04 14:35

Message:
Logged In: YES 
user_id=6656

Done, in:

ref4.tex revision 1.38
ref7.tex revision 1.43


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

Comment By: Martin v. Löwis (loewis)
Date: 2005-03-04 14:25

Message:
Logged In: YES 
user_id=21627

I see. This is fine; please apply.

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

Comment By: Michael Hudson (mwh)
Date: 2005-03-04 10:21

Message:
Logged In: YES 
user_id=6656

If you mean the "if it's an instance, then ..., if it's a
tuple then ... if it's anything else then..." stuff, that's
described in the section on raise, which is where it belongs
IMHO.  By the time the exception has been raised, it really
is described (conceptually, at least) by the instance.

I've rephrased the first affected paragraph a bit (attached).

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

Comment By: Martin v. Löwis (loewis)
Date: 2005-03-03 22:25

Message:
Logged In: YES 
user_id=21627

Overall, the patch looks fine. One note though:  in the
first chunk, what about the information that you can also
pass an object in the raise, in addition to the type?

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

You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=305470&aid=1156102&group_id=5470