[docs] [issue25495] binascii documentation incorrect
report at bugs.python.org
Thu Oct 29 23:04:45 EDT 2015
Martin Panter added the comment:
Thanks for bringing this up, it has often bugged me.
My understanding, based on the original wording and places where this is used, is that the data is often pre-processed into 57-byte chunks, rather than post-processing it. Maybe it is worthwhile restoring that info. It should help understanding the presence of the newline parameter (or why a newline is always added in 3.5).
Also, the link between RFC 4648 and this function could be made even more explicit. Maybe move “as defined” into the first sentence, or change “the Base64 output” to “the function’s output”.
stage: -> patch review
versions: +Python 2.7, Python 3.4, Python 3.6
Python tracker <report at bugs.python.org>
More information about the docs