[docs] [issue11776] Constructor signatures missing in types module documentation

Terry J. Reedy report at bugs.python.org
Wed Aug 22 19:44:11 CEST 2012


Terry J. Reedy added the comment:

"class types.MappingProxyType(mapping) 
Read-only proxy of a mapping. ..."

is the only class in 7.11.2. Standard Interpreter Types that *does* have a signature given in the text. However, the extra word 'class' here and for SimpleNamespace confuses me (I do not understand what it is intended to convey) and seems unnecessary. The two entries with signatures in 7.11.1 do not have that.

Once parenthesized signatures are given, perhaps one statement at the top like "Classes listed without a signature cannot be directly created from Python code." would be sufficient.

----------

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue11776>
_______________________________________


More information about the docs mailing list