[issue11776] Constructor signatures missing in types module documentation

Terry J. Reedy added the comment: I agree that we should properly document all of the types, even if belately. A PR is premature until we agree in more detail what 'properly' means. The most recent patch 'complete-patch...' has multiple errors and needs major revision, to the point that a

[issue11776] Constructor signatures missing in types module documentation

Change by Tz a : -- nosy: +Tz a ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe:

[issue11776] Constructor signatures missing in types module documentation

Emmanuel Arias added the comment: > For others, please give Mike at least a week to respond before opening a PR > with his changes. Okas! -- nosy: +eamanu ___ Python tracker

[issue11776] Constructor signatures missing in types module documentation

Cheryl Sabella added the comment: @mikehoy, would you be interested in converting your patch to a GitHub pull request? For others, please give Mike at least a week to respond before opening a PR with his changes. Thank you! -- nosy: +cheryl.sabella versions: +Python 3.7,

[issue11776] Constructor signatures missing in types module documentation

Changes by Terry J. Reedy tjre...@udel.edu: -- nosy: -techtonik versions: +Python 3.4, Python 3.5 -Python 3.3 ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue11776 ___

[issue11776] Constructor signatures missing in types module documentation

Changes by Eric Snow ericsnowcurren...@gmail.com: -- nosy: +eric.snow ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue11776 ___ ___ Python-bugs-list

[issue11776] Constructor signatures missing in types module documentation

Mike Hoy added the comment: This should be all the requested changes. I've gone over the table entries (at least the first one, CodeType, with bitdancer on IRC). I've removed the descriptive language from below the table and added it to the table. Leaving the text below the table to deal with

[issue11776] Constructor signatures missing in types module documentation

Mike Hoy added the comment: I've added a completed patch for review. There was some talk on IRC that the wording for MappingProxyType should be changed to: Return a read-only view of the given mapping. We decided to leave it to the review process to determine the exact wording. --

[issue11776] Constructor signatures missing in types module documentation

Mike Hoy added the comment: Ezio Melotti was the one that offered to change the wording on MappingProxyType doc -- ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue11776 ___

[issue11776] Constructor signatures missing in types module documentation

Ezio Melotti added the comment: We decided to leave it to the review process to determine the exact wording. The problem with the current wording is that it explain how to use it (in case it's used to create a new mapping proxy), but doesn't say much about the object itself (in case it's

[issue11776] Constructor signatures missing in types module documentation

Mike Hoy added the comment: Lambda Changes patch. -- Added file: http://bugs.python.org/file26982/issue11776-first-easy-part-lambda-.diff ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue11776

[issue11776] Constructor signatures missing in types module documentation

Changes by Ezio Melotti ezio.melo...@gmail.com: -- nosy: +ezio.melotti ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue11776 ___ ___

[issue11776] Constructor signatures missing in types module documentation

Mike Hoy added the comment: I used the following for: CodeType FunctionType LambdaType SimpleNamespace MethodType print(CodeType.__doc__) code(argcount, kwonlyargcount, nlocals, stacksize, flags, codestring, constants, names, varnames, filename, name, firstlineno,

[issue11776] Constructor signatures missing in types module documentation

Terry J. Reedy added the comment: LambdaType is a synonym for FunctionType. There should be just one entry, as currently, but perhaps make that a bit clearer, as one could misread the current line as saying that FunctionType is the type of def statements and LambdaType is the type of lambda

[issue11776] Constructor signatures missing in types module documentation

Nick Coghlan added the comment: Clarifying the request: the constructor signatures for internal types should be documented in http://docs.python.org/dev/library/types, rather than just listing the types. If creation of new instances from Python is not supported, that should also be

[issue11776] Constructor signatures missing in types module documentation

Nick Coghlan added the comment: The first easy part of this patch is to document the signatures for types in that module where that info is available in the docstring: CodeType FunctionType LambdaType SimpleNamespace MethodType The second easy part is that the following need to be documented

[issue11776] Constructor signatures missing in types module documentation

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