From: Jelle Zijlstra <jelle.zijlstra@gmail.com>
Date: Wed, 25 Sep 2024 23:08:14 +0000 (-0700)
Subject: gh-123242: Note that type.__annotations__ may not exist (#124557)
X-Git-Tag: v3.14.0a1~330
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=99b23c64de301c9e77add6b0d8e60118ef807840;p=thirdparty%2FPython%2Fcpython.git

gh-123242: Note that type.__annotations__ may not exist (#124557)

Closes #123242. The real criterion is that the attribute does not
exist on heap types, but I don't think we should discuss heap vs.
static types in the language reference.
---

diff --git a/Doc/reference/datamodel.rst b/Doc/reference/datamodel.rst
index 7a93a9f770b4..a6348eda3891 100644
--- a/Doc/reference/datamodel.rst
+++ b/Doc/reference/datamodel.rst
@@ -1045,7 +1045,8 @@ Special attributes
 
           Accessing the :attr:`!__annotations__` attribute of a class
           object directly may yield incorrect results in the presence of
-          metaclasses. Use :func:`annotationlib.get_annotations` to
+          metaclasses. In addition, the attribute may not exist for
+          some classes. Use :func:`annotationlib.get_annotations` to
           retrieve class annotations safely.
 
        .. versionchanged:: 3.14