[Python-Dev] Breaking undocumented API (original) (raw)

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