Author barry
Recipients barry, docs@python, serhiy.storchaka, skrah, vstinner
Date 2017-10-04.15:13:15
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1507129996.17.0.213398074469.issue28805@psf.upfronthosting.co.za>
In-reply-to
Content
This and the _PyObject_FastCall* APIs really do need to be documented, especially if they're going to be used in the interpreter itself.  The leading underscore signifies that it's not part of the public API (well, METH_FASTCALL doesn't have a leading underscore).

When these are not documented, then they aren't discoverable, so there are cases where it may be useful but will be overlooked.  It also means that folks will be inclined to cargo cult the few existing uses without perhaps understanding the full semantics.

Can we please document these for Python 3.7 at least?
History
Date User Action Args
2017-10-04 15:13:16barrysetrecipients: + barry, vstinner, skrah, docs@python, serhiy.storchaka
2017-10-04 15:13:16barrysetmessageid: <1507129996.17.0.213398074469.issue28805@psf.upfronthosting.co.za>
2017-10-04 15:13:16barrylinkissue28805 messages
2017-10-04 15:13:15barrycreate