[Python-Dev] Breaking undocumented API (original) (raw)

Nick Coghlan ncoghlan at gmail.com
Wed Nov 17 22:10:01 CET 2010

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

More information about the Python-Dev mailing list