New submission from Matthias Bussonnier <bussonniermatth...@gmail.com>:

>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.

----------
assignee: docs@python
components: Documentation
messages: 342271
nosy: docs@python, mbussonn
priority: normal
severity: normal
status: open
title: clarify in types.rst that FunctionTypes & co  constructors don't have 
stable signature
versions: Python 3.8

_______________________________________
Python tracker <rep...@bugs.python.org>
<https://bugs.python.org/issue36896>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to