Message 342271 - Python tracker

Message342271

Author	mbussonn
Recipients	docs@python, mbussonn
Date	2019-05-12.22:03:29
SpamBayes Score	-1.0
Marked as misclassified	Yes
Message-id	<1557698610.19.0.556381141599.issue36896@roundup.psfhosted.org>
In-reply-to

Content
From bpo-36886, IT is unclear the FunctionTypes, CodeTypes ... etc are not stable between python versions, and the recent addition of `:=` change some of the signatures. This suggest 2 things: - A CYA sentence in types.rst "These types are not supposed to be instantiated outside of CPython internals and constructor signatures will vary between python versions." or alike - As many people don't read online documentation but on the docstring via calling `help()`, to add something similar to all the docstrings of said-objects constructors.

Content

From bpo-36886, 

IT is unclear the FunctionTypes, CodeTypes ... etc are not stable between python versions, and the recent addition of `:=` change some of the signatures.  


This suggest 2 things: 
 - A CYA sentence in types.rst "These types are not supposed to be instantiated outside of CPython internals and constructor signatures will vary between python versions." or alike
 - As many people don't read online documentation but on the docstring via calling `help()`, to add something similar to all the docstrings of said-objects constructors.

History
Date	User	Action	Args
2019-05-12 22:03:30	mbussonn	set	recipients: + mbussonn, docs@python
2019-05-12 22:03:30	mbussonn	set	messageid: <1557698610.19.0.556381141599.issue36896@roundup.psfhosted.org>
2019-05-12 22:03:30	mbussonn	link	issue36896 messages
2019-05-12 22:03:29	mbussonn	create