[Python-bugs-list] [ python-Bugs-661848 ] Add clarification of __all__ to refman?

[SourceForge.net]

Bugs item #661848, was opened at 2003-01-03 15:44
You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=105470&aid=661848&group_id=5470

Category: Documentation
Group: None
Status: Open
Resolution: None
Priority: 5
Submitted By: Jack Jansen (jackjansen)
>Assigned to: Raymond Hettinger (rhettinger)
Summary: Add clarification of __all__ to refman?

Initial Comment:
It might be a good idea to add a clarification of the intended use of __all__ to the reference manual. On the pyobjc mailing list it was suggested to use it as a means to make "from objc import *" export the most commonly used functionality to your namespace.

After discussing this on python-dev Guido proclaimed that this isn't the intended use: "__all__ should contain the entire public API. It's mostly intended to avoid accidentally exporting other things you've *imported* like os, sys, and other library modules."

----------------------------------------------------------------------

You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=105470&aid=661848&group_id=5470