[issue8215] getargs.c in Python3 contains some TODO and the documentation is outdated

[STINNER Victor]

STINNER Victor <victor.stinner at haypocalc.com> added the comment:

Patch to update the documenation, especially input types for PyArg_ParseTuple() and output types for Py_BuildValue():

 - add bytes and/or bytearray when buffer compatible object is accepted to be more explicit
 - "es", "et", "es#", "et#" don't accept buffer compatible objects: fix the doc
 - specify utf-8 encoding
 - mark "U" and "U#" as deprecated: see issue #8848
 - fix ".. note::" syntax
 - replace "Unicode" by "str"
 - replace "bytes object" by "bytes"
 - replace "any buffer compatible object" by "buffer compatible object"

I hesitate to add explicit quotes, eg. "s" instead of s.

----------
Added file: http://bugs.python.org/file17490/doc_capi_arg.patch

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue8215>
_______________________________________