[issue44522] [doc] open() function errors='surrogateescape' has inaccurate information
New submission from Bupjae Lee <bupjae@gmail.com>: https://docs.python.org/3/library/functions.html#open error parameter of open() function says this: 'surrogateescape' will represent any incorrect bytes as code points in the Unicode Private Use Area ranging from U+DC80 to U+DCFF. However, U+DC80 to U+DCFF doesn't belong to "Unicode Private Use Area"; it belongs to "Low Surrogate Area". Suggested fix: 'surrogateescape' will represent any incorrect bytes as (unpaired) low surrogate code units ranging from U+DC80 to U+DCFF. ---------- assignee: docs@python components: Documentation messages: 396632 nosy: bupjae2, docs@python priority: normal severity: normal status: open title: [doc] open() function errors='surrogateescape' has inaccurate information type: enhancement versions: Python 3.10, Python 3.11, Python 3.6, Python 3.7, Python 3.8, Python 3.9 _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue44522> _______________________________________
meowmeowcat <meowmeowcat1211@gmail.com> added the comment: Thanks! Confirmed by: https://docs.python.org/3/library/codecs.html#error-handlers I'll open a PR for this. ---------- nosy: +meowmeowmeowcat _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue44522> _______________________________________
Change by meowmeowcat <meowmeowcat1211@gmail.com>: ---------- keywords: +patch pull_requests: +26144 stage: -> patch review pull_request: https://github.com/python/cpython/pull/27650 _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue44522> _______________________________________
Bupjae Lee <bupjae@gmail.com> added the comment: I just noticed that very next sentence, "These private code points will then be turned back...", also needs to be fixed. Suggested fix: "These surrogate code units will then be turned back..." ---------- _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue44522> _______________________________________
meowmeowcat <meowmeowcat1211@gmail.com> added the comment: Oh, I missed this too. I'll fix it. ---------- _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue44522> _______________________________________
Łukasz Langa <lukasz@langa.pl> added the comment: New changeset b05e9b63fcfcd4bd7a6434fa9f9a7028d12f91c4 by meowmeowmeowcat in branch 'main': bpo-44522: Fix inaccurate information in open() function (GH-27650) https://github.com/python/cpython/commit/b05e9b63fcfcd4bd7a6434fa9f9a7028d12... ---------- nosy: +lukasz.langa _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue44522> _______________________________________
Change by miss-islington <mariatta.wijaya+miss-islington@gmail.com>: ---------- nosy: +miss-islington nosy_count: 4.0 -> 5.0 pull_requests: +26166 pull_request: https://github.com/python/cpython/pull/27681 _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue44522> _______________________________________
Change by miss-islington <mariatta.wijaya+miss-islington@gmail.com>: ---------- pull_requests: +26167 pull_request: https://github.com/python/cpython/pull/27682 _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue44522> _______________________________________
miss-islington <mariatta.wijaya+miss-islington@gmail.com> added the comment: New changeset c79aa427c0b0c8a09e5c22a5420baf837054f509 by Miss Islington (bot) in branch '3.10': bpo-44522: Fix inaccurate information in open() function (GH-27650) https://github.com/python/cpython/commit/c79aa427c0b0c8a09e5c22a5420baf83705... ---------- _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue44522> _______________________________________
Łukasz Langa <lukasz@langa.pl> added the comment: New changeset 037ef8d6d9cc8225d6db0305cee2d8d0ee5bee74 by Miss Islington (bot) in branch '3.9': bpo-44522: Fix inaccurate information in open() function (GH-27650) (GH-27682) https://github.com/python/cpython/commit/037ef8d6d9cc8225d6db0305cee2d8d0ee5... ---------- _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue44522> _______________________________________
Łukasz Langa <lukasz@langa.pl> added the comment: Thanks, meowmeowcat! ✨ 🍰 ✨ ---------- resolution: -> fixed stage: patch review -> resolved status: open -> closed versions: -Python 3.6, Python 3.7, Python 3.8 _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue44522> _______________________________________
participants (4)
-
Bupjae Lee -
meowmeowcat -
miss-islington -
Łukasz Langa