[Doc-SIG] __all__, and how it relates to doc tools
Guido van Rossum
guido@digicool.com
Sun, 15 Apr 2001 08:12:23 -0500
> > 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/)