[issue13341] Incorrect documentation for "u" PyArg_Parse format unit

New submission from Ilya Novoselov <ilya.novoselov@gmail.com>: Documentation states that u format unit returns "buffer of 16-bit Unicode (UTF-16) data" while it returns pointer to internal buffer of unicode data, which is either UCS-16 or UCS-32 http://docs.python.org/c-api/arg.html ---------- assignee: docs@python components: Documentation, Unicode messages: 147002 nosy: Ilya.Novoselov, docs@python, ezio.melotti priority: normal severity: normal status: open title: Incorrect documentation for "u" PyArg_Parse format unit type: behavior versions: Python 2.7 _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue13341> _______________________________________

STINNER Victor <victor.stinner@haypocalc.com> added the comment: Can you write a patch? ---------- nosy: +haypo _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue13341> _______________________________________

Ilya Novoselov <ilya.novoselov@gmail.com> added the comment: No, I don't feel like I'm up to standard yet. ---------- _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue13341> _______________________________________

Changes by Mike Hoy <mhoy09@gmail.com>: ---------- nosy: +mikehoy _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue13341> _______________________________________

Changes by Éric Araujo <merwok@netwok.org>: ---------- nosy: +loewis _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue13341> _______________________________________

Changes by Mike Hoy <mhoy09@gmail.com>: ---------- nosy: -mikehoy _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue13341> _______________________________________

Martin Panter added the comment: The Python 3 documentation was updated in Issue 8593 (revision 5d4a5655575f). Perhaps some of the wording also applies to Python 2 and you can just copy it. ---------- nosy: +vadmium _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue13341> _______________________________________

Joannah Nanjekye <nanjekyejoannah@gmail.com> added the comment: This is has taken years but am curious, are we allowed to patch Python 2 given its EOL is almost due. ---------- nosy: +nanjekyejoannah _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue13341> _______________________________________

STINNER Victor <vstinner@python.org> added the comment: I don't think that it's still worth it to update Python 2 documentation at this point. I suggest to focus on enhancement of the Python 3 documentation instead. ---------- _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue13341> _______________________________________

Change by Irit Katriel <iritkatriel@yahoo.com>: ---------- resolution: -> out of date stage: -> resolved status: open -> closed _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue13341> _______________________________________

STINNER Victor <victor.stinner@haypocalc.com> added the comment: Can you write a patch? ---------- nosy: +haypo _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue13341> _______________________________________

Ilya Novoselov <ilya.novoselov@gmail.com> added the comment: No, I don't feel like I'm up to standard yet. ---------- _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue13341> _______________________________________

Changes by Mike Hoy <mhoy09@gmail.com>: ---------- nosy: +mikehoy _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue13341> _______________________________________

Changes by Éric Araujo <merwok@netwok.org>: ---------- nosy: +loewis _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue13341> _______________________________________

Changes by Mike Hoy <mhoy09@gmail.com>: ---------- nosy: -mikehoy _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue13341> _______________________________________

Martin Panter added the comment: The Python 3 documentation was updated in Issue 8593 (revision 5d4a5655575f). Perhaps some of the wording also applies to Python 2 and you can just copy it. ---------- nosy: +vadmium _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue13341> _______________________________________

Joannah Nanjekye <nanjekyejoannah@gmail.com> added the comment: This is has taken years but am curious, are we allowed to patch Python 2 given its EOL is almost due. ---------- nosy: +nanjekyejoannah _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue13341> _______________________________________

STINNER Victor <vstinner@python.org> added the comment: I don't think that it's still worth it to update Python 2 documentation at this point. I suggest to focus on enhancement of the Python 3 documentation instead. ---------- _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue13341> _______________________________________

Change by Irit Katriel <iritkatriel@yahoo.com>: ---------- resolution: -> out of date stage: -> resolved status: open -> closed _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue13341> _______________________________________
participants (7)
-
Ilya Novoselov
-
Irit Katriel
-
Joannah Nanjekye
-
Martin Panter
-
Mike Hoy
-
STINNER Victor
-
Éric Araujo