[Python-checkins] Fix description of behaviour of an exception class in 'from' clause (GH-24303)

mdickinson webhook-mailer at python.org
Sun Apr 11 04:34:25 EDT 2021


https://github.com/python/cpython/commit/79650d0118b0a8861428b9dd063089de405cf137
commit: 79650d0118b0a8861428b9dd063089de405cf137
branch: master
author: Mark Dickinson <mdickinson at enthought.com>
committer: mdickinson <dickinsm at gmail.com>
date: 2021-04-11T09:33:59+01:00
summary:

Fix description of behaviour of an exception class in 'from' clause (GH-24303)

files:
M Doc/reference/simple_stmts.rst

diff --git a/Doc/reference/simple_stmts.rst b/Doc/reference/simple_stmts.rst
index 3fff8484856ab..941b3427d635e 100644
--- a/Doc/reference/simple_stmts.rst
+++ b/Doc/reference/simple_stmts.rst
@@ -591,10 +591,13 @@ instance, with its traceback set to its argument), like so::
            __context__ (exception attribute)
 
 The ``from`` clause is used for exception chaining: if given, the second
-*expression* must be another exception class or instance, which will then be
-attached to the raised exception as the :attr:`__cause__` attribute (which is
-writable).  If the raised exception is not handled, both exceptions will be
-printed::
+*expression* must be another exception class or instance. If the second
+expression is an exception instance, it will be attached to the raised
+exception as the :attr:`__cause__` attribute (which is writable). If the
+expression is an exception class, the class will be instantiated and the
+resulting exception instance will be attached to the raised exception as the
+:attr:`__cause__` attribute. If the raised exception is not handled, both
+exceptions will be printed::
 
    >>> try:
    ...     print(1 / 0)



More information about the Python-checkins mailing list