[Python-checkins] bpo-12029: [doc] clarify that except does not match virtual subclasses of the specified exception type (GH-32027)

iritkatriel webhook-mailer at python.org
Mon Mar 21 16:41:45 EDT 2022


https://github.com/python/cpython/commit/45833b50f0ccf2abb01304c900afee05b6d01b9e
commit: 45833b50f0ccf2abb01304c900afee05b6d01b9e
branch: main
author: Irit Katriel <1055913+iritkatriel at users.noreply.github.com>
committer: iritkatriel <1055913+iritkatriel at users.noreply.github.com>
date: 2022-03-21T20:41:35Z
summary:

bpo-12029: [doc] clarify that except does not match virtual subclasses of the specified exception type (GH-32027)

files:
M Doc/reference/compound_stmts.rst
M Doc/reference/executionmodel.rst

diff --git a/Doc/reference/compound_stmts.rst b/Doc/reference/compound_stmts.rst
index 15a51e7fc7bea..92024e51ef4fc 100644
--- a/Doc/reference/compound_stmts.rst
+++ b/Doc/reference/compound_stmts.rst
@@ -243,9 +243,10 @@ is found that matches the exception.  An expression-less except clause, if
 present, must be last; it matches any exception.  For an except clause with an
 expression, that expression is evaluated, and the clause matches the exception
 if the resulting object is "compatible" with the exception.  An object is
-compatible with an exception if the object is the class or a base class of the exception
-object, or a tuple containing an item that is the class or a base class of
-the exception object.
+compatible with an exception if the object is the class or a
+:term:`non-virtual base class <abstract base class>` of the exception object,
+or a tuple containing an item that is the class or a non-virtual base class
+of the exception object.
 
 If no except clause matches the exception, the search for an exception handler
 continues in the surrounding code and on the invocation stack.  [#]_
diff --git a/Doc/reference/executionmodel.rst b/Doc/reference/executionmodel.rst
index e652915bd271c..d9183561820b2 100644
--- a/Doc/reference/executionmodel.rst
+++ b/Doc/reference/executionmodel.rst
@@ -259,8 +259,9 @@ a stack traceback, except when the exception is :exc:`SystemExit`.
 
 Exceptions are identified by class instances.  The :keyword:`except` clause is
 selected depending on the class of the instance: it must reference the class of
-the instance or a base class thereof.  The instance can be received by the
-handler and can carry additional information about the exceptional condition.
+the instance or a :term:`non-virtual base class <abstract base class>` thereof.
+The instance can be received by the handler and can carry additional information
+about the exceptional condition.
 
 .. note::
 



More information about the Python-checkins mailing list