diff options
author | Fred Drake <fdrake@acm.org> | 1998-04-02 16:24:29 (GMT) |
---|---|---|
committer | Fred Drake <fdrake@acm.org> | 1998-04-02 16:24:29 (GMT) |
commit | 674e0fd7a8ec41f37deb606aa9324f4edd5856ad (patch) | |
tree | 0667d882765cb495cb070482a13cd3ae9b0781f0 /Doc/lib/libbase64.tex | |
parent | b789c70d056eb40abfd24f114a5402440d18ac05 (diff) | |
download | cpython-674e0fd7a8ec41f37deb606aa9324f4edd5856ad.zip cpython-674e0fd7a8ec41f37deb606aa9324f4edd5856ad.tar.gz cpython-674e0fd7a8ec41f37deb606aa9324f4edd5856ad.tar.bz2 |
Be more specific about where in RFC 1421 to look, since it's not at all
obvious when taking a quick look.
Say "base64" instead of "base-64", since that seems to be how it's referred
to in other RFCs.
Diffstat (limited to 'Doc/lib/libbase64.tex')
-rw-r--r-- | Doc/lib/libbase64.tex | 23 |
1 files changed, 12 insertions, 11 deletions
diff --git a/Doc/lib/libbase64.tex b/Doc/lib/libbase64.tex index f196451..99fb09b 100644 --- a/Doc/lib/libbase64.tex +++ b/Doc/lib/libbase64.tex @@ -1,14 +1,17 @@ -\section{Standard Module \sectcode{base64}} +\section{Standard Module \module{base64}} \label{module-base64} \stmodindex{base64} -\indexii{base-64}{encoding} -\index{MIME!base 64 encoding} +\indexii{base64}{encoding} +\index{MIME!base64 encoding} -This module perform base-64 encoding and decoding of arbitrary binary +This module perform base64 encoding and decoding of arbitrary binary strings into text strings that can be safely emailed or posted. The -encoding scheme is defined in \rfc{1421} and is used for MIME email and +encoding scheme is defined in \rfc{1421} (``Privacy Enhancement for +Internet Electronic Mail: Part I: Message Encryption and +Authentication Procedures'', section 4.3.2.4, ``Step 4: Printable +Encoding'') and is used for MIME email and various other Internet-related applications; it is not the same as the -output produced by the \file{uuencode} program. For example, the +output produced by the \program{uuencode} program. For example, the string \code{'www.python.org'} is encoded as the string \code{'d3d3LnB5dGhvbi5vcmc=\e n'}. @@ -24,13 +27,13 @@ mimic the file object interface. \var{input} will be read until \begin{funcdesc}{decodestring}{s} Decode the string \var{s}, which must contain one or more lines of -base-64 encoded data, and return a string containing the resulting +base64 encoded data, and return a string containing the resulting binary data. \end{funcdesc} \begin{funcdesc}{encode}{input, output} Encode the contents of the \var{input} file and write the resulting -base-64 encoded data to the \var{output} file. +base64 encoded data to the \var{output} file. \var{input} and \var{output} must either be file objects or objects that mimic the file object interface. \var{input} will be read until \code{\var{input}.read()} returns an empty string. @@ -39,7 +42,5 @@ mimic the file object interface. \var{input} will be read until \begin{funcdesc}{encodestring}{s} Encode the string \var{s}, which can contain arbitrary binary data, and return a string containing one or more lines of -base-64 encoded data. +base64 encoded data. \end{funcdesc} - - |