[Python-Dev] Documenting the private C API (was Re: Questions about signal handling.) (original) (raw)

Stephen J. Turnbull turnbull.stephen.fw at u.tsukuba.ac.jp
Wed Sep 26 23:34:05 EDT 2018

Barry Warsaw writes:

I like the idea of an “internals” C API documentation, separate from the public API.

FWIW, this worked well for XEmacs ("came for flamewars, stayed for the internals manual").

Much of the stuff we inherited from GNU only got documented when there was massive bugginess (yes, that happened ;-), but we were pretty good at getting something (if only a "Here be Dragons" in Portuguese) in for most new global identifiers, and that was generally enough.

More information about the Python-Dev mailing list