Issue 20837: Ambiguity words in base64 documentation (original) (raw)

This issue has been migrated to GitHub: https://github.com/python/cpython/issues/65036

classification

Title: Ambiguity words in base64 documentation
Type: enhancement Stage: resolved
Components: Documentation Versions: Python 3.4, Python 2.7

process

Status: closed Resolution: fixed
Dependencies: Superseder:
Assigned To: docs@python Nosy List: docs@python, eric.araujo, martin.panter, methane, python-dev, r.david.murray
Priority: normal Keywords: patch

Created on 2014-03-02 23:38 by methane, last changed 2022-04-11 14:57 by admin. This issue is now closed.

Files
File name Uploaded Description Edit
base64.patch methane,2014-03-03 02:21 review
Messages (8)
msg212604 - (view) Author: Inada Naoki (methane) * (Python committer) Date: 2014-03-02 23:38
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.
msg212605 - (view) Author: R. David Murray (r.david.murray) * (Python committer) Date: 2014-03-03 00:05
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.
msg212607 - (view) Author: Inada Naoki (methane) * (Python committer) Date: 2014-03-03 02:21
Here's patch.
msg212903 - (view) Author: Éric Araujo (eric.araujo) * (Python committer) Date: 2014-03-07 22:00
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)”
msg212940 - (view) Author: Roundup Robot (python-dev) (Python triager) Date: 2014-03-08 17:54
New changeset 1853679c6f71 by R David Murray in branch 'default': whatsnew: base65 encodings. (#17618) http://hg.python.org/cpython/rev/1853679c6f71
msg212942 - (view) Author: R. David Murray (r.david.murray) * (Python committer) Date: 2014-03-08 17:56
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) :(
msg256360 - (view) Author: Roundup Robot (python-dev) (Python triager) Date: 2015-12-14 02:58
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
msg256362 - (view) Author: Martin Panter (martin.panter) * (Python committer) Date: 2015-12-14 03:01
I think it is too late for 3.3 now, but I did port the relevant bit to 2.7.
History
Date User Action Args
2022-04-11 14:57:59 admin set github: 65036
2015-12-14 03:01:24 martin.panter set status: open -> closedversions: + Python 2.7, - Python 3.3nosy: + martin.pantermessages: + stage: patch review -> resolved
2015-12-14 02:58:17 python-dev set messages: +
2014-05-09 12:49:13 ezio.melotti set type: enhancementstage: patch review
2014-03-08 17:56:05 r.david.murray set resolution: fixedmessages: +
2014-03-08 17:54:17 python-dev set nosy: + python-devmessages: +
2014-03-07 22:00:54 eric.araujo set nosy: + eric.araujomessages: +
2014-03-03 02:21:42 methane set files: + base64.patchkeywords: + patchmessages: +
2014-03-03 00:05:30 r.david.murray set nosy: + r.david.murraymessages: +
2014-03-02 23:38:20 methane create