diff options
| author | R David Murray <rdmurray@bitdance.com> | 2015-12-13 23:04:27 (GMT) |
|---|---|---|
| committer | R David Murray <rdmurray@bitdance.com> | 2015-12-13 23:04:27 (GMT) |
| commit | 2b4f47ee35d945e3667abf3b081a15cf46d2c173 (patch) | |
| tree | 71025d1d4c890036772baa12d965818d0e5b02d2 | |
| parent | abeb6479bd59c998fc5e78ba70f300eec9da90ee (diff) | |
| download | cpython-2b4f47ee35d945e3667abf3b081a15cf46d2c173.zip cpython-2b4f47ee35d945e3667abf3b081a15cf46d2c173.tar.gz cpython-2b4f47ee35d945e3667abf3b081a15cf46d2c173.tar.bz2 | |
#25495: Clarify b2a_base64 documentation vis 57 bytes.
| -rw-r--r-- | Doc/library/binascii.rst | 9 |
1 files changed, 6 insertions, 3 deletions
diff --git a/Doc/library/binascii.rst b/Doc/library/binascii.rst index e3f134b..dbe535d 100644 --- a/Doc/library/binascii.rst +++ b/Doc/library/binascii.rst @@ -55,8 +55,10 @@ The :mod:`binascii` module defines the following functions: .. function:: b2a_base64(data) Convert binary data to a line of ASCII characters in base64 coding. The return - value is the converted line, including a newline char. The length of *data* - should be at most 57 to adhere to the base64 standard. + value is the converted line, including a newline char. The newline is + added because the original use case for this function was to feed it a + series of 57 byte input lines to get output lines that conform to the + MIME-base64 standard. Otherwise the output conforms to :rfc:`3548`. .. function:: a2b_qp(data, header=False) @@ -168,7 +170,8 @@ The :mod:`binascii` module defines the following functions: .. seealso:: Module :mod:`base64` - Support for base64 encoding used in MIME email messages. + Support for RFC compliant base64-style encoding in base 16, 32, 64, + and 85. Module :mod:`binhex` Support for the binhex format used on the Macintosh. |