Multiple issues with enum __add_(value_)alias_ documentation

[srittau]

Documentation

Enum._add_alias_ and _add_value_alias_ were added in Python 3.13, but this is not clearly pointed out in the documentation:

https://docs.python.org/3/library/enum.html#enum.EnumType._add_alias_

There is an "Added in version 3.13" marker way down in the Supported _sunder_ names section, but this is unlikely to be discovered by someone looking at the documentation here.

Also, these methods are documented as being members of EnumType, while in reality, they are members of Enum:

Python 3.13.3 (main, Apr 11 2025, 16:08:36) [GCC 13.3.0] on linux
Type "help", "copyright", "credits" or "license" for more information.
>>> import enum
>>> enum.EnumType._add_alias_
Traceback (most recent call last):
  File "<python-input-1>", line 1, in <module>
    enum.EnumType._add_alias_
AttributeError: type object 'EnumType' has no attribute '_add_alias_'
>>> enum.Enum._add_alias_
<function Enum._add_alias_ at 0x784229e71120>

Finally, examples for these functions would help to understand their purpose.

Linked PRs

• gh-136672: Docs: Move Enum functions and add examples #136791
• [3.14] gh-136672: Docs: Move Enum functions and add examples (GH-136791) #137688
• [3.13] gh-136672: Docs: Move Enum functions and add examples (GH-136791) #137689
• gh-136672: Docs: Move parts of Enum HOWTO to API Docs #139176

[amentee]

@srittau - There is an example mentioned in the enum cookbook here - https://docs.python.org/3/howto/enum.html#multivalueenum . But yes agreed , in the original documentation these methods are documented as part of EnumType.

[RafaelWO]

I would like to take a look at this and potentially open a PR 👀