[Python-checkins] bpo-33961: Adjusted dataclasses docs to correct exceptions raised. (GH-7917) (GH-17677)

Eric V. Smith webhook-mailer at python.org
Wed Dec 25 17:45:43 EST 2019


https://github.com/python/cpython/commit/e28aff54d95236ea1b64b648d89a1516e446e621
commit: e28aff54d95236ea1b64b648d89a1516e446e621
branch: master
author: Fabio Sangiovanni <4040184+sanjioh at users.noreply.github.com>
committer: Eric V. Smith <ericvsmith at users.noreply.github.com>
date: 2019-12-25T17:45:30-05:00
summary:

bpo-33961: Adjusted dataclasses docs to correct exceptions raised. (GH-7917) (GH-17677)

files:
M Doc/library/dataclasses.rst

diff --git a/Doc/library/dataclasses.rst b/Doc/library/dataclasses.rst
index 71768abf80c47..c125a1130a960 100644
--- a/Doc/library/dataclasses.rst
+++ b/Doc/library/dataclasses.rst
@@ -60,8 +60,9 @@ Module-level decorators, classes, and functions
 
    The :func:`dataclass` decorator will add various "dunder" methods to
    the class, described below.  If any of the added methods already
-   exist on the class, a :exc:`TypeError` will be raised.  The decorator
-   returns the same class that is called on: no new class is created.
+   exist on the class, the behavior depends on the parameter, as documented
+   below. The decorator returns the same class that is called on; no new
+   class is created.
 
    If :func:`dataclass` is used just as a simple decorator with no parameters,
    it acts as if it has the default values documented in this
@@ -115,7 +116,7 @@ Module-level decorators, classes, and functions
 
      If the class already defines any of :meth:`__lt__`,
      :meth:`__le__`, :meth:`__gt__`, or :meth:`__ge__`, then
-     :exc:`ValueError` is raised.
+     :exc:`TypeError` is raised.
 
    - ``unsafe_hash``: If ``False`` (the default), a :meth:`__hash__` method
      is generated according to how ``eq`` and ``frozen`` are set.



More information about the Python-checkins mailing list