From: Akshit Tyagi <37214399+exitflynn@users.noreply.github.com> Date: Fri, 6 Jan 2023 14:26:44 +0000 (+0530) Subject: gh-99026 update dataclasses docs for when annotations are inspected (gh-100798) X-Git-Tag: v3.12.0a4~44 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=659c2607f5b44a8a18a0840d1ac39df8a3219dd5;p=thirdparty%2FPython%2Fcpython.git gh-99026 update dataclasses docs for when annotations are inspected (gh-100798) update dataclasses docs for when annotations are inspected --- diff --git a/Doc/library/dataclasses.rst b/Doc/library/dataclasses.rst index 32c524a73487..82faa7b77450 100644 --- a/Doc/library/dataclasses.rst +++ b/Doc/library/dataclasses.rst @@ -552,7 +552,7 @@ parameters to :meth:`__post_init__`. Also see the warning about how Class variables --------------- -One of two places where :func:`dataclass` actually inspects the type +One of the few places where :func:`dataclass` actually inspects the type of a field is to determine if a field is a class variable as defined in :pep:`526`. It does this by checking if the type of the field is ``typing.ClassVar``. If a field is a ``ClassVar``, it is excluded @@ -563,7 +563,7 @@ module-level :func:`fields` function. Init-only variables ------------------- -The other place where :func:`dataclass` inspects a type annotation is to +Another place where :func:`dataclass` inspects a type annotation is to determine if a field is an init-only variable. It does this by seeing if the type of a field is of type ``dataclasses.InitVar``. If a field is an ``InitVar``, it is considered a pseudo-field called an init-only