This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author rlb
Recipients docs@python, rlb
Date 2014-01-18.19:22:50
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1390072970.58.0.165278841581.issue20296@psf.upfronthosting.co.za>
In-reply-to
Content
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
History
Date User Action Args
2014-01-18 19:22:50rlbsetrecipients: + rlb, docs@python
2014-01-18 19:22:50rlbsetmessageid: <1390072970.58.0.165278841581.issue20296@psf.upfronthosting.co.za>
2014-01-18 19:22:50rlblinkissue20296 messages
2014-01-18 19:22:50rlbcreate