2014-02-04 Larry Hastings :

Why couldn't these tools use inspect.Signature?

inspect.Signature was added in Python 3.3. Python 2 is still widely used, and some Linux distro only provide Python 3.2. By the way, help(dict.fromkeys) looks to use __doc__, not the signature, because the prototype is also missing. It's a regression. Victor

On 02/04/2014 05:19 AM, Victor Stinner wrote:

2014-02-04 Larry Hastings :

...

Why couldn't these tools use inspect.Signature? inspect.Signature was added in Python 3.3. Python 2 is still widely used, and some Linux distro only provide Python 3.2.

By the way, help(dict.fromkeys) looks to use __doc__, not the signature, because the prototype is also missing.

It's a regression.

In 3.4, inspect.getfullargspec and inspect.getargspec are being reimplemented using inspect.Signature. I don't understand your bringing up Python 2 and Python 3.2. Are there programs that run under Python 2 and Python 3.2 that examine docstrings from Python 3.4? //arry/

On 02/04/2014 05:24 AM, Antoine Pitrou wrote:

On Tue, 04 Feb 2014 05:08:28 -0800 Larry Hastings 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/