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

[Ka-Ping Yee]

On Thu, 19 Apr 2001, Tim Peters wrote:
> > In a previous incarnation, pydoc avoided top-level names beginning
> > with _, but Guido was unhappy that it did this at the module level
> > and not at the class level, so i changed it.
> 
> Changed it to what?  To avoid them at both levels, or to avoid them at
> neither?

Neither, as you can see now.  I didn't think we had the time to
debate the starts-with-one-underscore-but-not-two rule then.

>     name[:1] == "_" and not name[:2] == "__" == name[-2:]

Yup, looks like a good rule to me.


-- ?!ng