[docs] [issue16731] xxlimited/xxmodule docstrings ambiguous

Berker Peksag report at bugs.python.org
Thu Jan 28 05:53:23 EST 2016

Berker Peksag added the comment:

I think the difference between xxlimited and xxmodule is still a bit ambiguous. I would expect a mention of PEP 384 or a link to https://docs.python.org/3/c-api/stable.html to explain what Py_LIMITED_API really is.

+#ifndef Py_LIMITED_API
+# error "This file requires Py_LIMITED_API"

I don't have a strong opinion about this, but I think the error message could be more informative (e.g. you must define a Py_LIMITED_API macro) Or we can improve https://docs.python.org/3/c-api/stable.html to give an example there.

nosy: +berker.peksag, serhiy.storchaka
stage:  -> patch review
type:  -> enhancement

Python tracker <report at bugs.python.org>

More information about the docs mailing list