[Python-Dev] Breaking undocumented API

Terry Reedy tjreedy at udel.edu
Mon Nov 8 23:59:40 CET 2010


On 11/8/2010 4:36 PM, Ron Adam wrote:

> My understanding is that anything with an actual docstring is part of
> the public API. Any thing with a leading underscore is private.

When the trace module was written, the rule seems to have been more 
like: docs (but no docstrings) for public API, docstrings (but no doc 
mention) for private stuff. Eli and I fixed the first part.

-- 
Terry Jan Reedy



More information about the Python-Dev mailing list