I have always found the docs dealing with the target as found in 
'except' clauses misleading::

    try:
        raise Exception('argument 1')
    except Exception, x:
        print type(x)

This code outputs ``<type 'instance'>`` while I would have expected 
``<type 'str'>`` from the way the docs read (at least to me).  So I 
tried to clarify this in the tutorial and references (Doc/tut/tut.tex and 
Doc/ref/ref7.tex respectively).  If people think I am nuts and people 
don't get confused by the fact that having a single 
target gets the exception instance assigned to it while a tuple of 
targets gets the exception to unpack its arg values through iterating 
over them with the way the docs are now, then I guess I am nuts.  =)

Regardless of the final outcome of this patch, the result will close/
reject bug #675928 .

Logged In: YES 
user_id=3066

There's definately a shortcoming in those docs; they really
still assume the world of string exceptions.

The patch, on the other hand, somewhat assumes a world of
class-based exceptions.  The reality is a bit more
conflated; I'll see what I can do about it, but I don't
think the patch as it stands is really right either.

Logged In: YES 
user_id=357491

Fair enough.  Do you want me to keep this patch open as a reminder to you, 
Fred, or should I just go ahead and reject it?

Logged In: YES 
user_id=80475

Since the tutorial now only talks about class based 
exceptions, I've applied that part of the patch after 
a rewrite.  See Doc/tut/tut.tex 1.195