From: Barry Warsaw <barry@python.org>
Date: Mon, 10 May 2004 23:12:27 +0000 (+0000)
Subject: Added a note describing how fp should be opened in binary mode, especially on
X-Git-Tag: v2.3.4c1~23
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=bea27f3f555419c9385c98275d28e80a6e4302f4;p=thirdparty%2FPython%2Fcpython.git

Added a note describing how fp should be opened in binary mode, especially on
Windows.  Closes SF # 586899.
---

diff --git a/Doc/lib/libmailbox.tex b/Doc/lib/libmailbox.tex
index 947c2d33e18c..767b67827f55 100644
--- a/Doc/lib/libmailbox.tex
+++ b/Doc/lib/libmailbox.tex
@@ -18,6 +18,10 @@ argument, \var{fp} by the \method{next()} method of the mailbox
 object.  The default is the \class{rfc822.Message} class (see the
 \refmodule{rfc822} module -- and the note below).
 
+\note{For reasons of this module's internal implementation, you will probably
+want to open the \var{fp} object in binary mode.  This is especially important
+on Windows.}
+
 For maximum portability, messages in a \UNIX-style mailbox are
 separated by any line that begins exactly with the string \code{'From
 '} (note the trailing space) if preceded by exactly two newlines.