RetroSearch Browse

Fri Jul 29 17:25:00 CEST 2011 · https://mail.python.org/pipermail/python-dev/2011-July/112640.html

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.

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

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

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