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

Sat Jul 30 15:38:00 CEST 2011

On 2011年7月30日 09:25:27 -0400
Terry Reedy <tjreedy at udel.edu> wrote:
> >
> > I'm sorry, can you be more precise. The effect of what?
>> Your proposal to remove the current formatted documentation of 
> test.support instead of completing it and force all developers to only 
> have reference to the docstrings scattered through the code.
>> > And why would that be so?
>> Because not everyone is like you. Because the condensed formatted docs 
> make learning and using a module significantly easier for some people.

Ok, I understand. I just hope the notice at the top of the module doc
is prominent enough that nobody will think there's any API guarantee
there.
Regards
Antoine.