From: Tangyuan <47830915@qq.com>
Date: Wed, 20 Aug 2025 13:08:45 +0000 (+0800)
Subject: gh-137900: Improve dataclasses frozen parameter documentation (#137937)
X-Git-Tag: v3.15.0a1~634
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=7685b8ada84822a7ee9ce51e8ee0e2e35fd60b4e;p=thirdparty%2FPython%2Fcpython.git

gh-137900: Improve dataclasses frozen parameter documentation (#137937)
---

diff --git a/Doc/library/dataclasses.rst b/Doc/library/dataclasses.rst
index 299c8aa399c2..2e4520c823bf 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 <dataclasses-frozen>` 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