[Python-Dev] Breaking undocumented API

[Nick Coghlan]

On Thu, Nov 18, 2010 at 7:08 AM, Éric Araujo <merwok at netwok.org> wrote:
>> We may also revisit the rules used by help() to decide what to include
>> on the auto-generated module implementation.  Note that currently
>> help() output excludes names not in __all__ is the module has __all__
>> defined.  While I advocated this rule earlier in this thread, I now
>> Consider the recent addition of open() to the tokenize module.  It
>> was documented in the manual, but (wisely) excluded from tokenize.__all__.
>
> I’m not sure this was on purpose.  Victor?

Excluding a builtin name from __all__ sounds like a perfectly sensible
idea, so even if it wasn't deliberate, I'd say it qualifies as
fortuitous :)

Cheers,
Nick.

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