From a798b2f42d43e83ed86de58ef10cb42b52cd8278 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 432c2b0d7bc000..ae474a1f46c29e 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