From 8fe37a41fa631f36e3fad20a6b6a5013ef786c7e Mon Sep 17 00:00:00 2001
From: crypt0lith <118923461+crypt0lith@users.noreply.github.com>
Date: Mon, 19 Oct 2026 11:48:08 -0500
Subject: [PATCH] Docs: Fix built-in function `__self__` attribute descriptions
 (GH-159653)

Since PEP 3121, functions in C modules are bound to their module, so
their __self__ is the module object. The inspect.isbuiltin docstring,
the inspect attribute table and the data model reference still say
it is None, as it was in Python 2. Describe it as the module object
the function was defined in, or None.
(cherry picked from commit 415ebffc47e8303d61cf97faf4ddb474334d736d)

Co-authored-by: crypt0lith <118923461+crypt0lith@users.noreply.github.com>
---
 Doc/library/inspect.rst     | 2 ++
 Doc/reference/datamodel.rst | 3 ++-
 Lib/inspect.py              | 3 ++-
 3 files changed, 6 insertions(+), 2 deletions(-)

diff --git a/Doc/library/inspect.rst b/Doc/library/inspect.rst
index dc096b743c6334..118bf9b923ddf9 100644
--- a/Doc/library/inspect.rst
+++ b/Doc/library/inspect.rst
@@ -319,6 +319,8 @@ attributes (see :ref:`import-mod-attrs` for module attributes):
 +-----------------+-------------------+---------------------------+
 |                 | __self__          | instance to which a       |
 |                 |                   | method is bound, or       |
+|                 |                   | module object a function  |
+|                 |                   | was defined in, or        |
 |                 |                   | ``None``                  |
 +-----------------+-------------------+---------------------------+
 
diff --git a/Doc/reference/datamodel.rst b/Doc/reference/datamodel.rst
index 06176be88e0739..1af5301f51ef96 100644
--- a/Doc/reference/datamodel.rst
+++ b/Doc/reference/datamodel.rst
@@ -863,7 +863,8 @@ determined by the C function. Special read-only attributes:
 * :attr:`!__doc__` is the function's documentation string, or ``None`` if
   unavailable. See :attr:`function.__doc__`.
 * :attr:`!__name__` is the function's name. See :attr:`function.__name__`.
-* :attr:`!__self__` is set to ``None`` (but see the next item).
+* :attr:`!__self__` is the module object the function was defined in or
+  ``None`` if unavailable.
 * :attr:`!__module__` is the name of
   the module the function was defined in or ``None`` if unavailable.
   See :attr:`function.__module__`.
diff --git a/Lib/inspect.py b/Lib/inspect.py
index dfaa5843a1fb87..945f696bf0abe1 100644
--- a/Lib/inspect.py
+++ b/Lib/inspect.py
@@ -441,7 +441,8 @@ def isbuiltin(object):
     Built-in functions and methods provide these attributes:
         __doc__         documentation string
         __name__        original name of this function or method
-        __self__        instance to which a method is bound, or None"""
+        __self__        instance to which a method is bound, or module object
+                        a function was defined in, or None"""
     return isinstance(object, types.BuiltinFunctionType)
 
 def ismethodwrapper(object):