RetroSearch Browse

Sat Jul 30 01:02:32 CEST 2011 · https://mail.python.org/pipermail/python-dev/2011-July/112668.html

On 7/29/2011 5:32 PM, Antoine Pitrou wrote:
> On Fri, 29 Jul 2011 11:51:18 -0400
> Barry Warsaw<barry at python.org>  wrote:
>> On Jul 29, 2011, at 05:25 PM, Antoine Pitrou wrote:
>>
>>>> test.support *is* part of the stdlib.
>>>
>>> We have lots of internal APIs which are not documented, though.
>>> And test.support *is* for internal use.
>>
>> The solution then is to rename test.support to test._support to make it clear
>> it's an internal implementation detail.  Then you can remove the entire
>> section from the stdlib docs and just document it in the code.
>
> Ideally so.

The effect of this will be to discourage new people (including myself in 
the category) from writing or reviewing patches.

Terry Jan Reedy

Home - News ( United States | United Kingdom | Italy | Germany ) - Football scores

Showing content from https://mail.python.org/pipermail/python-dev/2011-July/112668.html below:

[Python-Dev] Convention on functions that shadow existing stdlib functions