From: Dennis Sweeney <36520290+sweeneyde@users.noreply.github.com>
Date: Sun, 5 Jun 2022 15:24:09 +0000 (-0400)
Subject: Document LOAD_FAST_CHECK opcode (#93498)
X-Git-Tag: v3.12.0a1~1354
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=4082c8e298a244edf6771839334372a47ece721d;p=thirdparty%2FPython%2Fcpython.git

Document LOAD_FAST_CHECK opcode (#93498)
---

diff --git a/Doc/library/dis.rst b/Doc/library/dis.rst
index 313870ffa4de..9163d1a4421a 100644
--- a/Doc/library/dis.rst
+++ b/Doc/library/dis.rst
@@ -1042,6 +1042,17 @@ iterations of the loop.
 
    Pushes a reference to the local ``co_varnames[var_num]`` onto the stack.
 
+   .. versionchanged:: 3.12
+      This opcode is now only used in situations where the local variable is
+      guaranteed to be initialized. It cannot raise :exc:`UnboundLocalError`.
+
+.. opcode:: LOAD_FAST_CHECK (var_num)
+
+   Pushes a reference to the local ``co_varnames[var_num]`` onto the stack,
+   raising an :exc:`UnboundLocalError` if the local variable has not been
+   initialized.
+
+   .. versionadded:: 3.12
 
 .. opcode:: STORE_FAST (var_num)