[Python-Dev] [Python-checkins] cpython: Issue #14814: addition of the ipaddress module (stage 1 - code and tests)

[Sandro Tosi]

On Tue, May 22, 2012 at 10:43 PM, Terry Reedy <tjreedy at udel.edu> wrote:
> On 5/22/2012 3:59 PM, Sandro Tosi wrote:
>> On Sun, May 20, 2012 at 7:18 PM, Terry Reedy<tjreedy at udel.edu>  wrote
>>>> +    Args:
>>>> +        first: the first IPv4Address or IPv6Address in the range.
>>>> +        last: the last IPv4Address or IPv6Address in the range.
>>>> +
>>>> +    Returns:
>>>> +        An iterator of the summarized IPv(4|6) network objects.
>>>
>>>
>>> Very clear as to types.
>>
>>
>> I don't think I get exactly what you mean here.
>
>
> This docstring clearly says what the input type is instead of the more vague
> 'address'. Also, the output is pretty clearly an iterable of IPv#Address
> objects. I meant to contrast this as a good example compared to some of the
> previous docstrings.

Ah now I see, thanks for fixing my understanding ;)

Cheers,
-- 
Sandro Tosi (aka morph, morpheus, matrixhasu)
My website: http://matrixhasu.altervista.org/
Me at Debian: http://wiki.debian.org/SandroTosi