[3.12] gh-115821: [Enum] better error message for calling super().__n…

…ew__() (GH-116065) Add note to not call super().__new__() in docs.
python · Feb 28, 2024 · 83ff92d · 83ff92d
1 parent a85e512
commit 83ff92d
Showing 1 changed file with 3 additions and 0 deletions.
diff --git a/Doc/library/enum.rst b/Doc/library/enum.rst
@@ -390,6 +390,9 @@ Data Types
 
       results in the call ``int('1a', 16)`` and a value of ``17`` for the member.
 
+      ..note:: When writing a custom ``__new__``, do not use ``super().__new__`` --
+               call the appropriate ``__new__`` instead.
+
    .. method:: Enum.__repr__(self)
 
       Returns the string used for *repr()* calls.  By default, returns the