[docs] [issue17972] inspect module docs omits many functions

Paul Rudin report at bugs.python.org
Sun Jan 14 04:31:15 EST 2018

Paul Rudin <paul at rudin.co.uk> added the comment:

Although formatannotation is undocumented, its actually documented as a default value for one of the parameters of formatargspec, so it does form part of the module's public interface. However formatargspec is deprecated, so it's still OK to deprecate formatannotation.

formatannotation is also used as a helper within Parameter, which isn't deprecated, but the public interface or docs of Parameter don't mention formatannotation, so using _formatannotation instead is fine.

Since I've looked through this and, as far as I can tell, nobody is working on it, I'll make the changes and make a PR.


Python tracker <report at bugs.python.org>

More information about the docs mailing list