[docs] [issue36896] clarify in types.rst that FunctionTypes & co constructors don't have stable signature

Terry J. Reedy report at bugs.python.org
Fri May 31 15:47:05 EDT 2019

Terry J. Reedy <tjreedy at udel.edu> added the comment:

Pablo, I am all for respectfully preserving implementation freedom where we can.  From idlelib.__init__: [idlelib files other than idle*.*]  "are private implementations.  Their details are subject to change.  See PEP 434 for more.  Import them at your own risk."

Matthias: I don't believe we put version changed notes in docstrings, as they are for the current code.  But if a docstring covers arguments, as usual, then the new one should be added.


Python tracker <report at bugs.python.org>

More information about the docs mailing list