diff -r a0cfb8c7dfb3 Doc/library/exceptions.rst --- a/Doc/library/exceptions.rst Wed Jun 27 15:37:47 2012 +0200 +++ b/Doc/library/exceptions.rst Thu Jun 28 09:26:10 2012 -0700 @@ -42,7 +42,7 @@ include the originating exception(s) and This implicit exception chain can be made explicit by using :keyword:`from` with :keyword:`raise`. The single argument to :keyword:`from` must be an exception or ``None``. It will be set as :attr:`__cause__` on the raised exception. -Setting :attr:`__cause__` implicitly sets the :attr:`__suppress_context__` to +Setting :attr:`__cause__` implicitly sets :attr:`__suppress_context__` to ``True``. If :attr:`__cause__` is an exception, it will be displayed. If :attr:`__cause__` is present or :attr:`__suppress_context__` has a true value, :attr:`__context__` will not be displayed. @@ -51,6 +51,9 @@ In either case, the default exception ha remaining links in the :attr:`__context__` chain if :attr:`__cause__` has been set. +Note: Because using :keyword:`from` can throw away valuable debugging +information, its use with a bare :keyword:`raise` is not supported. + Base classes ------------