[Python-Dev] Convention on functions that shadow existing stdlib functions (original) (raw)

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