Message 342271 - Python tracker

➜

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.

In-reply-to
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>

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

homepage