[Doc-SIG] __all__, and how it relates to doc tools

[Guido van Rossum]

> > Would it also be reasonable for a doc tool to look at this value, for
> > an indication of which objects to document?
> 
> Absolutely.  In fact, that's probably the best use.

Hm.  You may be right, but Ping told me that he had tried this in
pyoc, and was unhapy with the result: too much stuff didn't get
documented.  So we should at least be willing to retract this idea.

--Guido van Rossum (home page: http://www.python.org/~guido/)