[issue20296] PyArg_ParseTuple 2.X docs mention int for "t#", but "Py_ssize_t" for "w#", etc.

New submission from Rob Browning:
Here (http://docs.python.org/2/c-api/arg.html), the documentation for "t#" says:
t# (read-only character buffer) [char *, int]...
while the documentation for "w#" says:
w# (read-write character buffer) [char *, Py_ssize_t]...
However, from getargs.c, it looks like they're handled the same with respect to the size type.
At a minimum, it seems like it might make sense to change these docs to match, and if "w#" and "t#" are actually handled similarly to "s#", it would be even better to just change their docs to match (or refer to) "s#"'s which are more detailed, i.e. they mention the PY_SSIZE_T_CLEAN issues, etc.
Thanks
---------- assignee: docs@python components: Documentation messages: 208410 nosy: docs@python, rlb priority: normal severity: normal status: open title: PyArg_ParseTuple 2.X docs mention int for "t#", but "Py_ssize_t" for "w#", etc. versions: Python 2.7
_______________________________________ Python tracker report@bugs.python.org http://bugs.python.org/issue20296 _______________________________________

Changes by Serhiy Storchaka storchaka@gmail.com:
---------- keywords: +easy stage: -> needs patch type: -> behavior
_______________________________________ Python tracker report@bugs.python.org http://bugs.python.org/issue20296 _______________________________________

Changes by STINNER Victor victor.stinner@gmail.com:
---------- nosy: +haypo, serhiy.storchaka
_______________________________________ Python tracker report@bugs.python.org http://bugs.python.org/issue20296 _______________________________________

Serhiy Storchaka storchaka+cpython@gmail.com added the comment:
Python 2.7 is no longer supported.
---------- resolution: -> out of date stage: needs patch -> resolved status: open -> closed
_______________________________________ Python tracker report@bugs.python.org https://bugs.python.org/issue20296 _______________________________________
participants (3)
-
Rob Browning
-
Serhiy Storchaka
-
STINNER Victor