From a161c657efacd5d5685bdfc3d488364d55f2019f Mon Sep 17 00:00:00 2001 From: Tangyuan <47830915@qq.com> Date: Wed, 20 Aug 2025 21:08:45 +0800 Subject: [PATCH] gh-137900: Improve dataclasses frozen parameter documentation (GH-137937) (cherry picked from commit 7685b8ada84822a7ee9ce51e8ee0e2e35fd60b4e) Co-authored-by: Tangyuan <47830915@qq.com> --- Doc/library/dataclasses.rst | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/Doc/library/dataclasses.rst b/Doc/library/dataclasses.rst index 299c8aa399c25c0..2e4520c823bf3ee 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