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

[Nick Coghlan]

On Sun, Jul 31, 2011 at 1:38 AM, Barry Warsaw <barry at python.org> wrote:
> On Jul 31, 2011, at 01:23 AM, Nick Coghlan wrote:
>
>>It sounds to me like you're really objecting to the devguide living in
>>a separate clone. This doesn't bode well for the prospects of ever
>>splitting the stdlib out from the CPython interpreter core...
>
> Actually, no.  I'm objecting to moving documentation for code to a different
> repo than the code.  If/when the stdlib is split out (which I support), then
> the documentation should go with it.

That's a rather valid point that I can definitely agree with.

OK, you've convinced me that the right thing to do is leave the
test.support docs where they are and just apply the appropriate markup
to keep them out of the various indices.

Cheers,
Nick.

-- 
Nick Coghlan   |   ncoghlan at gmail.com   |   Brisbane, Australia