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

[Antoine Pitrou]

On Fri, 29 Jul 2011 11:18:37 -0400
Barry Warsaw <barry at python.org> wrote:
> 
> I'd much rather solve this problem by adding markup to functions that
> explicitly disclaim our normal backward compatibility guarantees.  Squirreling
> away documentation for some parts of the stdlib seems similar to
> security-by-obscurity arguments.

Well, here the whole module should not be called by the user. I'm not
sure we want to flag each function individually.

> 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.

Regards

Antoine.