Re: [Python-Dev] __doc__ regression

2014-02-04 Thread Larry Hastings
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 genera

Re: [Python-Dev] __doc__ regression

2014-02-04 Thread Larry Hastings
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_

Re: [Python-Dev] __doc__ regression

2014-02-04 Thread Georg Brandl
Am 04.02.2014 14:19, schrieb Victor Stinner: > 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. Well, Python 2 won't be able to introspect C

Re: [Python-Dev] __doc__ regression

2014-02-04 Thread Antoine Pitrou
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 pr

Re: [Python-Dev] __doc__ regression

2014-02-04 Thread Victor Stinner
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

Re: [Python-Dev] __doc__ regression

2014-02-04 Thread Larry Hastings
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.Signatu

[Python-Dev] __doc__ regression

2014-02-04 Thread Antoine Pitrou
Hello, Following the previous clinic thread, I realize that the latest signature improvements actually entail a regression in __doc__. Compare: $ ./python -c "print(dict.fromkeys.__doc__)" Returns a new dict with keys from iterable and values equal to value. $ python3.3 -c "print(dict.fromkeys.