From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com> Date: Wed, 20 Aug 2025 13:15:39 +0000 (+0200) Subject: [3.13] gh-137900: Improve dataclasses frozen parameter documentation (GH-137937)... X-Git-Tag: v3.13.8~168 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=47b1c5d74efffbfc72799a83ad7f7d97635340f6;p=thirdparty%2FPython%2Fcpython.git [3.13] gh-137900: Improve dataclasses frozen parameter documentation (GH-137937) (#137991) gh-137900: Improve dataclasses frozen parameter documentation (GH-137937) (cherry picked from commit 7685b8ada84822a7ee9ce51e8ee0e2e35fd60b4e) Co-authored-by: Tangyuan <47830915@qq.com> --- diff --git a/Doc/library/dataclasses.rst b/Doc/library/dataclasses.rst index 432c2b0d7bc0..ae474a1f46c2 100644 --- a/Doc/library/dataclasses.rst +++ b/Doc/library/dataclasses.rst @@ -161,9 +161,11 @@ Module contents :class:`object`, this means it will fall back to id-based hashing). - *frozen*: If true (the default is ``False``), assigning to fields will - generate an exception. This emulates read-only frozen instances. If - :meth:`~object.__setattr__` or :meth:`~object.__delattr__` is defined in the class, then - :exc:`TypeError` is raised. See the discussion below. + generate an exception. This emulates read-only frozen instances. + See the :ref:`discussion ` below. + + If :meth:`~object.__setattr__` or :meth:`~object.__delattr__` is defined in the class + and *frozen* is true, then :exc:`TypeError` is raised. - *match_args*: If true (the default is ``True``), the :attr:`~object.__match_args__` tuple will be created from the list of