This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author ncoghlan
Recipients barry, eli.bendersky, ethan.furman, ncoghlan, serhiy.storchaka
Date 2015-04-09.16:42:37
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1428597757.76.0.767487050149.issue23900@psf.upfronthosting.co.za>
In-reply-to
Content
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?
History
Date User Action Args
2015-04-09 16:42:37ncoghlansetrecipients: + ncoghlan, barry, eli.bendersky, ethan.furman, serhiy.storchaka
2015-04-09 16:42:37ncoghlansetmessageid: <1428597757.76.0.767487050149.issue23900@psf.upfronthosting.co.za>
2015-04-09 16:42:37ncoghlanlinkissue23900 messages
2015-04-09 16:42:37ncoghlancreate