homepage

Issue #15582 added docstring inheritance to the inspect module. This means that Enum subclasses without their own docstring now inherit the generic docstring from the base class definition:
>>> import enum, inspect
>>> class MyEnum(enum.Enum):
... a = 1
... 
>>> inspect.getdoc(MyEnum)
'Generic enumeration.\n\nDerive from this class to define new enumerations.'
Perhaps the metaclass could automatically derive a more suitable docstring if the subclass doesn't set one of its own?

We could do something like:
'An enumeration.'
and perhaps even something like:
'An enumeration based on <int>.'
It's not much, but is better than the obviously wrong generic version.

New changeset 684aadcabcc7 by Ethan Furman in branch 'default':
Close issue23900: add default __doc__ to new enumerations that do not specify one.
https://hg.python.org/cpython/rev/684aadcabcc7 

May be don't add __doc__ if sys.flags.optimize >= 2?