[issue20413] Errors in documentation of standard codec error handlers
Matthew Barnett added the comment: The docs for Python 3.5.0a0 still say Unicode Private Use Area. -- nosy: +mrabarnett versions: +Python 3.5 ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue20413 ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue20413] Errors in documentation of standard codec error handlers
Martin Panter added the comment: I changed “code point in the Unicode Private Use Area” to “individual surrogate code” in the “codecs” module documentation for Issue 19548. So perhaps (a) still needs addressing, but (b) and (c) are hopefully already fixed. -- nosy: +vadmium ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue20413 ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue20413] Errors in documentation of standard codec error handlers
Nick Coghlan added the comment: Ah, February 2014, many of my plans went in rather different directions than expected that month, and this was one of them :) As Martin noted, he already fixed (b) and (c), but we missed that the list of error handlers was also duplicated in the builtin open() docs. That duplication is likely worthwhile from a docs usability perspective, but we should: 1. Bring it in line with Martin's recent fixes to the codecs module docs 2. Add a comment in the error handler docs noting that the open() docs may need to be updated to reflect changes to error handler semantics -- assignee: ncoghlan - ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue20413 ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue20413] Errors in documentation of standard codec error handlers
Changes by Ezio Melotti ezio.melo...@gmail.com: -- nosy: +ezio.melotti ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue20413 ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue20413] Errors in documentation of standard codec error handlers
New submission from RalfM: The standard library documentation lists the standard codec error handlers in three places: (a) 2. Build-in Functions, section open() (b) 7.2 codecs - Codec registry and base classes (c) 7.2.1 Codec Base Classes As far as I can judge these lists, (c) looks ok, but (a) and (b) contain two errors: 1. 'surrogatepass' is not mentioned. 2. 'surrogateescape' is described as: 'on decoding, replace with code points in the Unicode Private Use Area ranging from U+DC80 to U+DCFF. These private code points will ...' This is incorrect in so far as U+DC80 to U+DCFF are not private code points, but (low-)surrogate code points. This is correctly explained in (c) and in PEP383 (and, of course, in the Unicode standard, chapter 16). I suggest to correct (a) and (b) by * adding 'surrogatepass' with the description given in (c), * changing the description of 'surrogateescape' to something like: 'on decoding, replace with surrogate code points ranging from U+DC80 to U+DCFF. These surrogate code points will ...'. These errors are present in the documentation (more precisely, the .chm files) of at least - Python 3.3.3 - Python 3.3.4rc1 - Python 3.4.0b3. -- assignee: docs@python components: Documentation messages: 209477 nosy: RalfM, docs@python priority: normal severity: normal status: open title: Errors in documentation of standard codec error handlers type: enhancement versions: Python 3.3, Python 3.4 ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue20413 ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
[issue20413] Errors in documentation of standard codec error handlers
Nick Coghlan added the comment: I plan to take a look at the codec docs in general in the next week or so, I'll tackle this as well. -- assignee: docs@python - ncoghlan nosy: +ncoghlan ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue20413 ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
