From: Solaris-star <67425364+Solaris-star@users.noreply.github.com>
Date: Tue, 21 Jul 2026 12:45:42 +0000 (+0800)
Subject: gh-154320: Fix swapped __defaults__/__kwdefaults__ in annotationlib docs (#154321)
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=dc72be1923a37042aee60354059e43d472de7803;p=thirdparty%2FPython%2Fcpython.git

gh-154320: Fix swapped __defaults__/__kwdefaults__ in annotationlib docs (#154321)

The bullet list under "Creating a custom callable annotate function"
had the attribute names reversed: positional defaults are __defaults__
(a tuple) and keyword defaults are __kwdefaults__ (a dict). The example
code below was already correct.

Fixes #154320
---

diff --git a/Doc/library/annotationlib.rst b/Doc/library/annotationlib.rst
index af28fe0e2fde..a90754620b59 100644
--- a/Doc/library/annotationlib.rst
+++ b/Doc/library/annotationlib.rst
@@ -535,9 +535,9 @@ following attributes:
   :attr:`~Format.VALUE_WITH_FAKE_GLOBALS`.
 * A :ref:`code object <code-objects>` ``__code__`` containing the compiled code for the
   annotate function.
-* Optional: A tuple of the function's positional defaults ``__kwdefaults__``, if the
+* Optional: A tuple of the function's positional defaults ``__defaults__``, if the
   function represented by ``__code__`` uses any positional defaults.
-* Optional: A dict of the function's keyword defaults ``__defaults__``, if the function
+* Optional: A dict of the function's keyword defaults ``__kwdefaults__``, if the function
   represented by ``__code__`` uses any keyword defaults.
 * Optional: All other :ref:`function attributes <inspect-types>`.