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

Terry Reedy tjreedy at udel.edu
Sat Jul 30 00:42:46 CEST 2011


On 7/29/2011 11:18 AM, Barry Warsaw wrote:

> I'd much rather solve this problem by adding markup to functions that
> explicitly disclaim our normal backward compatibility guarantees.

I suggested adding a footnote marker (1) to each one.

> test.support *is* part of the stdlib.


> So once again, is this a real actual problem you've witnessed in enough cases
> to go through all the trouble of moving the documentation, and making it more
> difficult to find?

I agree with this. When working on tests, I would prefer to have 
test.support doc in the same offine doc set as unittest docs.

I only supported *moving* as an alternative to *deleting*.

Terry J. Reedy




More information about the Python-Dev mailing list