[Python-Dev] __doc__ regression

Larry Hastings larry at hastings.org
Wed Feb 5 01:43:12 CET 2014


On 02/04/2014 05:24 AM, Antoine Pitrou wrote:
> On Tue, 04 Feb 2014 05:08:28 -0800
> Larry Hastings <larry at hastings.org> wrote:
>> On 02/04/2014 04:17 AM, Antoine Pitrou wrote:
>>> As you see the signature string has vanished from the __doc__ contents.
>>> This means that any tool directly processing __doc__ attributes to
>>> generate (e.g.) automatic API docs will produce less useful docs.
>> Why couldn't these tools use inspect.Signature?
> Because it's new in 3.3? Most Python code has been written before that.

inspect.getargspec and inspect.getfullargspec in 3.4 use 
inspect.Signature to get the signatures of builtins.

Does this address your concerns?


//arry/
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/python-dev/attachments/20140204/ca38afb1/attachment.html>


More information about the Python-Dev mailing list