Commit8e6d87e

authored

Merge pull request#18694 from anntzer/deprecated-mi

DOC: Document limitations on `@deprecated` with multiple-inheritance.

2 parentsef9b1e9 +2ce4d7e commit8e6d87eCopy full SHA for 8e6d87e

File tree

-0

lines changed

-0

lines changed

Lines changed: 6 additions & 0 deletions

Original file line number	Diff line number	Diff line change
`@@ -119,6 +119,12 @@ def deprecated(since, *, message='', name='', alternative='', pending=False,`
`119`	`119`	``@staticmethod`` (i.e., `deprecated` should directly decorate the
`120`	`120`	underlying callable), but over ``@property``.
`121`	`121`
	`122`	+ When deprecating a class ``C`` intended to be used as a base class in a
	`123`	+ multiple inheritance hierarchy, ``C`` must define an ``__init__`` method
	`124`	+ (if ``C`` instead inherited its ``__init__`` from its own base class, then
	`125`	+ ``@deprecated`` would mess up ``__init__`` inheritance when installing its
	`126`	+ own (deprecation-emitting) ``C.__init__``).
	`127`	`+`
`122`	`128`	`Parameters`
`123`	`129`	`----------`
`124`	`130`	`since : str`

Comments

(0)