[issue20837] Ambiguity words in base64 documentation
New submission from INADA Naoki: http://docs.python.org/3/library/base64.html
The modern interface supports encoding and decoding ASCII byte string objects using all three alphabets.
What "all three alphabets" means? I think it is about *altchars*. But the sentence is too ambiguous to translate it in Japanese. ---------- assignee: docs@python components: Documentation messages: 212604 nosy: docs@python, naoki priority: normal severity: normal status: open title: Ambiguity words in base64 documentation versions: Python 3.3, Python 3.4 _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue20837> _______________________________________
R. David Murray added the comment: There are three different 'base64 alphabets' defined in the standard. The support for using them is via altchars. 'URL safe' and 'filename safe' are the two alternate alphabets defined in the standard, which you can see if you follow the link to the RFC. A patch making this more explicit in the base64 docs themselves would almost certainly be accepted. ---------- nosy: +r.david.murray _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue20837> _______________________________________
INADA Naoki added the comment: Here's patch. ---------- keywords: +patch Added file: http://bugs.python.org/file34272/base64.patch _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue20837> _______________________________________
Éric Araujo added the comment: Additional edit to make the patch crystal-clear: “using all three alphabets (normal, URL and Filesystem safe alphabet).” → “using all three alphabets defined in the RFC (normal, URL-safe and filesystem-safe)” ---------- nosy: +eric.araujo _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue20837> _______________________________________
Roundup Robot added the comment: New changeset 1853679c6f71 by R David Murray in branch 'default': whatsnew: base65 encodings. (#17618) http://hg.python.org/cpython/rev/1853679c6f71 ---------- nosy: +python-dev _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue20837> _______________________________________
R. David Murray added the comment: I had to edit that paragraph for another issue, so I fixed the wording along the lines Éric suggested while I was at it. Hmm. But it still needs to be fixed in 3.3 (and 2.7, I presume) :( ---------- resolution: -> fixed _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue20837> _______________________________________
Changes by Ezio Melotti <ezio.melotti@gmail.com>: ---------- stage: -> patch review type: -> enhancement _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue20837> _______________________________________
Roundup Robot added the comment: New changeset e8cbebb273c6 by Martin Panter in branch '2.7': Issue #20837: Base-64 alphabet clarification from revision 1853679c6f71 https://hg.python.org/cpython/rev/e8cbebb273c6 ---------- _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue20837> _______________________________________
Martin Panter added the comment: I think it is too late for 3.3 now, but I did port the relevant bit to 2.7. ---------- nosy: +martin.panter stage: patch review -> resolved status: open -> closed versions: +Python 2.7 -Python 3.3 _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue20837> _______________________________________
participants (6)
-
Ezio Melotti -
INADA Naoki
-
Martin Panter
-
R. David Murray
-
Roundup Robot
-
Éric Araujo