]> granicus.if.org Git - python/commitdiff
Patch 547037. Corrected documentation to match
authorRaymond Hettinger <python@rcn.com>
Thu, 16 May 2002 04:28:44 +0000 (04:28 +0000)
committerRaymond Hettinger <python@rcn.com>
Thu, 16 May 2002 04:28:44 +0000 (04:28 +0000)
actual module behavior for adding newlines.

Doc/lib/libbase64.tex

index 612da4c52aed0c1ca838398781de55b6abb9f783..91f4818d1ef67fe6dc0116d51f4113e363c06a8a 100644 (file)
@@ -40,21 +40,19 @@ Encode the contents of the \var{input} file and write the resulting
 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.  If the last input
-character is not a newline (\code{'\e n'}), a newline will be added to
-the input data.
+\code{\var{input}.read()} returns an empty string.  \function{encode()}
+returns the encoded data plus a trailing newline character
+(\code{'\e n'}).
 \end{funcdesc}
 
 \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
-base64-encoded data.  If the last character of \var{s} is not a
-newline (\code{'\e n'}), a newline will be added.  This causes
-\code{encodestring('hello!')} to return the same value as
-\code{encodestring('hello!\e n')}.
+base64-encoded data.  \function{encodestring()} returns a
+string containing one or more lines of base64-encoded data
+always including an extra trailing newline (\code{'\e n'}).
 \end{funcdesc}
 
-
 \begin{seealso}
   \seemodule{binascii}{Support module containing \ASCII-to-binary
                        and binary-to-\ASCII{} conversions.}