cpython/Doc/library
R. David Murray b7deff1ddc #9124: mailbox now accepts binary input and uses binary internally
Although this patch contains API changes and is rather weighty for an
RC phase, the mailbox module was essentially unusable without the patch
since it would produce UnicodeErrors when handling non-ascii input
at arbitrary and somewhat mysterious places, and any non-trivial amount
of email processing will encounter messages with non-ascii bytes.
The release manager approved the patch application.

The changes allow binary input, and reject non-ASCII string input early
with a useful message instead of failing mysteriously later.  Binary
is used internally for reading and writing the mailbox files.  StringIO
and Text file input are deprecated.

Initial patch by Victor Stinner, validated and expanded by R. David Murray.
2011-01-30 06:21:28 +00:00
..
2to3.rst Fix a few doc errors, mostly undefined keywords. 2011-01-15 17:03:02 +00:00
__future__.rst
__main__.rst
_dummy_thread.rst
_thread.rst Issue #8844: Regular and recursive lock acquisitions can now be interrupted 2010-12-15 22:59:16 +00:00
abc.rst Missing source links. 2011-01-24 16:28:06 +00:00
aifc.rst Missing source links. 2011-01-24 16:28:06 +00:00
allos.rst Logging documentation reorganised. 2010-12-19 12:56:57 +00:00
archiving.rst
argparse.rst More source links. 2011-01-27 01:20:32 +00:00
array.rst Obsolete aliases needn't be documented 2010-12-12 18:14:34 +00:00
ast.rst Issue #11000 ast.parse parses source, not just expressions. 2011-01-24 21:36:03 +00:00
asynchat.rst Missing source links. 2011-01-24 16:28:06 +00:00
asyncore.rst Missing source links. 2011-01-24 16:28:06 +00:00
atexit.rst atexit.py doesn't exist 2011-01-07 18:42:21 +00:00
audioop.rst Fix copy-paste error in example. 2010-10-17 10:07:29 +00:00
base64.rst #1466065: add validate option to base64.b64decode 2010-11-11 20:09:20 +00:00
bdb.rst More source links. 2011-01-27 01:20:32 +00:00
binascii.rst Consistency check for versionadded/changed directives. 2010-08-17 15:07:14 +00:00
binhex.rst
bisect.rst Separate source link from main text. 2011-01-10 19:54:11 +00:00
builtins.rst Remove parenthetical remark that is confusing now that the module is not named "__builtin__" anymore. 2010-11-26 12:08:19 +00:00
bz2.rst Add cross-references to the glossary entry for file objects. 2010-09-15 11:11:28 +00:00
calendar.rst Separate source link from main text. 2011-01-10 19:54:11 +00:00
cgi.rst More source links. 2011-01-27 01:20:32 +00:00
cgitb.rst
chunk.rst
cmath.rst Include versionadded in (c)math.isfinite docs (thanks Ezio Melotti). Other minor doc cleanups. 2010-07-11 19:47:37 +00:00
cmd.rst Separate source link from main text. 2011-01-10 19:54:11 +00:00
code.rst
codecs.rst remove (un)transform methods 2010-12-12 01:33:04 +00:00
codeop.rst
collections.rst More source links. 2011-01-27 01:20:32 +00:00
colorsys.rst More source links. 2011-01-27 01:20:32 +00:00
compileall.rst #10454: clarify the compileall docs and help messages. 2010-12-17 16:29:07 +00:00
concurrent.futures.rst More source links. 2011-01-27 01:20:32 +00:00
configparser.rst #11027: documented how to override SECTCRE 2011-01-28 11:57:30 +00:00
constants.rst Remove redundant information. 2010-08-02 19:39:17 +00:00
contextlib.rst Separate source link from main text. 2011-01-10 19:54:11 +00:00
copy.rst
copyreg.rst
crypt.rst
crypto.rst
csv.rst Fix various issues (mostly Python 2 relics) found by Jacques Ducasse. 2011-01-06 09:23:56 +00:00
ctypes.rst #10944: add c_bool to types table. 2011-01-19 20:05:49 +00:00
curses.ascii.rst
curses.panel.rst
curses.rst Remove mentions of the Demo directory. 2010-12-30 22:12:40 +00:00
custominterp.rst
datatypes.rst
datetime.rst Improved footnote for the %Y directive slightly. 2011-01-10 23:31:51 +00:00
dbm.rst #10609: fix non-working dbm example. 2010-12-28 11:53:25 +00:00
debug.rst
decimal.rst Issue #10225: Fixed the simple mistakes in doctests. 2011-01-12 16:37:14 +00:00
development.rst
difflib.rst Issue 10534, difflib: tweak doc; test new SequenceMatcher instance attributes; avoid unneeded lists of SM.b2j keys and items in .__chain_b. Do not backport. 2010-12-15 20:18:10 +00:00
dis.rst Separate source link from main text. 2011-01-10 19:54:11 +00:00
distutils.rst
doctest.rst #10698: fix typo in example. 2010-12-13 22:50:30 +00:00
dummy_threading.rst More source links 2011-01-27 20:38:46 +00:00
email-examples.rst Adding an example of reproducing the rfc822.Message() parsing. 2010-03-19 23:23:05 +00:00
email.charset.rst Fix various issues (mostly Python 2 relics) found by Jacques Ducasse. 2011-01-06 09:23:56 +00:00
email.encoders.rst
email.errors.rst Terminology fix: exceptions are raised, except in generator.throw(). 2010-08-03 12:06:29 +00:00
email.generator.rst #10686: recode non-ASCII headers to 'unknown-8bit' instead of ?s. 2011-01-07 23:25:30 +00:00
email.header.rst #10686: recode non-ASCII headers to 'unknown-8bit' instead of ?s. 2011-01-07 23:25:30 +00:00
email.iterators.rst
email.message.rst #10686: recode non-ASCII headers to 'unknown-8bit' instead of ?s. 2011-01-07 23:25:30 +00:00
email.mime.rst Merged revisions 77412 via svnmerge from 2010-01-10 19:18:27 +00:00
email.parser.rst #4661: add bytes parsing and generation to email (email version bump to 5.1.0) 2010-10-08 15:55:28 +00:00
email.rst Fixing some sphinx inline directives - detected using ``make check``. 2010-10-15 12:55:19 +00:00
email.util.rst #8989: add 'domain' keyword to make_msgid. 2010-12-02 21:47:19 +00:00
errno.rst
exceptions.rst #10856: document (Base)Exception.args better. 2011-01-07 18:28:45 +00:00
fcntl.rst Migrate to Sphinx 1.0 C language constructs. 2010-10-06 10:11:56 +00:00
filecmp.rst Separate source link from main text. 2011-01-10 19:54:11 +00:00
fileformats.rst Issue 10499: Modular interpolation in configparser 2010-12-03 16:28:00 +00:00
fileinput.rst Separate source link from main text. 2011-01-10 19:54:11 +00:00
filesys.rst Add cross-references to the glossary entry for file objects. 2010-09-15 11:11:28 +00:00
fnmatch.rst Separate source link from main text. 2011-01-10 19:54:11 +00:00
formatter.rst Add cross-references to the glossary entry for file objects. 2010-09-15 11:11:28 +00:00
fpectl.rst
fractions.rst More source links 2011-01-27 20:38:46 +00:00
frameworks.rst Issue #7061: Dropped "for Tk" from turtle module title and moved its 2010-10-27 03:06:43 +00:00
ftplib.rst More source links 2011-01-27 20:38:46 +00:00
functional.rst itertools, operator and functools are not really "numeric" modules; move them into their own "functional" chapter. 2011-01-06 09:23:19 +00:00
functions.rst Replace sys.maxint mention by sys.maxsize. 2010-12-28 09:16:12 +00:00
functools.rst Missed two source links 2011-01-10 21:16:07 +00:00
gc.rst Add a new warning gategory, ResourceWarning, as discussed on python-dev. It is silent by default, 2010-10-24 15:11:22 +00:00
getopt.rst More source links 2011-01-27 20:38:46 +00:00
getpass.rst
gettext.rst More source links 2011-01-27 20:38:46 +00:00
glob.rst Separate source link from main text. 2011-01-10 19:54:11 +00:00
grp.rst #775964: skip YP/NIS entries instead of failing the test 2010-12-14 16:20:53 +00:00
gzip.rst More source links 2011-01-27 20:38:46 +00:00
hashlib.rst More source links 2011-01-27 20:38:46 +00:00
heapq.rst Separate source link from main text. 2011-01-10 19:54:11 +00:00
hmac.rst More source links 2011-01-27 20:38:46 +00:00
html.entities.rst More source links. 2011-01-27 01:20:32 +00:00
html.parser.rst More source links. 2011-01-27 01:20:32 +00:00
html.rst More source links. 2011-01-27 01:20:32 +00:00
http.client.rst Typos. 2011-01-30 00:39:00 +00:00
http.cookiejar.rst More source links 2011-01-27 20:38:46 +00:00
http.cookies.rst More source links 2011-01-27 20:38:46 +00:00
http.server.rst More source links 2011-01-27 20:38:46 +00:00
i18n.rst
idle.rst Fix usage of :option: in the docs (#9312). 2010-11-18 16:38:46 +00:00
imaplib.rst More source links 2011-01-27 20:38:46 +00:00
imghdr.rst More source links 2011-01-27 20:38:46 +00:00
imp.rst Remove mentions of the Demo directory. 2010-12-30 22:12:40 +00:00
importlib.rst Fix a few doc errors, mostly undefined keywords. 2011-01-15 17:03:02 +00:00
index.rst itertools, operator and functools are not really "numeric" modules; move them into their own "functional" chapter. 2011-01-06 09:23:19 +00:00
inspect.rst More source links 2011-01-27 20:38:46 +00:00
internet.rst
intro.rst
io.rst Add an "advanced topics" section to the io doc. 2010-12-03 19:14:17 +00:00
ipc.rst
itertools.rst Fix the example output of count(). 2011-01-13 07:31:18 +00:00
json.rst Fix JSON docs about loads() accepting only str objects, not bytes. 2011-01-21 21:37:32 +00:00
keyword.rst Separate source link from main text. 2011-01-10 19:54:11 +00:00
language.rst Merged revisions 77712,77740-77741,77756,77886,77902,77936 via svnmerge from 2010-02-03 02:59:43 +00:00
linecache.rst Separate source link from main text. 2011-01-10 19:54:11 +00:00
locale.rst #10200: typo. 2010-10-26 19:58:11 +00:00
logging.config.rst Issue 11008: docs updated to show versionadded for dictConfig. 2011-01-27 19:14:16 +00:00
logging.handlers.rst Logging documentation updates. 2010-12-22 15:04:15 +00:00
logging.rst Logging documentation updates. 2010-12-19 13:41:26 +00:00
macpath.rst
mailbox.rst #9124: mailbox now accepts binary input and uses binary internally 2011-01-30 06:21:28 +00:00
mailcap.rst More source links 2011-01-27 20:38:46 +00:00
markup.rst #2830: add html.escape() helper and move cgi.escape() uses in the standard library to it. It defaults to quote=True and also escapes single quotes, which makes casual use safer. The cgi.escape() interface is not touched, but emits a (silent) PendingDeprecationWarning. 2010-10-15 15:57:45 +00:00
marshal.rst
math.rst Include versionadded in (c)math.isfinite docs (thanks Ezio Melotti). Other minor doc cleanups. 2010-07-11 19:47:37 +00:00
mimetypes.rst More source links 2011-01-27 20:38:46 +00:00
misc.rst
mm.rst
mmap.rst Add cross-references to the glossary entry for file objects. 2010-09-15 11:11:28 +00:00
modulefinder.rst More source links 2011-01-27 20:38:46 +00:00
modules.rst
msilib.rst Remove unexistent parameter (#3216) 2010-12-26 02:38:05 +00:00
msvcrt.rst Migrate to Sphinx 1.0 C language constructs. 2010-10-06 10:11:56 +00:00
multiprocessing.rst Homogenize the "optional OS services" menu 2010-12-12 20:34:49 +00:00
netdata.rst
netrc.rst More source links 2011-01-27 20:38:46 +00:00
nis.rst
nntplib.rst More source links 2011-01-27 20:38:46 +00:00
numbers.rst Merged revisions 80826 via svnmerge from 2010-05-05 21:54:18 +00:00
numeric.rst itertools, operator and functools are not really "numeric" modules; move them into their own "functional" chapter. 2011-01-06 09:23:19 +00:00
operator.rst Issue #10225: Fixed the simple mistakes in doctests. 2011-01-12 16:37:14 +00:00
optparse.rst More source links 2011-01-27 20:38:46 +00:00
os.path.rst Consistent ordering of availability statements 2010-12-12 20:17:29 +00:00
os.rst #10960: fix 'stat' links, link to lstat from stat, general tidy of stat doc. 2011-01-24 19:34:58 +00:00
ossaudiodev.rst #6518: enable context manager protocol for ossaudiodev types. 2010-10-23 17:31:52 +00:00
othergui.rst
parser.rst Let’s keep “throw” for the generator method and use “raise” elsewhere. 2010-11-30 17:20:31 +00:00
pdb.rst Issue #10902: Fix reference to run* methods 2011-01-14 08:25:03 +00:00
persistence.rst
pickle.rst Fix typo. 2010-11-30 14:57:54 +00:00
pickletools.rst Issue #9268: Documented -m pickletools usage. 2011-01-13 21:58:44 +00:00
pipes.rst More source links 2011-01-27 20:38:46 +00:00
pkgutil.rst More source links 2011-01-27 20:38:46 +00:00
platform.rst More source links 2011-01-27 20:38:46 +00:00
plistlib.rst More source links 2011-01-27 20:38:46 +00:00
poplib.rst More source links 2011-01-27 20:38:46 +00:00
posix.rst Migrate to Sphinx 1.0 C language constructs. 2010-10-06 10:11:56 +00:00
pprint.rst Separate source link from main text. 2011-01-10 19:54:11 +00:00
profile.rst More source links 2011-01-27 20:38:46 +00:00
pty.rst Remove some of the old demos. (Put a few somewhere else.) 2010-12-30 17:22:33 +00:00
pwd.rst
py_compile.rst More source links 2011-01-27 20:38:46 +00:00
pyclbr.rst More source links. 2011-01-27 01:20:32 +00:00
pydoc.rst More source links 2011-01-27 20:38:46 +00:00
pyexpat.rst Issue #5485: Add doc for expat.xmlparser.SetParamEntityParsing. 2011-01-05 18:37:22 +00:00
python.rst Merged revisions 77712,77740-77741,77756,77886,77902,77936 via svnmerge from 2010-02-03 02:59:43 +00:00
queue.rst Separate source link from main text. 2011-01-10 19:54:11 +00:00
quopri.rst Missed two source links 2011-01-10 21:16:07 +00:00
random.rst Separate source link from main text. 2011-01-10 19:54:11 +00:00
re.rst Make the example a little more interesting and useful. 2010-12-07 09:44:21 +00:00
readline.rst #10034: import readline in longer example. 2010-10-06 05:08:32 +00:00
reprlib.rst Add entry for reprlib. 2011-01-23 21:05:46 +00:00
resource.rst Issue #10440: Support RUSAGE_THREAD as a constant in the resource module. 2010-11-17 16:19:35 +00:00
rlcompleter.rst More source links 2011-01-27 20:38:46 +00:00
runpy.rst More source links. 2011-01-27 01:20:32 +00:00
sched.rst Separate source link from main text. 2011-01-10 19:54:11 +00:00
select.rst Fix the description of PIPE_BUF 2011-01-25 17:24:57 +00:00
shelve.rst Separate source link from main text. 2011-01-10 19:54:11 +00:00
shlex.rst More source links. 2011-01-27 01:20:32 +00:00
shutil.rst Add entry for shutil's archiving operations. 2011-01-23 11:29:08 +00:00
signal.rst Migrate to Sphinx 1.0 C language constructs. 2010-10-06 10:11:56 +00:00
site.rst More source links 2011-01-27 20:38:46 +00:00
smtpd.rst More source links 2011-01-27 20:38:46 +00:00
smtplib.rst More source links 2011-01-27 20:38:46 +00:00
sndhdr.rst More source links 2011-01-27 20:38:46 +00:00
socket.rst Overhaul the documentation about socket timeouts. 2011-01-05 21:17:36 +00:00
socketserver.rst More source links 2011-01-27 20:38:46 +00:00
someos.rst Homogenize the "optional OS services" menu 2010-12-12 20:34:49 +00:00
spwd.rst
sqlite3.rst there's now a setup.py switch for this 2010-11-28 02:51:28 +00:00
ssl.rst More source links 2011-01-27 20:38:46 +00:00
stat.rst More source links 2011-01-27 20:38:46 +00:00
stdtypes.rst Fix a few doc errors, mostly undefined keywords. 2011-01-15 17:03:02 +00:00
string.rst Typo fix. 2011-01-24 19:53:18 +00:00
stringprep.rst
strings.rst
struct.rst Issue #10783: struct.pack() doesn't encode implicitly unicode to UTF-8 2010-12-28 13:26:42 +00:00
subprocess.rst Issue #6559: fix the subprocess.Popen pass_fds implementation. Add a unittest. 2010-12-14 13:43:30 +00:00
sunau.rst More source links 2011-01-27 20:38:46 +00:00
symbol.rst More source links. 2011-01-27 01:20:32 +00:00
symtable.rst Merged revisions 81385 via svnmerge from 2010-05-20 22:29:43 +00:00
sys.rst Fix a few doc errors, mostly undefined keywords. 2011-01-15 17:03:02 +00:00
sysconfig.rst More source links. 2011-01-27 01:20:32 +00:00
syslog.rst Merged revisions 80030,80067,80069,80080-80081,80084,80432-80433,80465-80470,81059,81065-81067 via svnmerge from 2010-05-19 20:57:08 +00:00
tabnanny.rst More source links. 2011-01-27 01:20:32 +00:00
tarfile.rst More source links. 2011-01-27 01:20:32 +00:00
telnetlib.rst More source links 2011-01-27 20:38:46 +00:00
tempfile.rst More source links. 2011-01-27 01:20:32 +00:00
termios.rst Add cross-references to the glossary entry for file objects. 2010-09-15 11:11:28 +00:00
test.rst Make this a note again. 2010-12-18 12:33:06 +00:00
textwrap.rst Separate source link from main text. 2011-01-10 19:54:11 +00:00
threading.rst Add entry for Barrier objects. 2011-01-11 19:59:46 +00:00
time.rst Issue #2568: Removed bogus rationale for supporting tm_sec=61. 2011-01-10 22:56:14 +00:00
timeit.rst More source links. 2011-01-27 01:20:32 +00:00
tk.rst Issue #7061: Dropped "for Tk" from turtle module title and moved its 2010-10-27 03:06:43 +00:00
tkinter.rst Remove mentions of the Demo directory. 2010-12-30 22:12:40 +00:00
tkinter.scrolledtext.rst
tkinter.tix.rst Update last tix code example for 3.x, as already done for previous examples. 2011-01-24 20:48:40 +00:00
tkinter.ttk.rst #7057: fix several errors. 2010-03-14 09:51:37 +00:00
token.rst More source links. 2011-01-27 01:20:32 +00:00
tokenize.rst Separate source link from main text. 2011-01-10 19:54:11 +00:00
trace.rst Separate source link from main text. 2011-01-10 19:54:11 +00:00
traceback.rst Merged revisions 78895 via svnmerge from 2010-03-13 01:28:34 +00:00
tty.rst
turtle-star.pdf Issue #7061: Added a 'Turtle star' sidebar 2010-11-09 18:40:03 +00:00
turtle-star.png Issue #7061: Added a 'Turtle star' sidebar 2010-11-09 18:40:03 +00:00
turtle-star.ps Issue #7061: Added a 'Turtle star' sidebar 2010-11-09 18:40:03 +00:00
turtle.rst Issue #10225: Fixed the simple mistakes in doctests. 2011-01-12 16:37:14 +00:00
types.rst More source links. 2011-01-27 01:20:32 +00:00
undoc.rst
unicodedata.rst Updated UCD version and unicode.org links to Unicode 6.0.0 2010-12-10 18:11:24 +00:00
unittest.rst Issue 10573: revert unittest docs to first / second 2011-01-28 19:51:48 +00:00
unix.rst
urllib.error.rst
urllib.parse.rst Fix label syntax. 2011-01-24 19:59:08 +00:00
urllib.request.rst #3243 follow-up: remove debugging print and fix docs; data is a bytes object. 2010-12-19 12:33:52 +00:00
urllib.robotparser.rst
uu.rst Separate source link from main text. 2011-01-10 19:54:11 +00:00
uuid.rst
warnings.rst More source links 2011-01-27 20:38:46 +00:00
wave.rst More source links 2011-01-27 20:38:46 +00:00
weakref.rst More source links 2011-01-27 20:38:46 +00:00
webbrowser.rst More source links 2011-01-27 20:38:46 +00:00
windows.rst
winreg.rst Implement #8521. Added named argument handling to winreg's CreateKeyEx, 2010-09-27 17:56:36 +00:00
winsound.rst Migrate to Sphinx 1.0 C language constructs. 2010-10-06 10:11:56 +00:00
wsgiref.rst Implement http://bugs.python.org/issue10155 using And Clover's patch, w/added 2010-11-03 22:39:01 +00:00
xdrlib.rst More source links 2011-01-27 20:38:46 +00:00
xml.dom.minidom.rst #10781: clarify that *encoding* is not a parameter for Node objects in general. 2010-12-28 11:15:49 +00:00
xml.dom.pulldom.rst
xml.dom.rst #1495229: update the type names used by the XML DOM mapping 2010-07-25 22:57:12 +00:00
xml.etree.elementtree.rst Add cross-references to the glossary entry for file objects. 2010-09-15 11:11:28 +00:00
xml.sax.handler.rst Fix latex conversion glitch in property/feature descriptions. 2010-11-08 11:05:18 +00:00
xml.sax.reader.rst Terminology fix: exceptions are raised, except in generator.throw(). 2010-08-03 12:06:29 +00:00
xml.sax.rst
xml.sax.utils.rst #1343: Add short_empty_elements option to XMLGenerator. 2010-10-17 22:46:45 +00:00
xmlrpc.client.rst Merged revisions 77484,77487,77561,77570,77593,77603,77608,77667,77702-77703,77739,77858,77887,77889 via svnmerge from 2010-02-03 02:35:45 +00:00
xmlrpc.server.rst #7814: fix wrong example function usage. 2010-01-30 17:54:04 +00:00
zipfile.rst More source links 2011-01-27 20:38:46 +00:00
zipimport.rst Consistency check for versionadded/changed directives. 2010-08-17 15:07:14 +00:00
zlib.rst zlib only works with bytes objects. 2011-01-08 21:04:25 +00:00