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.

Author serhiy.storchaka
Recipients larry, ncoghlan, rhettinger, serhiy.storchaka, yselivanov
Date 2017-01-21.09:42:36
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1484991756.99.0.970269270756.issue29338@psf.upfronthosting.co.za>
In-reply-to
Content
Pydoc outputs the text signature for C functions. It defines parameters and default values and is a part of function description.

Help on built-in function format in module builtins:

format(value, format_spec='', /)
    Return value.__format__(format_spec)
    
    format_spec defaults to the empty string

When builtin or extension class is converted to Argument Clinic, the generated docstring and text signature of __new__ or __init__ methods usually is used as class docstring and text signature. But pydoc doesn't output the text signature for classes. The important part of information is lost.

For example, for just converted builtin enumerate class:

Help on class enumerate in module builtins:

class enumerate(object)
 |  Return an enumerate object.
 |  
 |    iterable
 |      an object supporting iteration
 |  
 |  The enumerate object yields pairs containing a count (from start, which
 |  defaults to zero) and a value yielded by the iterable argument.
 |  
 |  enumerate is useful for obtaining an indexed list:
 |      (0, seq[0]), (1, seq[1]), (2, seq[2]), ...
 |  
 |  Methods defined here:
 |  
 |  __getattribute__(self, name, /)
 |      Return getattr(self, name).
 |  
 |  __iter__(self, /)
 |      Implement iter(self).
 |  
 |  __new__(*args, **kwargs) from builtins.type
 |      Create and return a new object.  See help(type) for accurate signature.
 |  
 |  __next__(self, /)
 |      Implement next(self).
 |  
 |  __reduce__(...)
 |      Return state information for pickling.

The iterable and start parameters of the constructor are referred but not defined.
History
Date User Action Args
2017-01-21 09:42:37serhiy.storchakasetrecipients: + serhiy.storchaka, rhettinger, ncoghlan, larry, yselivanov
2017-01-21 09:42:36serhiy.storchakasetmessageid: <1484991756.99.0.970269270756.issue29338@psf.upfronthosting.co.za>
2017-01-21 09:42:36serhiy.storchakalinkissue29338 messages
2017-01-21 09:42:36serhiy.storchakacreate