Imported Upstream version 3.4.7 97/155897/1
authorDongHun Kwak <dh0128.kwak@samsung.com>
Mon, 16 Oct 2017 10:57:18 +0000 (19:57 +0900)
committerDongHun Kwak <dh0128.kwak@samsung.com>
Mon, 16 Oct 2017 10:57:29 +0000 (19:57 +0900)
Change-Id: I8279a01e2a6ec6081e994caa6d0691177c5507dc
Signed-off-by: DongHun Kwak <dh0128.kwak@samsung.com>
45 files changed:
Doc/Makefile
Doc/copyright.rst
Doc/library/smtpd.rst
Doc/library/ssl.rst
Doc/tools/extensions/pyspecific.py
Doc/tools/susp-ignored.csv
Doc/whatsnew/changelog.rst
Include/patchlevel.h
Lib/ftplib.py
Lib/http/server.py
Lib/pydoc_data/topics.py
Lib/ssl.py
Lib/subprocess.py
Lib/test/test_dict.py
Lib/test/test_ftplib.py
Lib/test/test_httpservers.py
Lib/test/test_imaplib.py
Lib/test/test_os.py
Lib/test/test_subprocess.py
Lib/test/test_urlparse.py
Lib/test/test_weakref.py
Lib/urllib/parse.py
Misc/ACKS
Misc/NEWS
Modules/_winapi.c
Modules/expat/COPYING
Modules/expat/amigaconfig.h [deleted file]
Modules/expat/expat.h
Modules/expat/expat_external.h
Modules/expat/internal.h
Modules/expat/macconfig.h [deleted file]
Modules/expat/siphash.h [new file with mode: 0644]
Modules/expat/watcomconfig.h [deleted file]
Modules/expat/winconfig.h
Modules/expat/xmlparse.c
Modules/expat/xmlrole.c
Modules/expat/xmltok.c
Modules/expat/xmltok.h
Modules/expat/xmltok_impl.c
Modules/pyexpat.c
Objects/abstract.c
Objects/dictobject.c
Objects/typeobject.c
PCbuild/_elementtree.vcxproj
README

index e3d204d..8e70b21 100644 (file)
@@ -4,22 +4,24 @@
 #
 
 # You can set these variables from the command line.
-PYTHON       = python
+PYTHON       = python3
 SPHINXBUILD  = sphinx-build
+BLURB = $(PYTHON) -m blurb
 PAPER        =
 SOURCES      =
 DISTVERSION  = $(shell $(PYTHON) tools/extensions/patchlevel.py)
 
-ALLSPHINXOPTS = -b $(BUILDER) -d build/doctrees -D latex_paper_size=$(PAPER) \
+ALLSPHINXOPTS = -b $(BUILDER) -d build/doctrees -D latex_elements.papersize=$(PAPER) \
                 $(SPHINXOPTS) . build/$(BUILDER) $(SOURCES)
 
 .PHONY: help build html htmlhelp latex text changes linkcheck \
        suspicious coverage doctest pydoc-topics htmlview clean dist check serve \
-       autobuild-dev autobuild-stable
+       autobuild-dev autobuild-stable venv
 
 help:
        @echo "Please use \`make <target>' where <target> is one of"
        @echo "  clean      to remove build files"
+       @echo "  venv       to create a venv with necessary tools"
        @echo "  html       to make standalone HTML files"
        @echo "  htmlview   to open the index page built by the html target in your browser"
        @echo "  htmlhelp   to make HTML files and a HTML help project"
@@ -37,6 +39,20 @@ help:
        @echo "  serve      to serve the documentation on the localhost (8000)"
 
 build:
+       -mkdir -p build
+# Look first for a Misc/NEWS file (building from a source release tarball
+# or old repo) and use that, otherwise look for a Misc/NEWS.d directory
+# (building from a newer repo) and use blurb to generate the NEWS file.
+       @if [ -f  ../Misc/NEWS ] ; then \
+               echo "Using existing Misc/NEWS file"; \
+               cp ../Misc/NEWS build/NEWS; \
+       elif [ -d ../Misc/NEWS.d ]; then \
+               echo "Building NEWS from Misc/NEWS.d with blurb"; \
+               $(BLURB) merge -f build/NEWS; \
+       else \
+               echo "Neither Misc/NEWS.d nor Misc/NEWS found; cannot build docs"; \
+               exit 1; \
+       fi
        $(SPHINXBUILD) $(ALLSPHINXOPTS)
        @echo
 
@@ -102,7 +118,11 @@ htmlview: html
         $(PYTHON) -c "import webbrowser; webbrowser.open('build/html/index.html')"
 
 clean:
-       -rm -rf build/*
+       -rm -rf build/* venv/*
+
+venv:
+       $(PYTHON) -m venv venv
+       ./venv/bin/python3 -m pip install -U Sphinx
 
 dist:
        rm -rf dist
@@ -148,21 +168,26 @@ dist:
        cp -pPR build/epub/Python.epub dist/python-$(DISTVERSION)-docs.epub
 
 check:
-       $(PYTHON) tools/rstlint.py -i tools
+       $(PYTHON) tools/rstlint.py -i tools -i venv -i README.rst
 
 serve:
        ../Tools/scripts/serve.py build/html
 
 # Targets for daily automated doc build
+# By default, Sphinx only rebuilds pages where the page content has changed.
+# This means it doesn't always pick up changes to preferred link targets, etc
+# To ensure such changes are picked up, we build the published docs with
+# `-E` (to ignore the cached environment) and `-a` (to ignore already existing
+# output files)
 
 # for development releases: always build
 autobuild-dev:
-       make dist SPHINXOPTS='-A daily=1 -A versionswitcher=1'
+       make dist SPHINXOPTS='$(SPHINXOPTS) -Ea -A daily=1 -A versionswitcher=1'
        -make suspicious
 
 # for quick rebuilds (HTML only)
 autobuild-dev-html:
-       make html SPHINXOPTS='-A daily=1 -A versionswitcher=1'
+       make html SPHINXOPTS='$(SPHINXOPTS) -Ea -A daily=1 -A versionswitcher=1'
 
 # for stable releases: only build if not in pre-release stage (alpha, beta)
 # release candidate downloads are okay, since the stable tree can be in that stage
index 22d7705..2b5400c 100644 (file)
@@ -4,7 +4,7 @@ Copyright
 
 Python and this documentation is:
 
-Copyright © 2001-2016 Python Software Foundation. All rights reserved.
+Copyright © 2001-2017 Python Software Foundation. All rights reserved.
 
 Copyright © 2000 BeOpen.com. All rights reserved.
 
index 3ebed06..78f9d7f 100644 (file)
 
 This module offers several classes to implement SMTP (email) servers.
 
+.. seealso::
+
+    The `aiosmtpd <http://aiosmtpd.readthedocs.io/>`_ package is a recommended
+    replacement for this module.  It is based on :mod:`asyncio` and provides a
+    more straightforward API.  :mod:`smtpd` should be considered deprecated.
+
 Several server implementations are present; one is a generic
 do-nothing implementation, which can be overridden, while the other two offer
 specific mail-sending strategies.
index b0cf4eb..1ad4d61 100644 (file)
@@ -280,6 +280,12 @@ purposes.
 
      RC4 was dropped from the default cipher string.
 
+   .. versionchanged:: 3.4.7
+
+     ChaCha20/Poly1305 was added to the default cipher string.
+
+     3DES was dropped from the default cipher string.
+
 
 Random generation
 ^^^^^^^^^^^^^^^^^
index 64a5665..f719ae1 100644 (file)
@@ -15,6 +15,7 @@ from os import path
 from time import asctime
 from pprint import pformat
 from docutils.io import StringOutput
+from docutils.parsers.rst import Directive
 from docutils.utils import new_document
 
 from docutils import nodes, utils
@@ -22,7 +23,6 @@ from docutils import nodes, utils
 from sphinx import addnodes
 from sphinx.builders import Builder
 from sphinx.util.nodes import split_explicit_title
-from sphinx.util.compat import Directive
 from sphinx.writers.html import HTMLTranslator
 from sphinx.writers.text import TextWriter
 from sphinx.writers.latex import LaTeXTranslator
@@ -34,7 +34,7 @@ import suspicious
 
 
 ISSUE_URI = 'https://bugs.python.org/issue%s'
-SOURCE_URI = 'https://hg.python.org/cpython/file/3.4/%s'
+SOURCE_URI = 'https://github.com/python/cpython/tree/3.4/%s'
 
 # monkey-patch reST parser to disable alphabetic and roman enumerated lists
 from docutils.parsers.rst.states import Body
index 032531d..32e21f0 100644 (file)
@@ -281,7 +281,7 @@ whatsnew/3.2,,:location,zope9-location = ${zope9:location}
 whatsnew/3.2,,:prefix,zope-conf = ${custom:prefix}/etc/zope.conf
 whatsnew/changelog,,:platform,:platform:
 whatsnew/changelog,,:gz,": TarFile opened with external fileobj and ""w:gz"" mode didn't"
-whatsnew/changelog,,:PythonCmd,"With Tk < 8.5 _tkinter.c:PythonCmd() raised UnicodeDecodeError, caused"
+whatsnew/changelog,,:PythonCmd,"Tk < 8.5 _tkinter.c:PythonCmd() raised UnicodeDecodeError, caused IDLE to"
 whatsnew/changelog,,::,": Fix FTP tests for IPv6, bind to ""::1"" instead of ""localhost""."
 whatsnew/changelog,,::,": Use ""127.0.0.1"" or ""::1"" instead of ""localhost"" as much as"
 whatsnew/changelog,,:password,user:password
index 07f9094..b435614 100644 (file)
@@ -1,5 +1,7 @@
+.. _changelog:
+
 +++++++++
 Changelog
 +++++++++
 
-.. miscnews:: ../../Misc/NEWS
+.. miscnews:: ../build/NEWS
index f52922d..44a6c71 100644 (file)
 /*--start constants--*/
 #define PY_MAJOR_VERSION       3
 #define PY_MINOR_VERSION       4
-#define PY_MICRO_VERSION       6
+#define PY_MICRO_VERSION       7
 #define PY_RELEASE_LEVEL       PY_RELEASE_LEVEL_FINAL
 #define PY_RELEASE_SERIAL      0
 
 /* Version as a string */
-#define PY_VERSION             "3.4.6"
+#define PY_VERSION             "3.4.7"
 /*--end constants--*/
 
 /* Version as a single 4-byte hex number, e.g. 0x010502B2 == 1.5.2b2.
index 1d3bd9e..47f02f8 100644 (file)
@@ -187,6 +187,8 @@ class FTP:
 
     # Internal: send one line to the server, appending CRLF
     def putline(self, line):
+        if '\r' in line or '\n' in line:
+            raise ValueError('an illegal newline character should not be contained')
         line = line + CRLF
         if self.debugging > 1:
             print('*put*', self.sanitize(line))
index 4688096..2cfd317 100644 (file)
@@ -817,9 +817,9 @@ class SimpleHTTPRequestHandler(BaseHTTPRequestHandler):
         words = filter(None, words)
         path = os.getcwd()
         for word in words:
-            drive, word = os.path.splitdrive(word)
-            head, word = os.path.split(word)
-            if word in (os.curdir, os.pardir): continue
+            if os.path.dirname(word) or word in (os.curdir, os.pardir):
+                # Ignore components that are not a simple file/directory name
+                continue
             path = os.path.join(path, word)
         if trailing_slash:
             path += '/'
index 1cc4ef5..740d787 100644 (file)
@@ -1,5 +1,5 @@
 # -*- coding: utf-8 -*-
-# Autogenerated by Sphinx on Sun Jan  1 22:08:13 2017
+# Autogenerated by Sphinx on Wed Aug  9 00:06:25 2017
 topics = {'assert': u'\nThe "assert" statement\n**********************\n\nAssert statements are a convenient way to insert debugging assertions\ninto a program:\n\n   assert_stmt ::= "assert" expression ["," expression]\n\nThe simple form, "assert expression", is equivalent to\n\n   if __debug__:\n      if not expression: raise AssertionError\n\nThe extended form, "assert expression1, expression2", is equivalent to\n\n   if __debug__:\n      if not expression1: raise AssertionError(expression2)\n\nThese equivalences assume that "__debug__" and "AssertionError" refer\nto the built-in variables with those names.  In the current\nimplementation, the built-in variable "__debug__" is "True" under\nnormal circumstances, "False" when optimization is requested (command\nline option -O).  The current code generator emits no code for an\nassert statement when optimization is requested at compile time.  Note\nthat it is unnecessary to include the source code for the expression\nthat failed in the error message; it will be displayed as part of the\nstack trace.\n\nAssignments to "__debug__" are illegal.  The value for the built-in\nvariable is determined when the interpreter starts.\n',
  'assignment': u'\nAssignment statements\n*********************\n\nAssignment statements are used to (re)bind names to values and to\nmodify attributes or items of mutable objects:\n\n   assignment_stmt ::= (target_list "=")+ (expression_list | yield_expression)\n   target_list     ::= target ("," target)* [","]\n   target          ::= identifier\n              | "(" target_list ")"\n              | "[" target_list "]"\n              | attributeref\n              | subscription\n              | slicing\n              | "*" target\n\n(See section *Primaries* for the syntax definitions for\n*attributeref*, *subscription*, and *slicing*.)\n\nAn assignment statement evaluates the expression list (remember that\nthis can be a single expression or a comma-separated list, the latter\nyielding a tuple) and assigns the single resulting object to each of\nthe target lists, from left to right.\n\nAssignment is defined recursively depending on the form of the target\n(list). When a target is part of a mutable object (an attribute\nreference, subscription or slicing), the mutable object must\nultimately perform the assignment and decide about its validity, and\nmay raise an exception if the assignment is unacceptable.  The rules\nobserved by various types and the exceptions raised are given with the\ndefinition of the object types (see section *The standard type\nhierarchy*).\n\nAssignment of an object to a target list, optionally enclosed in\nparentheses or square brackets, is recursively defined as follows.\n\n* If the target list is a single target: The object is assigned to\n  that target.\n\n* If the target list is a comma-separated list of targets: The\n  object must be an iterable with the same number of items as there\n  are targets in the target list, and the items are assigned, from\n  left to right, to the corresponding targets.\n\n  * If the target list contains one target prefixed with an\n    asterisk, called a "starred" target: The object must be a sequence\n    with at least as many items as there are targets in the target\n    list, minus one.  The first items of the sequence are assigned,\n    from left to right, to the targets before the starred target.  The\n    final items of the sequence are assigned to the targets after the\n    starred target.  A list of the remaining items in the sequence is\n    then assigned to the starred target (the list can be empty).\n\n  * Else: The object must be a sequence with the same number of\n    items as there are targets in the target list, and the items are\n    assigned, from left to right, to the corresponding targets.\n\nAssignment of an object to a single target is recursively defined as\nfollows.\n\n* If the target is an identifier (name):\n\n  * If the name does not occur in a "global" or "nonlocal" statement\n    in the current code block: the name is bound to the object in the\n    current local namespace.\n\n  * Otherwise: the name is bound to the object in the global\n    namespace or the outer namespace determined by "nonlocal",\n    respectively.\n\n  The name is rebound if it was already bound.  This may cause the\n  reference count for the object previously bound to the name to reach\n  zero, causing the object to be deallocated and its destructor (if it\n  has one) to be called.\n\n* If the target is a target list enclosed in parentheses or in\n  square brackets: The object must be an iterable with the same number\n  of items as there are targets in the target list, and its items are\n  assigned, from left to right, to the corresponding targets.\n\n* If the target is an attribute reference: The primary expression in\n  the reference is evaluated.  It should yield an object with\n  assignable attributes; if this is not the case, "TypeError" is\n  raised.  That object is then asked to assign the assigned object to\n  the given attribute; if it cannot perform the assignment, it raises\n  an exception (usually but not necessarily "AttributeError").\n\n  Note: If the object is a class instance and the attribute reference\n  occurs on both sides of the assignment operator, the RHS expression,\n  "a.x" can access either an instance attribute or (if no instance\n  attribute exists) a class attribute.  The LHS target "a.x" is always\n  set as an instance attribute, creating it if necessary.  Thus, the\n  two occurrences of "a.x" do not necessarily refer to the same\n  attribute: if the RHS expression refers to a class attribute, the\n  LHS creates a new instance attribute as the target of the\n  assignment:\n\n     class Cls:\n         x = 3             # class variable\n     inst = Cls()\n     inst.x = inst.x + 1   # writes inst.x as 4 leaving Cls.x as 3\n\n  This description does not necessarily apply to descriptor\n  attributes, such as properties created with "property()".\n\n* If the target is a subscription: The primary expression in the\n  reference is evaluated.  It should yield either a mutable sequence\n  object (such as a list) or a mapping object (such as a dictionary).\n  Next, the subscript expression is evaluated.\n\n  If the primary is a mutable sequence object (such as a list), the\n  subscript must yield an integer.  If it is negative, the sequence\'s\n  length is added to it.  The resulting value must be a nonnegative\n  integer less than the sequence\'s length, and the sequence is asked\n  to assign the assigned object to its item with that index.  If the\n  index is out of range, "IndexError" is raised (assignment to a\n  subscripted sequence cannot add new items to a list).\n\n  If the primary is a mapping object (such as a dictionary), the\n  subscript must have a type compatible with the mapping\'s key type,\n  and the mapping is then asked to create a key/datum pair which maps\n  the subscript to the assigned object.  This can either replace an\n  existing key/value pair with the same key value, or insert a new\n  key/value pair (if no key with the same value existed).\n\n  For user-defined objects, the "__setitem__()" method is called with\n  appropriate arguments.\n\n* If the target is a slicing: The primary expression in the\n  reference is evaluated.  It should yield a mutable sequence object\n  (such as a list).  The assigned object should be a sequence object\n  of the same type.  Next, the lower and upper bound expressions are\n  evaluated, insofar they are present; defaults are zero and the\n  sequence\'s length.  The bounds should evaluate to integers. If\n  either bound is negative, the sequence\'s length is added to it.  The\n  resulting bounds are clipped to lie between zero and the sequence\'s\n  length, inclusive.  Finally, the sequence object is asked to replace\n  the slice with the items of the assigned sequence.  The length of\n  the slice may be different from the length of the assigned sequence,\n  thus changing the length of the target sequence, if the target\n  sequence allows it.\n\n**CPython implementation detail:** In the current implementation, the\nsyntax for targets is taken to be the same as for expressions, and\ninvalid syntax is rejected during the code generation phase, causing\nless detailed error messages.\n\nAlthough the definition of assignment implies that overlaps between\nthe left-hand side and the right-hand side are \'simultanenous\' (for\nexample "a, b = b, a" swaps two variables), overlaps *within* the\ncollection of assigned-to variables occur left-to-right, sometimes\nresulting in confusion.  For instance, the following program prints\n"[0, 2]":\n\n   x = [0, 1]\n   i = 0\n   i, x[i] = 1, 2         # i is updated, then x[i] is updated\n   print(x)\n\nSee also: **PEP 3132** - Extended Iterable Unpacking\n\n     The specification for the "*target" feature.\n\n\nAugmented assignment statements\n===============================\n\nAugmented assignment is the combination, in a single statement, of a\nbinary operation and an assignment statement:\n\n   augmented_assignment_stmt ::= augtarget augop (expression_list | yield_expression)\n   augtarget                 ::= identifier | attributeref | subscription | slicing\n   augop                     ::= "+=" | "-=" | "*=" | "/=" | "//=" | "%=" | "**="\n             | ">>=" | "<<=" | "&=" | "^=" | "|="\n\n(See section *Primaries* for the syntax definitions of the last three\nsymbols.)\n\nAn augmented assignment evaluates the target (which, unlike normal\nassignment statements, cannot be an unpacking) and the expression\nlist, performs the binary operation specific to the type of assignment\non the two operands, and assigns the result to the original target.\nThe target is only evaluated once.\n\nAn augmented assignment expression like "x += 1" can be rewritten as\n"x = x + 1" to achieve a similar, but not exactly equal effect. In the\naugmented version, "x" is only evaluated once. Also, when possible,\nthe actual operation is performed *in-place*, meaning that rather than\ncreating a new object and assigning that to the target, the old object\nis modified instead.\n\nUnlike normal assignments, augmented assignments evaluate the left-\nhand side *before* evaluating the right-hand side.  For example, "a[i]\n+= f(x)" first looks-up "a[i]", then it evaluates "f(x)" and performs\nthe addition, and lastly, it writes the result back to "a[i]".\n\nWith the exception of assigning to tuples and multiple targets in a\nsingle statement, the assignment done by augmented assignment\nstatements is handled the same way as normal assignments. Similarly,\nwith the exception of the possible *in-place* behavior, the binary\noperation performed by augmented assignment is the same as the normal\nbinary operations.\n\nFor targets which are attribute references, the same *caveat about\nclass and instance attributes* applies as for regular assignments.\n',
  'atom-identifiers': u'\nIdentifiers (Names)\n*******************\n\nAn identifier occurring as an atom is a name.  See section\n*Identifiers and keywords* for lexical definition and section *Naming\nand binding* for documentation of naming and binding.\n\nWhen the name is bound to an object, evaluation of the atom yields\nthat object. When a name is not bound, an attempt to evaluate it\nraises a "NameError" exception.\n\n**Private name mangling:** When an identifier that textually occurs in\na class definition begins with two or more underscore characters and\ndoes not end in two or more underscores, it is considered a *private\nname* of that class. Private names are transformed to a longer form\nbefore code is generated for them.  The transformation inserts the\nclass name, with leading underscores removed and a single underscore\ninserted, in front of the name.  For example, the identifier "__spam"\noccurring in a class named "Ham" will be transformed to "_Ham__spam".\nThis transformation is independent of the syntactical context in which\nthe identifier is used.  If the transformed name is extremely long\n(longer than 255 characters), implementation defined truncation may\nhappen. If the class name consists only of underscores, no\ntransformation is done.\n',
index ec42e38..873aa47 100644 (file)
@@ -160,36 +160,42 @@ if _ssl.HAS_TLS_UNIQUE:
 else:
     CHANNEL_BINDING_TYPES = []
 
+
 # Disable weak or insecure ciphers by default
 # (OpenSSL's default setting is 'DEFAULT:!aNULL:!eNULL')
 # Enable a better set of ciphers by default
 # This list has been explicitly chosen to:
 #   * Prefer cipher suites that offer perfect forward secrecy (DHE/ECDHE)
 #   * Prefer ECDHE over DHE for better performance
-#   * Prefer any AES-GCM over any AES-CBC for better performance and security
+#   * Prefer AEAD over CBC for better performance and security
+#   * Prefer AES-GCM over ChaCha20 because most platforms have AES-NI
+#     (ChaCha20 needs OpenSSL 1.1.0 or patched 1.0.2)
+#   * Prefer any AES-GCM and ChaCha20 over any AES-CBC for better
+#     performance and security
 #   * Then Use HIGH cipher suites as a fallback
-#   * Then Use 3DES as fallback which is secure but slow
-#   * Disable NULL authentication, NULL encryption, and MD5 MACs for security
-#     reasons
+#   * Disable NULL authentication, NULL encryption, 3DES and MD5 MACs
+#     for security reasons
 _DEFAULT_CIPHERS = (
-    'ECDH+AESGCM:DH+AESGCM:ECDH+AES256:DH+AES256:ECDH+AES128:DH+AES:ECDH+HIGH:'
-    'DH+HIGH:ECDH+3DES:DH+3DES:RSA+AESGCM:RSA+AES:RSA+HIGH:RSA+3DES:!aNULL:'
-    '!eNULL:!MD5'
-)
+    'ECDH+AESGCM:ECDH+CHACHA20:DH+AESGCM:DH+CHACHA20:ECDH+AES256:DH+AES256:'
+    'ECDH+AES128:DH+AES:ECDH+HIGH:DH+HIGH:RSA+AESGCM:RSA+AES:RSA+HIGH:'
+    '!aNULL:!eNULL:!MD5:!3DES'
+    )
 
 # Restricted and more secure ciphers for the server side
 # This list has been explicitly chosen to:
 #   * Prefer cipher suites that offer perfect forward secrecy (DHE/ECDHE)
 #   * Prefer ECDHE over DHE for better performance
-#   * Prefer any AES-GCM over any AES-CBC for better performance and security
+#   * Prefer AEAD over CBC for better performance and security
+#   * Prefer AES-GCM over ChaCha20 because most platforms have AES-NI
+#   * Prefer any AES-GCM and ChaCha20 over any AES-CBC for better
+#     performance and security
 #   * Then Use HIGH cipher suites as a fallback
-#   * Then Use 3DES as fallback which is secure but slow
-#   * Disable NULL authentication, NULL encryption, MD5 MACs, DSS, and RC4 for
-#     security reasons
+#   * Disable NULL authentication, NULL encryption, MD5 MACs, DSS, RC4, and
+#     3DES for security reasons
 _RESTRICTED_SERVER_CIPHERS = (
-    'ECDH+AESGCM:DH+AESGCM:ECDH+AES256:DH+AES256:ECDH+AES128:DH+AES:ECDH+HIGH:'
-    'DH+HIGH:ECDH+3DES:DH+3DES:RSA+AESGCM:RSA+AES:RSA+HIGH:RSA+3DES:!aNULL:'
-    '!eNULL:!MD5:!DSS:!RC4'
+    'ECDH+AESGCM:ECDH+CHACHA20:DH+AESGCM:DH+CHACHA20:ECDH+AES256:DH+AES256:'
+    'ECDH+AES128:DH+AES:ECDH+HIGH:DH+HIGH:RSA+AESGCM:RSA+AES:RSA+HIGH:'
+    '!aNULL:!eNULL:!MD5:!DSS:!RC4:!3DES'
 )
 
 
index 04cfb44..bf660ef 100644 (file)
@@ -1375,8 +1375,12 @@ class Popen(object):
                     # and pass it to fork_exec()
 
                     if env is not None:
-                        env_list = [os.fsencode(k) + b'=' + os.fsencode(v)
-                                    for k, v in env.items()]
+                        env_list = []
+                        for k, v in env.items():
+                            k = os.fsencode(k)
+                            if b'=' in k:
+                                raise ValueError("illegal environment variable name")
+                            env_list.append(k + b'=' + os.fsencode(v))
                     else:
                         env_list = None  # Use execv instead of execve.
                     executable = os.fsencode(executable)
index 80feb90..75509a7 100644 (file)
@@ -952,6 +952,92 @@ class DictTest(unittest.TestCase):
         d = {X(): 0, 1: 1}
         self.assertRaises(RuntimeError, d.update, other)
 
+    def test_equal_operator_modifying_operand(self):
+        # test fix for seg fault reported in issue 27945 part 3.
+        class X():
+            def __del__(self):
+                dict_b.clear()
+
+            def __eq__(self, other):
+                dict_a.clear()
+                return True
+
+            def __hash__(self):
+                return 13
+
+        dict_a = {X(): 0}
+        dict_b = {X(): X()}
+        self.assertTrue(dict_a == dict_b)
+
+    def test_fromkeys_operator_modifying_dict_operand(self):
+        # test fix for seg fault reported in issue 27945 part 4a.
+        class X(int):
+            def __hash__(self):
+                return 13
+
+            def __eq__(self, other):
+                if len(d) > 1:
+                    d.clear()
+                return False
+
+        d = {}  # this is required to exist so that d can be constructed!
+        d = {X(1): 1, X(2): 2}
+        try:
+            dict.fromkeys(d)  # shouldn't crash
+        except RuntimeError:  # implementation defined
+            pass
+
+    def test_fromkeys_operator_modifying_set_operand(self):
+        # test fix for seg fault reported in issue 27945 part 4b.
+        class X(int):
+            def __hash__(self):
+                return 13
+
+            def __eq__(self, other):
+                if len(d) > 1:
+                    d.clear()
+                return False
+
+        d = {}  # this is required to exist so that d can be constructed!
+        d = {X(1), X(2)}
+        try:
+            dict.fromkeys(d)  # shouldn't crash
+        except RuntimeError:  # implementation defined
+            pass
+
+    def test_dictitems_contains_use_after_free(self):
+        class X:
+            def __eq__(self, other):
+                d.clear()
+                return NotImplemented
+
+        d = {0: set()}
+        (0, X()) in d.items()
+
+    def test_init_use_after_free(self):
+        class X:
+            def __hash__(self):
+                pair[:] = []
+                return 13
+
+        pair = [X(), 123]
+        dict([pair])
+
+    def test_oob_indexing_dictiter_iternextitem(self):
+        class X(int):
+            def __del__(self):
+                d.clear()
+
+        d = {i: X(i) for i in range(8)}
+
+        def iter_and_mutate():
+            for result in d.items():
+                if result[0] == 2:
+                    d[2] = None # free d[2] --> X(2).__del__ was called
+
+        self.assertRaises(RuntimeError, iter_and_mutate)
+
+
 from test import mapping_tests
 
 class GeneralMappingTests(mapping_tests.BasicTestMappingProtocol):
index d3be7d6..1d448d5 100644 (file)
@@ -482,6 +482,9 @@ class TestFTPClass(TestCase):
         self.assertEqual(self.client.sanitize('PASS 12345'), repr('PASS *****'))
 
     def test_exceptions(self):
+        self.assertRaises(ValueError, self.client.sendcmd, 'echo 40\r\n0')
+        self.assertRaises(ValueError, self.client.sendcmd, 'echo 40\n0')
+        self.assertRaises(ValueError, self.client.sendcmd, 'echo 40\r0')
         self.assertRaises(ftplib.error_temp, self.client.sendcmd, 'echo 400')
         self.assertRaises(ftplib.error_temp, self.client.sendcmd, 'echo 499')
         self.assertRaises(ftplib.error_perm, self.client.sendcmd, 'echo 500')
@@ -490,7 +493,8 @@ class TestFTPClass(TestCase):
 
     def test_all_errors(self):
         exceptions = (ftplib.error_reply, ftplib.error_temp, ftplib.error_perm,
-                      ftplib.error_proto, ftplib.Error, OSError, EOFError)
+                      ftplib.error_proto, ftplib.Error, OSError,
+                      EOFError)
         for x in exceptions:
             try:
                 raise x('exception not included in all_errors set')
index 6e5f2db..64a5765 100644 (file)
@@ -12,6 +12,7 @@ import os
 import sys
 import re
 import base64
+import ntpath
 import shutil
 import urllib.parse
 import html
@@ -829,6 +830,24 @@ class SimpleHTTPRequestHandlerTestCase(unittest.TestCase):
         path = self.handler.translate_path('//filename?foo=bar')
         self.assertEqual(path, self.translated)
 
+    def test_windows_colon(self):
+        with support.swap_attr(server.os, 'path', ntpath):
+            path = self.handler.translate_path('c:c:c:foo/filename')
+            path = path.replace(ntpath.sep, os.sep)
+            self.assertEqual(path, self.translated)
+
+            path = self.handler.translate_path('\\c:../filename')
+            path = path.replace(ntpath.sep, os.sep)
+            self.assertEqual(path, self.translated)
+
+            path = self.handler.translate_path('c:\\c:..\\foo/filename')
+            path = path.replace(ntpath.sep, os.sep)
+            self.assertEqual(path, self.translated)
+
+            path = self.handler.translate_path('c:c:foo\\c:c:bar/filename')
+            path = path.replace(ntpath.sep, os.sep)
+            self.assertEqual(path, self.translated)
+
 
 class MiscTestCase(unittest.TestCase):
     def test_all(self):
index 838411e..68a7105 100644 (file)
@@ -468,16 +468,6 @@ class RemoteIMAP_SSLTest(RemoteIMAPTest):
             _server = self.imap_class(self.host, self.port)
             self.check_logincapa(_server)
 
-    def test_logincapa_with_client_certfile(self):
-        with transient_internet(self.host):
-            _server = self.imap_class(self.host, self.port, certfile=CERTFILE)
-            self.check_logincapa(_server)
-
-    def test_logincapa_with_client_ssl_context(self):
-        with transient_internet(self.host):
-            _server = self.imap_class(self.host, self.port, ssl_context=self.create_ssl_context())
-            self.check_logincapa(_server)
-
     def test_logout(self):
         with transient_internet(self.host):
             _server = self.imap_class(self.host, self.port)
index e29b0d5..c5f5937 100644 (file)
@@ -770,7 +770,11 @@ class WalkTests(unittest.TestCase):
         if support.can_symlink():
             os.symlink(os.path.abspath(t2_path), self.link_path)
             os.symlink('broken', broken_link_path, True)
-            self.sub2_tree = (sub2_path, ["link"], ["broken_link", "tmp3"])
+            if os.path.isdir(broken_link_path):
+                # On Windows a symlink can has the FILE_ATTRIBUTE_DIRECTORY flag.
+                self.sub2_tree = (sub2_path, ["broken_link", "link"], ["tmp3"])
+            else:
+                self.sub2_tree = (sub2_path, ["link"], ["broken_link", "tmp3"])
         else:
             self.sub2_tree = (sub2_path, [], ["tmp3"])
 
index 4719cc0..6d55f9b 100644 (file)
@@ -606,6 +606,46 @@ class ProcessTestCase(BaseTestCase):
                  # environment
                  b"['__CF_USER_TEXT_ENCODING']"))
 
+    def test_invalid_cmd(self):
+        # null character in the command name
+        cmd = sys.executable + '\0'
+        with self.assertRaises((ValueError, TypeError)):
+            subprocess.Popen([cmd, "-c", "pass"])
+
+        # null character in the command argument
+        with self.assertRaises((ValueError, TypeError)):
+            subprocess.Popen([sys.executable, "-c", "pass#\0"])
+
+    def test_invalid_env(self):
+        # null character in the enviroment variable name
+        newenv = os.environ.copy()
+        newenv["FRUIT\0VEGETABLE"] = "cabbage"
+        with self.assertRaises((ValueError, TypeError)):
+            subprocess.Popen([sys.executable, "-c", "pass"], env=newenv)
+
+        # null character in the enviroment variable value
+        newenv = os.environ.copy()
+        newenv["FRUIT"] = "orange\0VEGETABLE=cabbage"
+        with self.assertRaises((ValueError, TypeError)):
+            subprocess.Popen([sys.executable, "-c", "pass"], env=newenv)
+
+        # equal character in the enviroment variable name
+        newenv = os.environ.copy()
+        newenv["FRUIT=ORANGE"] = "lemon"
+        with self.assertRaises(ValueError):
+            subprocess.Popen([sys.executable, "-c", "pass"], env=newenv)
+
+        # equal character in the enviroment variable value
+        newenv = os.environ.copy()
+        newenv["FRUIT"] = "orange=lemon"
+        with subprocess.Popen([sys.executable, "-c",
+                               'import sys, os;'
+                               'sys.stdout.write(os.getenv("FRUIT"))'],
+                              stdout=subprocess.PIPE,
+                              env=newenv) as p:
+            stdout, stderr = p.communicate()
+            self.assertEqual(stdout, b"orange=lemon")
+
     def test_communicate_stdin(self):
         p = subprocess.Popen([sys.executable, "-c",
                               'import sys;'
index 1775ef3..f087ced 100644 (file)
@@ -681,28 +681,35 @@ class UrlParseTestCase(unittest.TestCase):
     def test_parse_fragments(self):
         # Exercise the allow_fragments parameter of urlparse() and urlsplit()
         tests = (
-            ("http:#frag", "path"),
-            ("//example.net#frag", "path"),
-            ("index.html#frag", "path"),
-            (";a=b#frag", "params"),
-            ("?a=b#frag", "query"),
-            ("#frag", "path"),
+            ("http:#frag", "path", "frag"),
+            ("//example.net#frag", "path", "frag"),
+            ("index.html#frag", "path", "frag"),
+            (";a=b#frag", "params", "frag"),
+            ("?a=b#frag", "query", "frag"),
+            ("#frag", "path", "frag"),
+            ("abc#@frag", "path", "@frag"),
+            ("//abc#@frag", "path", "@frag"),
+            ("//abc:80#@frag", "path", "@frag"),
+            ("//abc#@frag:80", "path", "@frag:80"),
         )
-        for url, attr in tests:
+        for url, attr, expected_frag in tests:
             for func in (urllib.parse.urlparse, urllib.parse.urlsplit):
                 if attr == "params" and func is urllib.parse.urlsplit:
                     attr = "path"
                 with self.subTest(url=url, function=func):
                     result = func(url, allow_fragments=False)
                     self.assertEqual(result.fragment, "")
-                    self.assertTrue(getattr(result, attr).endswith("#frag"))
+                    self.assertTrue(
+                            getattr(result, attr).endswith("#" + expected_frag))
                     self.assertEqual(func(url, "", False).fragment, "")
 
                     result = func(url, allow_fragments=True)
-                    self.assertEqual(result.fragment, "frag")
-                    self.assertFalse(getattr(result, attr).endswith("frag"))
-                    self.assertEqual(func(url, "", True).fragment, "frag")
-                    self.assertEqual(func(url).fragment, "frag")
+                    self.assertEqual(result.fragment, expected_frag)
+                    self.assertFalse(
+                            getattr(result, attr).endswith(expected_frag))
+                    self.assertEqual(func(url, "", True).fragment,
+                                     expected_frag)
+                    self.assertEqual(func(url).fragment, expected_frag)
 
     def test_mixed_types_rejected(self):
         # Several functions that process either strings or ASCII encoded bytes
@@ -883,6 +890,26 @@ class Utility_Tests(unittest.TestCase):
         self.assertEqual(splithost('/foo/bar/baz.html'),
                          (None, '/foo/bar/baz.html'))
 
+        # bpo-30500: # starts a fragment.
+        self.assertEqual(splithost('//127.0.0.1#@host.com'),
+                         ('127.0.0.1', '/#@host.com'))
+        self.assertEqual(splithost('//127.0.0.1#@host.com:80'),
+                         ('127.0.0.1', '/#@host.com:80'))
+        self.assertEqual(splithost('//127.0.0.1:80#@host.com'),
+                         ('127.0.0.1:80', '/#@host.com'))
+
+        # Empty host is returned as empty string.
+        self.assertEqual(splithost("///file"),
+                         ('', '/file'))
+
+        # Trailing semicolon, question mark and hash symbol are kept.
+        self.assertEqual(splithost("//example.net/file;"),
+                         ('example.net', '/file;'))
+        self.assertEqual(splithost("//example.net/file?"),
+                         ('example.net', '/file?'))
+        self.assertEqual(splithost("//example.net/file#"),
+                         ('example.net', '/file#'))
+
     def test_splituser(self):
         splituser = urllib.parse.splituser
         self.assertEqual(splituser('User:Pass@www.python.org:080'),
index 4313c1d..28f012f 100644 (file)
@@ -827,6 +827,14 @@ class ReferencesTestCase(TestBase):
         with self.assertRaises(AttributeError):
             ref1.__callback__ = lambda ref: None
 
+    def test_callback_gcs(self):
+        class ObjectWithDel(Object):
+            def __del__(self): pass
+        x = ObjectWithDel(1)
+        ref1 = weakref.ref(x, lambda ref: support.gc_collect())
+        del x
+        support.gc_collect()
+
 
 class SubclassableWeakrefTestCase(TestBase):
 
index d368331..d7b4e88 100644 (file)
@@ -865,7 +865,7 @@ def splithost(url):
     """splithost('//host[:port]/path') --> 'host[:port]', '/path'."""
     global _hostprog
     if _hostprog is None:
-        _hostprog = re.compile('^//([^/?]*)(.*)$')
+        _hostprog = re.compile('//([^/#?]*)(.*)', re.DOTALL)
 
     match = _hostprog.match(url)
     if match:
index 6824554..2e45f3d 100644 (file)
--- a/Misc/ACKS
+++ b/Misc/ACKS
@@ -506,6 +506,7 @@ Hans de Graaff
 Tim Graham
 Nathaniel Gray
 Eddy De Greef
+Duane Griffin
 Grant Griffin
 Andrea Griffini
 Duncan Grisby
@@ -993,6 +994,7 @@ Max Neunhöffer
 Anthon van der Neut
 George Neville-Neil
 Hieu Nguyen
+Nam Nguyen
 Johannes Nicolai
 Samuel Nicolary
 Jonathan Niehof
index c3dc15e..976509b 100644 (file)
--- a/Misc/NEWS
+++ b/Misc/NEWS
-+++++++++++
++++++++++++
 Python News
 +++++++++++
 
-What's New in Python 3.4.6?
-===========================
+What's New in Python 3.4.7 final?
+=================================
+
+*Release date: 2017-08-09*
+
+Library
+-------
+
+- bpo-30119: ftplib.FTP.putline() now throws ValueError on commands that
+  contains CR or LF. Patch by Dong-hee Na.
+
+
+What's New in Python 3.4.7 release candidate 1?
+===============================================
+
+*Release date: 2017-07-23*
+
+Security
+--------
+
+- bpo-29591: Update expat copy from 2.1.1 to 2.2.0 to get fixes of
+  CVE-2016-0718 and CVE-2016-4472. See
+  https://sourceforge.net/p/expat/bugs/537/ for more information.
+
+- bpo-30694: Upgrade expat copy from 2.2.0 to 2.2.1 to get fixes of multiple
+  security vulnerabilities including: CVE-2017-9233 (External entity
+  infinite loop DoS), CVE-2016-9063 (Integer overflow, re-fix),
+  CVE-2016-0718 (Fix regression bugs from 2.2.0's fix to CVE-2016-0718) and
+  CVE-2012-0876 (Counter hash flooding with SipHash).  Note: the
+  CVE-2016-5300 (Use os- specific entropy sources like getrandom) doesn't
+  impact Python, since Python already gets entropy from the OS to set the
+  expat secret using ``XML_SetHashSalt()``.
+
+- bpo-26657: Fix directory traversal vulnerability with http.server on
+  Windows. This fixes a regression that was introduced in 3.3.4rc1 and
+  3.4.0rc1. Based on patch by Philipp Hagemeister.
+
+- bpo-30500: Fix urllib.parse.splithost() to correctly parse fragments. For
+  example, ``splithost('//127.0.0.1#@evil.com/')`` now correctly returns the
+  ``127.0.0.1`` host, instead of treating ``@evil.com`` as the host in an
+  authentification (``login@host``).
+
+- bpo-30730: Prevent environment variables injection in subprocess on
+  Windows.  Prevent passing other invalid environment variables and command
+  arguments.
+
+Core and Builtins
+-----------------
+
+- bpo-26617: Fix crash when GC runs during weakref callbacks.
+
+- bpo-27945: Fixed various segfaults with dict when input collections are
+  mutated during searching, inserting or comparing.  Based on patches by
+  Duane Griffin and Tim Mitchell.
+
+Library
+-------
+
+- bpo-27850: Remove 3DES from ssl module's default cipher list to counter
+  measure sweet32 attack (CVE-2016-2183).
+
+Documentation
+-------------
+
+- bpo-25008: Document smtpd.py as effectively deprecated and add a pointer
+  to aiosmtpd, a third-party asyncio-based replacement.
 
-Release date: 2017-01-16
+
+What's New in Python 3.4.6 final?
+=================================
+
+*Release date: 2017-01-17*
 
 There were no changes between 3.4.6rc1 and 3.4.6 final.
 
 
-What's New in Python 3.4.6rc1?
-==============================
 
-Release date: 2017-01-02
+What's New in Python 3.4.6 release candidate 1?
+===============================================
+
+*Release date: 2017-01-02*
 
 Core and Builtins
 -----------------
 
-- Issue #28648: Fixed crash in Py_DecodeLocale() in debug build on Mac OS X
+- bpo-28648: Fixed crash in Py_DecodeLocale() in debug build on Mac OS X
   when decode astral characters.  Patch by Xiang Zhang.
 
-- Issue #28426: Fixed potential crash in PyUnicode_AsDecodedObject() in debug
+- bpo-28426: Fixed potential crash in PyUnicode_AsDecodedObject() in debug
   build.
 
 Library
 -------
 
-- Issue #28563: Fixed possible DoS and arbitrary code execution when handle
+- bpo-28563: Fixed possible DoS and arbitrary code execution when handle
   plural form selections in the gettext module.  The expression parser now
   supports exact syntax supported by GNU gettext.
 
-- In the curses module, raise an error if window.getstr() or window.instr() is
-  passed a negative value.
+- In the curses module, raise an error if window.getstr() or window.instr()
+  is passed a negative value.
 
-- Issue #27783: Fix possible usage of uninitialized memory in operator.methodcaller.
+- bpo-27783: Fix possible usage of uninitialized memory in
+  operator.methodcaller.
 
-- Issue #27774: Fix possible Py_DECREF on unowned object in _sre.
+- bpo-27774: Fix possible Py_DECREF on unowned object in _sre.
 
-- Issue #27760: Fix possible integer overflow in binascii.b2a_qp.
+- bpo-27760: Fix possible integer overflow in binascii.b2a_qp.
 
-- Issue #27758: Fix possible integer overflow in the _csv module for large record
-  lengths.
+- bpo-27758: Fix possible integer overflow in the _csv module for large
+  record lengths.
 
-- Issue #27568: Prevent HTTPoxy attack (CVE-2016-1000110). Ignore the
-  HTTP_PROXY variable when REQUEST_METHOD environment is set, which indicates
-  that the script is in CGI mode.
+- bpo-27568: Prevent HTTPoxy attack (CVE-2016-1000110). Ignore the
+  HTTP_PROXY variable when REQUEST_METHOD environment is set, which
+  indicates that the script is in CGI mode.
 
-- Issue #27759: Fix selectors incorrectly retain invalid file descriptors.
+- bpo-27759: Fix selectors incorrectly retain invalid file descriptors.
   Patch by Mark Williams.
 
 Build
 -----
 
-- Issue #28248: Update Windows build to use OpenSSL 1.0.2j.
+- bpo-28248: Update Windows build to use OpenSSL 1.0.2j.
 
 Tests
 -----
 
-- Issue #27369: In test_pyexpat, avoid testing an error message detail that
+- bpo-27369: In test_pyexpat, avoid testing an error message detail that
   changed in Expat 2.2.0.
 
 
-What's New in Python 3.4.5?
-===========================
+What's New in Python 3.4.5 final?
+=================================
 
-Release date: 2016-06-26
+*Release date: 2016-06-26*
 
 Tests
 -----
 
-- Issue #26867: Ubuntu's openssl OP_NO_SSLv3 is forced on by default; fix test.
+- bpo-26867: Ubuntu's openssl OP_NO_SSLv3 is forced on by default; fix test.
 
 
-What's New in Python 3.4.5rc1?
-==============================
+What's New in Python 3.4.5 release candidate 1?
+===============================================
 
-Release date: 2016-06-11
+*Release date: 2016-06-11*
 
 Core and Builtins
 -----------------
 
-- Issue #26478: Fix semantic bugs when using binary operators with dictionary
+- bpo-26478: Fix semantic bugs when using binary operators with dictionary
   views and tuples.
 
-- Issue #26171: Fix possible integer overflow and heap corruption in
+- bpo-26171: Fix possible integer overflow and heap corruption in
   zipimporter.get_data().
 
 Library
 -------
 
-- Issue #26556: Update expat to 2.1.1, fixes CVE-2015-1283.
+- bpo-26556: Update expat to 2.1.1, fixes CVE-2015-1283.
 
-- Fix TLS stripping vulnerability in smptlib, CVE-2016-0772.  Reported by Team
-  Oststrom
+- Fix TLS stripping vulnerability in smptlib, CVE-2016-0772.  Reported by
+  Team Oststrom
 
-- Issue #25939: On Windows open the cert store readonly in ssl.enum_certificates.
+- bpo-25939: On Windows open the cert store readonly in
+  ssl.enum_certificates.
 
-- Issue #26012: Don't traverse into symlinks for ** pattern in
+- bpo-26012: Don't traverse into symlinks for ** pattern in
   pathlib.Path.[r]glob().
 
-- Issue #24120: Ignore PermissionError when traversing a tree with
-  pathlib.Path.[r]glob().  Patch by Ulrich Petri.
+- bpo-24120: Ignore PermissionError when traversing a tree with
+  pathlib.Path.[r]glob(). Patch by Ulrich Petri.
 
-- Skip getaddrinfo if host is already resolved.
-  Patch by A. Jesse Jiryu Davis.
+- Skip getaddrinfo if host is already resolved. Patch by A. Jesse Jiryu
+  Davis.
 
 - Add asyncio.timeout() context manager.
 
-- Issue #26050: Add asyncio.StreamReader.readuntil() method.
-  Patch by Марк Коренберг.
+- bpo-26050: Add asyncio.StreamReader.readuntil() method. Patch by Марк
+  Коренберг.
 
 Tests
 -----
 
-- Issue #25940: Changed test_ssl to use self-signed.pythontest.net.  This
+- bpo-25940: Changed test_ssl to use self-signed.pythontest.net.  This
   avoids relying on svn.python.org, which recently changed root certificate.
 
 
-What's New in Python 3.4.4?
-===========================
+What's New in Python 3.4.4 final?
+=================================
 
-Release date: 2015/12/20
+*Release date: 2015/12/20*
 
 Windows
 -------
 
-- Issue #25844: Corrected =/== typo potentially leading to crash in launcher.
+- bpo-25844: Corrected =/== typo potentially leading to crash in launcher.
 
 
-What's New in Python 3.4.4rc1?
-==============================
+What's New in Python 3.4.4 release candidate 1?
+===============================================
 
-Release date: 2015/12/06
+*Release date: 2015/12/06*
 
 Core and Builtins
 -----------------
 
-- Issue #25709: Fixed problem with in-place string concatenation and utf-8
+- bpo-25709: Fixed problem with in-place string concatenation and utf-8
   cache.
 
-- Issue #24097: Fixed crash in object.__reduce__() if slot name is freed inside
+- bpo-24097: Fixed crash in object.__reduce__() if slot name is freed inside
   __getattr__.
 
-- Issue #24731: Fixed crash on converting objects with special methods
+- bpo-24731: Fixed crash on converting objects with special methods
   __bytes__, __trunc__, and __float__ returning instances of subclasses of
-  bytes, int, and float to subclasses of bytes, int, and float correspondingly.
+  bytes, int, and float to subclasses of bytes, int, and float
+  correspondingly.
 
-- Issue #25388: Fixed tokenizer crash when processing undecodable source code
+- bpo-25388: Fixed tokenizer crash when processing undecodable source code
   with a null byte.
 
-- Issue #22995: Default implementation of __reduce__ and __reduce_ex__ now
+- bpo-22995: Default implementation of __reduce__ and __reduce_ex__ now
   rejects builtin types with not defined __new__.
 
-- Issue #24802: Avoid buffer overreads when int(), float(), compile(), exec()
+- bpo-24802: Avoid buffer overreads when int(), float(), compile(), exec()
   and eval() are passed bytes-like objects.  These objects are not
-  necessarily terminated by a null byte, but the functions assumed they were.
+  necessarily terminated by a null byte, but the functions assumed they
+  were.
 
-- Issue #24402: Fix input() to prompt to the redirected stdout when
+- bpo-24402: Fix input() to prompt to the redirected stdout when
   sys.stdout.fileno() fails.
 
-- Issue #24806: Prevent builtin types that are not allowed to be subclassed from
-  being subclassed through multiple inheritance.
+- bpo-24806: Prevent builtin types that are not allowed to be subclassed
+  from being subclassed through multiple inheritance.
 
-- Issue #24848: Fixed a number of bugs in UTF-7 decoding of misformed data.
+- bpo-24848: Fixed a number of bugs in UTF-7 decoding of misformed data.
 
-- Issue #25280: Import trace messages emitted in verbose (-v) mode are no
+- bpo-25280: Import trace messages emitted in verbose (-v) mode are no
   longer formatted twice.
 
-- Issue #25003: os.urandom() doesn't use getentropy() on Solaris because
-  getentropy() is blocking, whereas os.urandom() should not block. getentropy()
-  is supported since Solaris 11.3.
+- bpo-25003: os.urandom() doesn't use getentropy() on Solaris because
+  getentropy() is blocking, whereas os.urandom() should not block.
+  getentropy() is supported since Solaris 11.3.
 
-- Issue #25182: The stdprinter (used as sys.stderr before the io module is
+- bpo-25182: The stdprinter (used as sys.stderr before the io module is
   imported at startup) now uses the backslashreplace error handler.
 
-- Issue #24891: Fix a race condition at Python startup if the file descriptor
+- bpo-24891: Fix a race condition at Python startup if the file descriptor
   of stdin (0), stdout (1) or stderr (2) is closed while Python is creating
   sys.stdin, sys.stdout and sys.stderr objects. These attributes are now set
-  to None if the creation of the object failed, instead of raising an OSError
-  exception. Initial patch written by Marco Paolini.
+  to None if the creation of the object failed, instead of raising an
+  OSError exception. Initial patch written by Marco Paolini.
 
-- Issue #21167: NAN operations are now handled correctly when python is
+- bpo-21167: NAN operations are now handled correctly when python is
   compiled with ICC even if -fp-model strict is not specified.
 
-- Issue #4395: Better testing and documentation of binary operators.
-  Patch by Martin Panter.
+- bpo-4395: Better testing and documentation of binary operators. Patch by
+  Martin Panter.
 
-- Issue #24467: Fixed possible buffer over-read in bytearray. The bytearray
-  object now always allocates place for trailing null byte and it's buffer now
-  is always null-terminated.
+- bpo-24467: Fixed possible buffer over-read in bytearray. The bytearray
+  object now always allocates place for trailing null byte and it's buffer
+  now is always null-terminated.
 
-- Issue #24115: Update uses of PyObject_IsTrue(), PyObject_Not(),
+- bpo-24115: Update uses of PyObject_IsTrue(), PyObject_Not(),
   PyObject_IsInstance(), PyObject_RichCompareBool() and _PyDict_Contains()
   to check for and handle errors correctly.
 
-- Issue #24257: Fixed system error in the comparison of faked
+- bpo-24257: Fixed system error in the comparison of faked
   types.SimpleNamespace.
 
-- Issue #22939: Fixed integer overflow in iterator object.  Patch by
-  Clement Rouault.
+- bpo-22939: Fixed integer overflow in iterator object.  Patch by Clement
+  Rouault.
 
-- Issue #23985: Fix a possible buffer overrun when deleting a slice from
-  the front of a bytearray and then appending some other bytes data.
+- bpo-23985: Fix a possible buffer overrun when deleting a slice from the
+  front of a bytearray and then appending some other bytes data.
 
-- Issue #24102: Fixed exception type checking in standard error handlers.
+- bpo-24102: Fixed exception type checking in standard error handlers.
 
-- Issue #23757: PySequence_Tuple() incorrectly called the concrete list API
+- bpo-23757: PySequence_Tuple() incorrectly called the concrete list API
   when the data was a list subclass.
 
-- Issue #24407: Fix crash when dict is mutated while being updated.
+- bpo-24407: Fix crash when dict is mutated while being updated.
 
-- Issue #24096: Make warnings.warn_explicit more robust against mutation of the
+- bpo-24096: Make warnings.warn_explicit more robust against mutation of the
   warnings.filters list.
 
-- Issue #23996: Avoid a crash when a delegated generator raises an
-  unnormalized StopIteration exception.  Patch by Stefan Behnel.
+- bpo-23996: Avoid a crash when a delegated generator raises an unnormalized
+  StopIteration exception.  Patch by Stefan Behnel.
 
-- Issue #24022: Fix tokenizer crash when processing undecodable source code.
+- bpo-24022: Fix tokenizer crash when processing undecodable source code.
 
-- Issue #23309: Avoid a deadlock at shutdown if a daemon thread is aborted
+- bpo-23309: Avoid a deadlock at shutdown if a daemon thread is aborted
   while it is holding a lock to a buffered I/O object, and the main thread
   tries to use the same I/O object (typically stdout or stderr).  A fatal
   error is emitted instead.
 
-- Issue #22977: Fixed formatting Windows error messages on Wine.
-  Patch by Martin Panter.
+- bpo-22977: Fixed formatting Windows error messages on Wine. Patch by
+  Martin Panter.
 
-- Issue #23803: Fixed str.partition() and str.rpartition() when a separator
-  is wider then partitioned string.
+- bpo-23803: Fixed str.partition() and str.rpartition() when a separator is
+  wider then partitioned string.
 
-- Issue #23192: Fixed generator lambdas.  Patch by Bruno Cauet.
+- bpo-23192: Fixed generator lambdas.  Patch by Bruno Cauet.
 
-- Issue #23629: Fix the default __sizeof__ implementation for variable-sized
+- bpo-23629: Fix the default __sizeof__ implementation for variable-sized
   objects.
 
-- Issue #24044: Fix possible null pointer dereference in list.sort in out of
+- bpo-24044: Fix possible null pointer dereference in list.sort in out of
   memory conditions.
 
-- Issue #21354: PyCFunction_New function is exposed by python DLL again.
+- bpo-21354: PyCFunction_New function is exposed by python DLL again.
 
 Library
 -------
 
-- Issue #24903: Fix regression in number of arguments compileall accepts when
+- bpo-24903: Fix regression in number of arguments compileall accepts when
   '-d' is specified.  The check on the number of arguments has been dropped
   completely as it never worked correctly anyway.
 
-- Issue #25764: In the subprocess module, preserve any exception caused by
+- bpo-25764: In the subprocess module, preserve any exception caused by
   fork() failure when preexec_fn is used.
 
-- Issue #6478: _strptime's regexp cache now is reset after changing timezone
+- bpo-6478: _strptime's regexp cache now is reset after changing timezone
   with time.tzset().
 
-- Issue #25177: Fixed problem with the mean of very small and very large
+- bpo-25177: Fixed problem with the mean of very small and very large
   numbers. As a side effect, statistics.mean and statistics.variance should
   be significantly faster.
 
-- Issue #25718: Fixed copying object with state with boolean value is false.
+- bpo-25718: Fixed copying object with state with boolean value is false.
 
-- Issue #10131: Fixed deep copying of minidom documents.  Based on patch
-  by Marian Ganisin.
+- bpo-10131: Fixed deep copying of minidom documents.  Based on patch by
+  Marian Ganisin.
 
-- Issue #25725: Fixed a reference leak in pickle.loads() when unpickling
+- bpo-25725: Fixed a reference leak in pickle.loads() when unpickling
   invalid data including tuple instructions.
 
-- Issue #25663: In the Readline completer, avoid listing duplicate global
+- bpo-25663: In the Readline completer, avoid listing duplicate global
   names, and search the global namespace before searching builtins.
 
-- Issue #25688: Fixed file leak in ElementTree.iterparse() raising an error.
+- bpo-25688: Fixed file leak in ElementTree.iterparse() raising an error.
 
-- Issue #23914: Fixed SystemError raised by unpickler on broken pickle data.
+- bpo-23914: Fixed SystemError raised by unpickler on broken pickle data.
 
-- Issue #25691: Fixed crash on deleting ElementTree.Element attributes.
+- bpo-25691: Fixed crash on deleting ElementTree.Element attributes.
 
-- Issue #25624: ZipFile now always writes a ZIP_STORED header for directory
+- bpo-25624: ZipFile now always writes a ZIP_STORED header for directory
   entries.  Patch by Dingyuan Wang.
 
-- Issue #25583: Avoid incorrect errors raised by os.makedirs(exist_ok=True)
+- bpo-25583: Avoid incorrect errors raised by os.makedirs(exist_ok=True)
   when the OS gives priority to errors such as EACCES over EEXIST.
 
-- Issue #25593: Change semantics of EventLoop.stop() in asyncio.
+- bpo-25593: Change semantics of EventLoop.stop() in asyncio.
 
-- Issue #6973: When we know a subprocess.Popen process has died, do
-  not allow the send_signal(), terminate(), or kill() methods to do
-  anything as they could potentially signal a different process.
+- bpo-6973: When we know a subprocess.Popen process has died, do not allow
+  the send_signal(), terminate(), or kill() methods to do anything as they
+  could potentially signal a different process.
 
-- Issue #25578: Fix (another) memory leak in SSLSocket.getpeercer().
+- bpo-25578: Fix (another) memory leak in SSLSocket.getpeercer().
 
-- Issue #25590: In the Readline completer, only call getattr() once per
+- bpo-25590: In the Readline completer, only call getattr() once per
   attribute.
 
-- Issue #25498: Fix a crash when garbage-collecting ctypes objects created
-  by wrapping a memoryview.  This was a regression made in 3.4.3.  Based
-  on patch by Eryksun.
+- bpo-25498: Fix a crash when garbage-collecting ctypes objects created by
+  wrapping a memoryview.  This was a regression made in 3.4.3.  Based on
+  patch by Eryksun.
 
-- Issue #18010: Fix the pydoc web server's module search function to handle
+- bpo-18010: Fix the pydoc web server's module search function to handle
   exceptions from importing packages.
 
-- Issue #25510: fileinput.FileInput.readline() now returns b'' instead of ''
-  at the end if the FileInput was opened with binary mode.
-  Patch by Ryosuke Ito.
+- bpo-25510: fileinput.FileInput.readline() now returns b'' instead of '' at
+  the end if the FileInput was opened with binary mode. Patch by Ryosuke
+  Ito.
 
-- Issue #25530: Disable the vulnerable SSLv3 protocol by default when creating
+- bpo-25530: Disable the vulnerable SSLv3 protocol by default when creating
   ssl.SSLContext.
 
-- Issue #25569: Fix memory leak in SSLSocket.getpeercert().
+- bpo-25569: Fix memory leak in SSLSocket.getpeercert().
 
-- Issue #21827: Fixed textwrap.dedent() for the case when largest common
-  whitespace is a substring of smallest leading whitespace.
-  Based on patch by Robert Li.
+- bpo-21827: Fixed textwrap.dedent() for the case when largest common
+  whitespace is a substring of smallest leading whitespace. Based on patch
+  by Robert Li.
 
-- Issue #25471: Sockets returned from accept() shouldn't appear to be
+- bpo-25471: Sockets returned from accept() shouldn't appear to be
   nonblocking.
 
-- Issue #25441: asyncio: Raise error from drain() when socket is closed.
+- bpo-25441: asyncio: Raise error from drain() when socket is closed.
 
-- Issue #25411: Improved Unicode support in SMTPHandler through better use of
+- bpo-25411: Improved Unicode support in SMTPHandler through better use of
   the email package. Thanks to user simon04 for the patch.
 
-- Issue #25380: Fixed protocol for the STACK_GLOBAL opcode in
+- bpo-25380: Fixed protocol for the STACK_GLOBAL opcode in
   pickletools.opcodes.
 
-- Issue #23972: Updates asyncio datagram create method allowing reuseport
-  and reuseaddr socket options to be set prior to binding the socket.
-  Mirroring the existing asyncio create_server method the reuseaddr option
-  for datagram sockets defaults to True if the O/S is 'posix' (except if the
+- bpo-23972: Updates asyncio datagram create method allowing reuseport and
+  reuseaddr socket options to be set prior to binding the socket. Mirroring
+  the existing asyncio create_server method the reuseaddr option for
+  datagram sockets defaults to True if the O/S is 'posix' (except if the
   platform is Cygwin). Patch by Chris Laws.
 
-- Issue #25304: Add asyncio.run_coroutine_threadsafe().  This lets you
-  submit a coroutine to a loop from another thread, returning a
+- bpo-25304: Add asyncio.run_coroutine_threadsafe().  This lets you submit a
+  coroutine to a loop from another thread, returning a
   concurrent.futures.Future.  By Vincent Michel.
 
-- Issue #25319: When threading.Event is reinitialized, the underlying condition
+- bpo-25319: When threading.Event is reinitialized, the underlying condition
   should use a regular lock rather than a recursive lock.
 
-- Issue #25232: Fix CGIRequestHandler to split the query from the URL at the
+- bpo-25232: Fix CGIRequestHandler to split the query from the URL at the
   first question mark (?) rather than the last. Patch from Xiang Zhang.
 
-- Issue #24657: Prevent CGIRequestHandler from collapsing slashes in the
-  query part of the URL as if it were a path. Patch from Xiang Zhang.
+- bpo-24657: Prevent CGIRequestHandler from collapsing slashes in the query
+  part of the URL as if it were a path. Patch from Xiang Zhang.
 
-- Issue #22958: Constructor and update method of weakref.WeakValueDictionary
+- bpo-22958: Constructor and update method of weakref.WeakValueDictionary
   now accept the self and the dict keyword arguments.
 
-- Issue #22609: Constructor of collections.UserDict now accepts the self keyword
-  argument.
+- bpo-22609: Constructor of collections.UserDict now accepts the self
+  keyword argument.
 
-- Issue #25262. Added support for BINBYTES8 opcode in Python implementation of
-  unpickler.  Highest 32 bits of 64-bit size for BINUNICODE8 and BINBYTES8
-  opcodes no longer silently ignored on 32-bit platforms in C implementation.
+- bpo-25262: Added support for BINBYTES8 opcode in Python implementation of
+  unpickler. Highest 32 bits of 64-bit size for BINUNICODE8 and BINBYTES8
+  opcodes no longer silently ignored on 32-bit platforms in C
+  implementation.
 
-- Issue #25034: Fix string.Formatter problem with auto-numbering and
-  nested format_specs. Patch by Anthon van der Neut.
+- bpo-25034: Fix string.Formatter problem with auto-numbering and nested
+  format_specs. Patch by Anthon van der Neut.
 
-- Issue #25233: Rewrite the guts of asyncio.Queue and
-  asyncio.Semaphore to be more understandable and correct.
+- bpo-25233: Rewrite the guts of asyncio.Queue and asyncio.Semaphore to be
+  more understandable and correct.
 
-- Issue #23600: Default implementation of tzinfo.fromutc() was returning
-  wrong results in some cases.
+- bpo-23600: Default implementation of tzinfo.fromutc() was returning wrong
+  results in some cases.
 
-- Issue #25203: Failed readline.set_completer_delims() no longer left the
+- bpo-25203: Failed readline.set_completer_delims() no longer left the
   module in inconsistent state.
 
 - Prevent overflow in _Unpickler_Read.
 
-- Issue #25047: The XML encoding declaration written by Element Tree now
+- bpo-25047: The XML encoding declaration written by Element Tree now
   respects the letter case given by the user. This restores the ability to
   write encoding names in uppercase like "UTF-8", which worked in Python 2.
 
-- Issue #19143: platform module now reads Windows version from kernel32.dll to
+- bpo-19143: platform module now reads Windows version from kernel32.dll to
   avoid compatibility shims.
 
-- Issue #23517: Fix rounding in fromtimestamp() and utcfromtimestamp() methods
+- bpo-23517: Fix rounding in fromtimestamp() and utcfromtimestamp() methods
   of datetime.datetime: microseconds are now rounded to nearest with ties
   going to nearest even integer (ROUND_HALF_EVEN), instead of being rounding
   towards zero (ROUND_DOWN). It's important that these methods use the same
   rounding mode than datetime.timedelta to keep the property:
-  (datetime(1970,1,1) + timedelta(seconds=t)) == datetime.utcfromtimestamp(t).
-  It also the rounding mode used by round(float) for example.
+  (datetime(1970,1,1) + timedelta(seconds=t)) ==
+  datetime.utcfromtimestamp(t). It also the rounding mode used by
+  round(float) for example.
 
-- Issue #24684: socket.socket.getaddrinfo() now calls
+- bpo-24684: socket.socket.getaddrinfo() now calls
   PyUnicode_AsEncodedString() instead of calling the encode() method of the
-  host, to handle correctly custom string with an encode() method which doesn't
-  return a byte string. The encoder of the IDNA codec is now called directly
-  instead of calling the encode() method of the string.
+  host, to handle correctly custom string with an encode() method which
+  doesn't return a byte string. The encoder of the IDNA codec is now called
+  directly instead of calling the encode() method of the string.
 
-- Issue #24982: shutil.make_archive() with the "zip" format now adds entries
+- bpo-24982: shutil.make_archive() with the "zip" format now adds entries
   for directories (including empty directories) in ZIP file.
 
-- Issue #24857: Comparing call_args to a long sequence now correctly returns a
+- bpo-24857: Comparing call_args to a long sequence now correctly returns a
   boolean result instead of raising an exception.  Patch by A Kaptur.
 
-- Issue #25019: Fixed a crash caused by setting non-string key of expat parser.
+- bpo-25019: Fixed a crash caused by setting non-string key of expat parser.
   Based on patch by John Leitch.
 
-- Issue #24917: time_strftime() buffer over-read.
+- bpo-24917: time_strftime() buffer over-read.
 
-- Issue #23144: Make sure that HTMLParser.feed() returns all the data, even
+- bpo-23144: Make sure that HTMLParser.feed() returns all the data, even
   when convert_charrefs is True.
 
-- Issue #16180: Exit pdb if file has syntax error, instead of trapping user
-  in an infinite loop.  Patch by Xavier de Gaye.
+- bpo-16180: Exit pdb if file has syntax error, instead of trapping user in
+  an infinite loop.  Patch by Xavier de Gaye.
 
-- Issue #21112: Fix regression in unittest.expectedFailure on subclasses.
-  Patch from Berker Peksag.
+- bpo-21112: Fix regression in unittest.expectedFailure on subclasses. Patch
+  from Berker Peksag.
 
-- Issue #24931: Instances of subclasses of namedtuples have their own __dict__
-  which breaks the inherited __dict__ property and breaks the _asdict() method.
-  Removed the __dict__ property to prevent the conflict and fixed _asdict().
+- bpo-24931: Instances of subclasses of namedtuples have their own __dict__
+  which breaks the inherited __dict__ property and breaks the _asdict()
+  method. Removed the __dict__ property to prevent the conflict and fixed
+  _asdict().
 
-- Issue #24764: cgi.FieldStorage.read_multi() now ignores the Content-Length
-  header in part headers. Patch written by Peter Landry and reviewed by Pierre
-  Quentel.
+- bpo-24764: cgi.FieldStorage.read_multi() now ignores the Content-Length
+  header in part headers. Patch written by Peter Landry and reviewed by
+  Pierre Quentel.
 
-- Issue #24774: Fix docstring in http.server.test. Patch from Chiu-Hsiang Hsu.
+- bpo-24774: Fix docstring in http.server.test. Patch from Chiu-Hsiang Hsu.
 
-- Issue #21159: Improve message in configparser.InterpolationMissingOptionError.
-  Patch from Łukasz Langa.
+- bpo-21159: Improve message in
+  configparser.InterpolationMissingOptionError. Patch from Łukasz Langa.
 
-- Issue #23888: Handle fractional time in cookie expiry. Patch by ssh.
+- bpo-23888: Handle fractional time in cookie expiry. Patch by ssh.
 
-- Issue #23004: mock_open() now reads binary data correctly when the type of
+- bpo-23004: mock_open() now reads binary data correctly when the type of
   read_data is bytes.  Initial patch by Aaron Hill.
 
-- Issue #23652: Make it possible to compile the select module against the
-  libc headers from the Linux Standard Base, which do not include some
-  EPOLL macros.  Patch by Matt Frank.
+- bpo-23652: Make it possible to compile the select module against the libc
+  headers from the Linux Standard Base, which do not include some EPOLL
+  macros.  Patch by Matt Frank.
 
-- Issue #22932: Fix timezones in email.utils.formatdate.
-  Patch from Dmitry Shachnev.
+- bpo-22932: Fix timezones in email.utils.formatdate. Patch from Dmitry
+  Shachnev.
 
-- Issue #23779: imaplib raises TypeError if authenticator tries to abort.
-  Patch from Craig Holmquist.
+- bpo-23779: imaplib raises TypeError if authenticator tries to abort. Patch
+  from Craig Holmquist.
 
-- Issue #23319: Fix ctypes.BigEndianStructure, swap correctly bytes. Patch
+- bpo-23319: Fix ctypes.BigEndianStructure, swap correctly bytes. Patch
   written by Matthieu Gautier.
 
-- Issue #23254: Document how to close the TCPServer listening socket.
-  Patch from Martin Panter.
+- bpo-23254: Document how to close the TCPServer listening socket. Patch
+  from Martin Panter.
 
-- Issue #19450: Update Windows and OS X installer builds to use SQLite 3.8.11.
+- bpo-19450: Update Windows and OS X installer builds to use SQLite 3.8.11.
 
-- Issue #23441: rcompleter now prints a tab character instead of displaying
+- bpo-23441: rcompleter now prints a tab character instead of displaying
   possible completions for an empty word.  Initial patch by Martin Sekera.
 
-- Issue #24735: Fix invalid memory access in
+- bpo-24735: Fix invalid memory access in
   itertools.combinations_with_replacement().
 
-- Issue #17527: Add PATCH to wsgiref.validator. Patch from Luca Sbardella.
+- bpo-17527: Add PATCH to wsgiref.validator. Patch from Luca Sbardella.
 
-- Issue #24683: Fixed crashes in _json functions called with arguments of
+- bpo-24683: Fixed crashes in _json functions called with arguments of
   inappropriate type.
 
-- Issue #21697: shutil.copytree() now correctly handles symbolic links that
+- bpo-21697: shutil.copytree() now correctly handles symbolic links that
   point to directories.  Patch by Eduardo Seabra and Thomas Kluyver.
 
-- Issue #24620: Random.setstate() now validates the value of state last element.
+- bpo-24620: Random.setstate() now validates the value of state last
+  element.
 
-- Issue #22153: Improve unittest docs. Patch from Martin Panter and evilzero.
+- bpo-22153: Improve unittest docs. Patch from Martin Panter and evilzero.
 
-- Issue #24206: Fixed __eq__ and __ne__ methods of inspect classes.
+- bpo-24206: Fixed __eq__ and __ne__ methods of inspect classes.
 
-- Issue #21750: mock_open.read_data can now be read from each instance, as it
+- bpo-21750: mock_open.read_data can now be read from each instance, as it
   could in Python 3.3.
 
-- Issue #23247: Fix a crash in the StreamWriter.reset() of CJK codecs.
+- bpo-23247: Fix a crash in the StreamWriter.reset() of CJK codecs.
 
-- Issue #18622: unittest.mock.mock_open().reset_mock would recurse infinitely.
+- bpo-18622: unittest.mock.mock_open().reset_mock would recurse infinitely.
   Patch from Nicola Palumbo and Laurent De Buyst.
 
-- Issue #24608: chunk.Chunk.read() now always returns bytes, not str.
+- bpo-24608: chunk.Chunk.read() now always returns bytes, not str.
 
-- Issue #18684: Fixed reading out of the buffer in the re module.
+- bpo-18684: Fixed reading out of the buffer in the re module.
 
-- Issue #24259: tarfile now raises a ReadError if an archive is truncated
+- bpo-24259: tarfile now raises a ReadError if an archive is truncated
   inside a data segment.
 
-- Issue #24552: Fix use after free in an error case of the _pickle module.
+- bpo-24552: Fix use after free in an error case of the _pickle module.
 
-- Issue #24514: tarfile now tolerates number fields consisting of only
+- bpo-24514: tarfile now tolerates number fields consisting of only
   whitespace.
 
-- Issue #19176: Fixed doctype() related bugs in C implementation of ElementTree.
-  A deprecation warning no longer issued by XMLParser subclass with default
-  doctype() method.  Direct call of doctype() now issues a warning.  Parser's
-  doctype() now is not called if target's doctype() is called.  Based on patch
-  by Martin Panter.
+- bpo-19176: Fixed doctype() related bugs in C implementation of
+  ElementTree. A deprecation warning no longer issued by XMLParser subclass
+  with default doctype() method.  Direct call of doctype() now issues a
+  warning.  Parser's doctype() now is not called if target's doctype() is
+  called.  Based on patch by Martin Panter.
 
-- Issue #20387: Restore semantic round-trip correctness in tokenize/untokenize
-  for tab-indented blocks.
+- bpo-20387: Restore semantic round-trip correctness in tokenize/untokenize
+  for tab- indented blocks.
 
-- Issue #24456: Fixed possible buffer over-read in adpcm2lin() and lin2adpcm()
+- bpo-24456: Fixed possible buffer over-read in adpcm2lin() and lin2adpcm()
   functions of the audioop module.
 
-- Issue #24336: The contextmanager decorator now works with functions with
+- bpo-24336: The contextmanager decorator now works with functions with
   keyword arguments called "func" and "self".  Patch by Martin Panter.
 
-- Issue #24489: ensure a previously set C errno doesn't disturb cmath.polar().
+- bpo-24489: ensure a previously set C errno doesn't disturb cmath.polar().
 
-- Issue #5633: Fixed timeit when the statement is a string and the setup is not.
+- bpo-5633: Fixed timeit when the statement is a string and the setup is
+  not.
 
-- Issue #24326: Fixed audioop.ratecv() with non-default weightB argument.
+- bpo-24326: Fixed audioop.ratecv() with non-default weightB argument.
   Original patch by David Moore.
 
-- Issue #23840: tokenize.open() now closes the temporary binary file on error
+- bpo-23840: tokenize.open() now closes the temporary binary file on error
   to fix a resource warning.
 
-- Issue #24257: Fixed segmentation fault in sqlite3.Row constructor with faked
+- bpo-24257: Fixed segmentation fault in sqlite3.Row constructor with faked
   cursor type.
 
-- Issue #22107: tempfile.gettempdir() and tempfile.mkdtemp() now try again
-  when a directory with the chosen name already exists on Windows as well as
-  on Unix.  tempfile.mkstemp() now fails early if parent directory is not
-  valid (not exists or is a file) on Windows.
+- bpo-22107: tempfile.gettempdir() and tempfile.mkdtemp() now try again when
+  a directory with the chosen name already exists on Windows as well as on
+  Unix. tempfile.mkstemp() now fails early if parent directory is not valid
+  (not exists or is a file) on Windows.
 
-- Issue #6598: Increased time precision and random number range in
+- bpo-6598: Increased time precision and random number range in
   email.utils.make_msgid() to strengthen the uniqueness of the message ID.
 
-- Issue #24091: Fixed various crashes in corner cases in C implementation of
+- bpo-24091: Fixed various crashes in corner cases in C implementation of
   ElementTree.
 
-- Issue #21931: msilib.FCICreate() now raises TypeError in the case of a bad
-  argument instead of a ValueError with a bogus FCI error number.
-  Patch by Jeffrey Armstrong.
+- bpo-21931: msilib.FCICreate() now raises TypeError in the case of a bad
+  argument instead of a ValueError with a bogus FCI error number. Patch by
+  Jeffrey Armstrong.
 
-- Issue #23796: peek and read1 methods of BufferedReader now raise ValueError
+- bpo-23796: peek and read1 methods of BufferedReader now raise ValueError
   if they called on a closed object. Patch by John Hergenroeder.
 
-- Issue #24521: Fix possible integer overflows in the pickle module.
+- bpo-24521: Fix possible integer overflows in the pickle module.
 
-- Issue #22931: Allow '[' and ']' in cookie values.
+- bpo-22931: Allow '[' and ']' in cookie values.
 
-- Issue #20274: Remove ignored and erroneous "kwargs" parameters from three
+- bpo-20274: Remove ignored and erroneous "kwargs" parameters from three
   METH_VARARGS methods on _sqlite.Connection.
 
-- Issue #24094: Fix possible crash in json.encode with poorly behaved dict
+- bpo-24094: Fix possible crash in json.encode with poorly behaved dict
   subclasses.
 
-- Asyncio issue 222 / PR 231 (Victor Stinner) -- fix @coroutine
-  functions without __name__.
+- Asyncio issue 222 / PR 231 (Victor Stinner) -- fix @coroutine functions
+  without __name__.
 
-- Issue #9246: On POSIX, os.getcwd() now supports paths longer than 1025 bytes.
+- bpo-9246: On POSIX, os.getcwd() now supports paths longer than 1025 bytes.
   Patch written by William Orr.
 
 - The keywords attribute of functools.partial is now always a dictionary.
 
-- Issues #24099, #24100, and #24101: Fix free-after-use bug in heapq's siftup
-  and siftdown functions.
+- bpo-24099: Fix free-after-use bug in heapq's siftup and siftdown
+  functions. (See also: bpo-24100, bpo-24101)
 
-- Backport collections.deque fixes from Python 3.5.  Prevents reentrant badness
-  during deletion by deferring the decref until the container has been restored
-  to a consistent state.
+- Backport collections.deque fixes from Python 3.5.  Prevents reentrant
+  badness during deletion by deferring the decref until the container has
+  been restored to a consistent state.
 
-- Issue #23008: Fixed resolving attributes with boolean value is False in pydoc.
+- bpo-23008: Fixed resolving attributes with boolean value is False in
+  pydoc.
 
-- Fix asyncio issue 235: LifoQueue and PriorityQueue's put didn't
-  increment unfinished tasks (this bug was introduced in 3.4.3 when
-  JoinableQueue was merged with Queue).
+- Fix asyncio issue 235: LifoQueue and PriorityQueue's put didn't increment
+  unfinished tasks (this bug was introduced in 3.4.3 when JoinableQueue was
+  merged with Queue).
 
-- Issue #23908: os functions now reject paths with embedded null character
-  on Windows instead of silently truncate them.
+- bpo-23908: os functions now reject paths with embedded null character on
+  Windows instead of silently truncate them.
 
-- Issue #23728: binascii.crc_hqx() could return an integer outside of the range
+- bpo-23728: binascii.crc_hqx() could return an integer outside of the range
   0-0xffff for empty data.
 
-- Issue #23811: Add missing newline to the PyCompileError error message.
-  Patch by Alex Shkop.
+- bpo-23811: Add missing newline to the PyCompileError error message. Patch
+  by Alex Shkop.
 
-- Issue #17898: Fix exception in gettext.py when parsing certain plural forms.
+- bpo-17898: Fix exception in gettext.py when parsing certain plural forms.
 
-- Issue #22982: Improve BOM handling when seeking to multiple positions of
-  writable text file.
+- bpo-22982: Improve BOM handling when seeking to multiple positions of a
+  writable text file.
 
-- Issue #23865: close() methods in multiple modules now are idempotent and more
+- bpo-23865: close() methods in multiple modules now are idempotent and more
   robust at shutdown. If they need to release multiple resources, all are
   released even if errors occur.
 
-- Issue #23881: urllib.request.ftpwrapper constructor now closes the socket if
+- bpo-23881: urllib.request.ftpwrapper constructor now closes the socket if
   the FTP connection failed to fix a ResourceWarning.
 
-- Issue #23400: Raise same exception on both Python 2 and 3 if sem_open is not
-  available.  Patch by Davin Potts.
+- bpo-23400: Raise same exception on both Python 2 and 3 if sem_open is not
+  available. Patch by Davin Potts.
 
-- Issue #15133: _tkinter.tkapp.getboolean() now supports Tcl_Obj and always
-  returns bool.  tkinter.BooleanVar now validates input values (accepted bool,
-  int, str, and Tcl_Obj).  tkinter.BooleanVar.get() now always returns bool.
+- bpo-15133: _tkinter.tkapp.getboolean() now supports Tcl_Obj and always
+  returns bool. tkinter.BooleanVar now validates input values (accepted
+  bool, int, str, and Tcl_Obj).  tkinter.BooleanVar.get() now always returns
+  bool.
 
-- Issue #23338: Fixed formatting ctypes error messages on Cygwin.
-  Patch by Makoto Kato.
+- bpo-23338: Fixed formatting ctypes error messages on Cygwin. Patch by
+  Makoto Kato.
 
-- Issue #16840: Tkinter now supports 64-bit integers added in Tcl 8.4 and
+- bpo-16840: Tkinter now supports 64-bit integers added in Tcl 8.4 and
   arbitrary precision integers added in Tcl 8.5.
 
-- Issue #23834: Fix socket.sendto(), use the C Py_ssize_t type to store the
+- bpo-23834: Fix socket.sendto(), use the C Py_ssize_t type to store the
   result of sendto() instead of the C int type.
 
-- Issue #21526: Tkinter now supports new boolean type in Tcl 8.5.
+- bpo-21526: Tkinter now supports new boolean type in Tcl 8.5.
 
-- Issue #23838: linecache now clears the cache and returns an empty result on
+- bpo-23838: linecache now clears the cache and returns an empty result on
   MemoryError.
 
-- Issue #18473: Fixed 2to3 and 3to2 compatible pickle mappings.  Fixed
-  ambigious reverse mappings.  Added many new mappings.  Import mapping is no
-  longer applied to modules already mapped with full name mapping.
+- bpo-18473: Fixed 2to3 and 3to2 compatible pickle mappings.  Fixed
+  ambigious reverse mappings.  Added many new mappings.  Import mapping is
+  no longer applied to modules already mapped with full name mapping.
 
-- Issue #23745: The new email header parser now handles duplicate MIME
+- bpo-23745: The new email header parser now handles duplicate MIME
   parameter names without error, similar to how get_param behaves.
 
-- Issue #23792: Ignore KeyboardInterrupt when the pydoc pager is active.
-  This mimics the behavior of the standard unix pagers, and prevents
-  pipepager from shutting down while the pager itself is still running.
+- bpo-23792: Ignore KeyboardInterrupt when the pydoc pager is active. This
+  mimics the behavior of the standard unix pagers, and prevents pipepager
+  from shutting down while the pager itself is still running.
 
-- Issue #23742: ntpath.expandvars() no longer loses unbalanced single quotes.
+- bpo-23742: ntpath.expandvars() no longer loses unbalanced single quotes.
 
-- Issue #21802: The reader in BufferedRWPair now is closed even when closing
+- bpo-21802: The reader in BufferedRWPair now is closed even when closing
   writer failed in BufferedRWPair.close().
 
-- Issue #23671: string.Template now allows to specify the "self" parameter as
+- bpo-23671: string.Template now allows to specify the "self" parameter as
   keyword argument.  string.Formatter now allows to specify the "self" and
   the "format_string" parameters as keyword arguments.
 
-- Issue #21560: An attempt to write a data of wrong type no longer cause
+- bpo-21560: An attempt to write a data of wrong type no longer cause
   GzipFile corruption.  Original patch by Wolfgang Maier.
 
-- Issue #23647: Increase impalib's MAXLINE to accommodate modern mailbox sizes.
+- bpo-23647: Increase impalib's MAXLINE to accommodate modern mailbox sizes.
 
-- Issue #23539: If body is None, http.client.HTTPConnection.request now sets
-  Content-Length to 0 for PUT, POST, and PATCH headers to avoid 411 errors from
-  some web servers.
+- bpo-23539: If body is None, http.client.HTTPConnection.request now sets
+  Content-Length to 0 for PUT, POST, and PATCH headers to avoid 411 errors
+  from some web servers.
 
-- Issue #22351: The nntplib.NNTP constructor no longer leaves the connection
+- bpo-22351: The nntplib.NNTP constructor no longer leaves the connection
   and socket open until the garbage collector cleans them up.  Patch by
   Martin Panter.
 
-- Issue #23136: _strptime now uniformly handles all days in week 0, including
+- bpo-23136: _strptime now uniformly handles all days in week 0, including
   Dec 30 of previous year.  Based on patch by Jim Carroll.
 
-- Issue #23700: Iterator of NamedTemporaryFile now keeps a reference to
+- bpo-23700: Iterator of NamedTemporaryFile now keeps a reference to
   NamedTemporaryFile instance.  Patch by Bohuslav Kabrda.
 
-- Issue #22903: The fake test case created by unittest.loader when it fails
+- bpo-22903: The fake test case created by unittest.loader when it fails
   importing a test module is now picklable.
 
-- Issue #23568: Add rdivmod support to MagicMock() objects.
-  Patch by Håkan Lövdahl.
+- bpo-23568: Add rdivmod support to MagicMock() objects. Patch by Håkan
+  Lövdahl.
 
-- Issue #23138: Fixed parsing cookies with absent keys or values in cookiejar.
+- bpo-23138: Fixed parsing cookies with absent keys or values in cookiejar.
   Patch by Demian Brecht.
 
-- Issue #23051: multiprocessing.Pool methods imap() and imap_unordered() now
+- bpo-23051: multiprocessing.Pool methods imap() and imap_unordered() now
   handle exceptions raised by an iterator.  Patch by Alon Diamant and Davin
   Potts.
 
-- Issue #22928: Disabled HTTP header injections in http.client.
-  Original patch by Demian Brecht.
+- bpo-22928: Disabled HTTP header injections in http.client. Original patch
+  by Demian Brecht.
 
-- Issue #23615: Modules bz2, tarfile and tokenize now can be reloaded with
-  imp.reload().  Patch by Thomas Kluyver.
+- bpo-23615: Modules bz2, tarfile and tokenize now can be reloaded with
+  imp.reload(). Patch by Thomas Kluyver.
 
-- Issue #23476: In the ssl module, enable OpenSSL's X509_V_FLAG_TRUSTED_FIRST
+- bpo-23476: In the ssl module, enable OpenSSL's X509_V_FLAG_TRUSTED_FIRST
   flag on certificate stores when it is available.
 
-- Issue #23576: Avoid stalling in SSL reads when EOF has been reached in the
+- bpo-23576: Avoid stalling in SSL reads when EOF has been reached in the
   SSL layer but the underlying connection hasn't been closed.
 
-- Issue #23504: Added an __all__ to the types module.
+- bpo-23504: Added an __all__ to the types module.
 
-- Issue #20204: Added the __module__ attribute to _tkinter classes.
+- bpo-20204: Added the __module__ attribute to _tkinter classes.
 
-- Issue #23521: Corrected pure python implementation of timedelta division.
+- bpo-23521: Corrected pure python implementation of timedelta division.
 
- * Eliminated OverflowError from timedelta * float for some floats;
* Corrected rounding in timedlta true division.
+  Eliminated OverflowError from timedelta * float for some floats; Corrected
+  rounding in timedlta true division.
 
-- Issue #21619: Popen objects no longer leave a zombie after exit in the with
+- bpo-21619: Popen objects no longer leave a zombie after exit in the with
   statement if the pipe was broken.  Patch by Martin Panter.
 
-- Issue #6639: Module-level turtle functions no longer raise TclError after
+- bpo-6639: Module-level turtle functions no longer raise TclError after
   closing the window.
 
-- Issues #814253, #9179: Warnings now are raised when group references and
-  conditional group references are used in lookbehind assertions in regular
-  expressions.
+- bpo-814253: Warnings now are raised when group references and conditional
+  group references are used in lookbehind assertions in regular expressions.
+  (See also: bpo-9179)
 
-- Issue #23215: Multibyte codecs with custom error handlers that ignores errors
-  consumed too much memory and raised SystemError or MemoryError.
-  Original patch by Aleksi Torhamo.
+- bpo-23215: Multibyte codecs with custom error handlers that ignores errors
+  consumed too much memory and raised SystemError or MemoryError. Original
+  patch by Aleksi Torhamo.
 
-- Issue #5700: io.FileIO() called flush() after closing the file.
-  flush() was not called in close() if closefd=False.
+- bpo-5700: io.FileIO() called flush() after closing the file. flush() was
+  not called in close() if closefd=False.
 
-- Issue #23374: Fixed pydoc failure with non-ASCII files when stdout encoding
+- bpo-23374: Fixed pydoc failure with non-ASCII files when stdout encoding
   differs from file system encoding (e.g. on Mac OS).
 
-- Issue #23481: Remove RC4 from the SSL module's default cipher list.
+- bpo-23481: Remove RC4 from the SSL module's default cipher list.
 
-- Issue #21548: Fix pydoc.synopsis() and pydoc.apropos() on modules with empty
+- bpo-21548: Fix pydoc.synopsis() and pydoc.apropos() on modules with empty
   docstrings.
 
-- Issue #22885: Fixed arbitrary code execution vulnerability in the dbm.dumb
-  module.  Original patch by Claudiu Popa.
+- bpo-22885: Fixed arbitrary code execution vulnerability in the dbm.dumb
+  module. Original patch by Claudiu Popa.
 
-- Issue #23146: Fix mishandling of absolute Windows paths with forward
-  slashes in pathlib.
+- bpo-23146: Fix mishandling of absolute Windows paths with forward slashes
+  in pathlib.
 
-- Issue #23421: Fixed compression in tarfile CLI.  Patch by wdv4758h.
+- bpo-23421: Fixed compression in tarfile CLI.  Patch by wdv4758h.
 
-- Issue #23367: Fix possible overflows in the unicodedata module.
+- bpo-23367: Fix possible overflows in the unicodedata module.
 
-- Issue #23361: Fix possible overflow in Windows subprocess creation code.
+- bpo-23361: Fix possible overflow in Windows subprocess creation code.
 
-- Issue #23801: Fix issue where cgi.FieldStorage did not always ignore the
+- bpo-23801: Fix issue where cgi.FieldStorage did not always ignore the
   entire preamble to a multipart body.
 
-- Issue #23310: Fix MagicMock's initializer to work with __methods__, just
-  like configure_mock().  Patch by Kasia Jachim.
+- bpo-23310: Fix MagicMock's initializer to work with __methods__, just like
+  configure_mock().  Patch by Kasia Jachim.
 
 - asyncio: New event loop APIs: set_task_factory() and get_task_factory().
 
 - asyncio: async() function is deprecated in favour of ensure_future().
 
-- Issue #23898: Fix inspect.classify_class_attrs() to support attributes
-  with overloaded __eq__ and __bool__.  Patch by Mike Bayer.
+- bpo-23898: Fix inspect.classify_class_attrs() to support attributes with
+  overloaded __eq__ and __bool__.  Patch by Mike Bayer.
 
-- Issue #24298: Fix inspect.signature() to correctly unwrap wrappers
-  around bound methods.
+- bpo-24298: Fix inspect.signature() to correctly unwrap wrappers around
+  bound methods.
 
-- Issue #23572: Fixed functools.singledispatch on classes with falsy
+- bpo-23572: Fixed functools.singledispatch on classes with falsy
   metaclasses.  Patch by Ethan Furman.
 
 IDLE
 ----
 
-- Issue 15348: Stop the debugger engine (normally in a user process)
-  before closing the debugger window (running in the IDLE process).
-  This prevents the RuntimeErrors that were being caught and ignored.
+- bpo-15348: Stop the debugger engine (normally in a user process) before
+  closing the debugger window (running in the IDLE process). This prevents
+  the RuntimeErrors that were being caught and ignored.
 
-- Issue #24455: Prevent IDLE from hanging when a) closing the shell while the
+- bpo-24455: Prevent IDLE from hanging when a) closing the shell while the
   debugger is active (15347); b) closing the debugger with the [X] button
-  (15348); and c) activating the debugger when already active (24455).
-  The patch by Mark Roseman does this by making two changes.
-  1. Suspend and resume the gui.interaction method with the tcl vwait
-  mechanism intended for this purpose (instead of root.mainloop & .quit).
-  2. In gui.run, allow any existing interaction to terminate first.
+  (15348); and c) activating the debugger when already active (24455). The
+  patch by Mark Roseman does this by making two changes. 1. Suspend and
+  resume the gui.interaction method with the tcl vwait mechanism intended
+  for this purpose (instead of root.mainloop & .quit). 2. In gui.run, allow
+  any existing interaction to terminate first.
 
 - Change 'The program' to 'Your program' in an IDLE 'kill program?' message
   to make it clearer that the program referred to is the currently running
   user program, not IDLE itself.
 
-- Issue #24750: Improve the appearance of the IDLE editor window status bar.
+- bpo-24750: Improve the appearance of the IDLE editor window status bar.
   Patch by Mark Roseman.
 
-- Issue #25313: Change the handling of new built-in text color themes to better
+- bpo-25313: Change the handling of new built-in text color themes to better
   address the compatibility problem introduced by the addition of IDLE Dark.
   Consistently use the revised idleConf.CurrentTheme everywhere in idlelib.
 
-- Issue #24782: Extension configuration is now a tab in the IDLE Preferences
+- bpo-24782: Extension configuration is now a tab in the IDLE Preferences
   dialog rather than a separate dialog.   The former tabs are now a sorted
   list.  Patch by Mark Roseman.
 
-- Issue #22726: Re-activate the config dialog help button with some content
+- bpo-22726: Re-activate the config dialog help button with some content
   about the other buttons and the new IDLE Dark theme.
 
-- Issue #24820: IDLE now has an 'IDLE Dark' built-in text color theme.
-  It is more or less IDLE Classic inverted, with a cobalt blue background.
-  Strings, comments, keywords, ... are still green, red, orange, ... .
-  To use it with IDLEs released before November 2015, hit the
-  'Save as New Custom Theme' button and enter a new name,
-  such as 'Custom Dark'.  The custom theme will work with any IDLE
-  release, and can be modified.
+- bpo-24820: IDLE now has an 'IDLE Dark' built-in text color theme. It is
+  more or less IDLE Classic inverted, with a cobalt blue background.
+  Strings, comments, keywords, ... are still green, red, orange, ... . To
+  use it with IDLEs released before November 2015, hit the 'Save as New
+  Custom Theme' button and enter a new name, such as 'Custom Dark'.  The
+  custom theme will work with any IDLE release, and can be modified.
 
-- Issue #25224: README.txt is now an idlelib index for IDLE developers and
-  curious users.  The previous user content is now in the IDLE doc chapter.
+- bpo-25224: README.txt is now an idlelib index for IDLE developers and
+  curious users. The previous user content is now in the IDLE doc chapter.
   'IDLE' now means 'Integrated Development and Learning Environment'.
 
-- Issue #24820: Users can now set breakpoint colors in
-  Settings -> Custom Highlighting.  Original patch by Mark Roseman.
+- bpo-24820: Users can now set breakpoint colors in Settings -> Custom
+  Highlighting. Original patch by Mark Roseman.
 
-- Issue #24972: Inactive selection background now matches active selection
+- bpo-24972: Inactive selection background now matches active selection
   background, as configured by users, on all systems.  Found items are now
   always highlighted on Windows.  Initial patch by Mark Roseman.
 
-- Issue #24570: Idle: make calltip and completion boxes appear on Macs
-  affected by a tk regression.  Initial patch by Mark Roseman.
+- bpo-24570: Idle: make calltip and completion boxes appear on Macs affected
+  by a tk regression.  Initial patch by Mark Roseman.
 
-- Issue #24988: Idle ScrolledList context menus (used in debugger)
-  now work on Mac Aqua.  Patch by Mark Roseman.
+- bpo-24988: Idle ScrolledList context menus (used in debugger) now work on
+  Mac Aqua. Patch by Mark Roseman.
 
-- Issue #24801: Make right-click for context menu work on Mac Aqua.
-  Patch by Mark Roseman.
+- bpo-24801: Make right-click for context menu work on Mac Aqua. Patch by
+  Mark Roseman.
 
-- Issue #25173: Associate tkinter messageboxes with a specific widget.
-  For Mac OSX, make them a 'sheet'.  Patch by Mark Roseman.
+- bpo-25173: Associate tkinter messageboxes with a specific widget. For Mac
+  OSX, make them a 'sheet'.  Patch by Mark Roseman.
 
-- Issue #25198: Enhance the initial html viewer now used for Idle Help.
-  * Properly indent fixed-pitch text (patch by Mark Roseman).
-  * Give code snippet a very Sphinx-like light blueish-gray background.
-  * Re-use initial width and height set by users for shell and editor.
-  * When the Table of Contents (TOC) menu is used, put the section header
-  at the top of the screen.
+- bpo-25198: Enhance the initial html viewer now used for Idle Help. *
+  Properly indent fixed-pitch text (patch by Mark Roseman). * Give code
+  snippet a very Sphinx- like light blueish-gray background. * Re-use
+  initial width and height set by users for shell and editor. * When the
+  Table of Contents (TOC) menu is used, put the section header at the top of
+  the screen.
 
-- Issue #25225: Condense and rewrite Idle doc section on text colors.
+- bpo-25225: Condense and rewrite Idle doc section on text colors.
 
-- Issue #21995: Explain some differences between IDLE and console Python.
+- bpo-21995: Explain some differences between IDLE and console Python.
 
-- Issue #22820: Explain need for *print* when running file from Idle editor.
+- bpo-22820: Explain need for *print* when running file from Idle editor.
 
-- Issue #25224: Doc: augment Idle feature list and no-subprocess section.
+- bpo-25224: Doc: augment Idle feature list and no-subprocess section.
 
-- Issue #25219: Update doc for Idle command line options.
-  Some were missing and notes were not correct.
+- bpo-25219: Update doc for Idle command line options. Some were missing and
+  notes were not correct.
 
-- Issue #24861: Most of idlelib is private and subject to change.
-  Use idleib.idle.* to start Idle. See idlelib.__init__.__doc__.
+- bpo-24861: Most of idlelib is private and subject to change. Use
+  idleib.idle.* to start Idle. See idlelib.__init__.__doc__.
 
-- Issue #25199: Idle: add synchronization comments for future maintainers.
+- bpo-25199: Idle: add synchronization comments for future maintainers.
 
-- Issue #16893: Replace help.txt with help.html for Idle doc display.
-  The new idlelib/help.html is rstripped Doc/build/html/library/idle.html.
-  It looks better than help.txt and will better document Idle as released.
-  The tkinter html viewer that works for this file was written by Mark Roseman.
-  The now unused EditorWindow.HelpDialog class and helt.txt file are deprecated.
+- bpo-16893: Replace help.txt with help.html for Idle doc display. The new
+  idlelib/help.html is rstripped Doc/build/html/library/idle.html. It looks
+  better than help.txt and will better document Idle as released. The
+  tkinter html viewer that works for this file was written by Mark Roseman.
+  The now unused EditorWindow.HelpDialog class and helt.txt file are
+  deprecated.
 
-- Issue #24199: Deprecate unused idlelib.idlever with possible removal in 3.6.
+- bpo-24199: Deprecate unused idlelib.idlever with possible removal in 3.6.
 
-- Issue #24790: Remove extraneous code (which also create 2 & 3 conflicts).
+- bpo-24790: Remove extraneous code (which also create 2 & 3 conflicts).
 
-- Issue #23672: Allow Idle to edit and run files with astral chars in name.
+- bpo-23672: Allow Idle to edit and run files with astral chars in name.
   Patch by Mohd Sanad Zaki Rizvi.
 
-- Issue 24745: Idle editor default font. Switch from Courier to
-  platform-sensitive TkFixedFont.  This should not affect current customized
-  font selections.  If there is a problem, edit $HOME/.idlerc/config-main.cfg
-  and remove 'fontxxx' entries from [Editor Window].  Patch by Mark Roseman.
+- bpo-24745: Idle editor default font. Switch from Courier to platform-
+  sensitive TkFixedFont.  This should not affect current customized font
+  selections.  If there is a problem, edit $HOME/.idlerc/config-main.cfg and
+  remove 'fontxxx' entries from [Editor Window].  Patch by Mark Roseman.
 
-- Issue #21192: Idle editor. When a file is run, put its name in the restart bar.
-  Do not print false prompts. Original patch by Adnan Umer.
+- bpo-21192: Idle editor. When a file is run, put its name in the restart
+  bar. Do not print false prompts. Original patch by Adnan Umer.
 
-- Issue #13884: Idle menus. Remove tearoff lines. Patch by Roger Serwy.
+- bpo-13884: Idle menus. Remove tearoff lines. Patch by Roger Serwy.
 
-- Issue #23184: remove unused names and imports in idlelib.
-  Initial patch by Al Sweigart.
+- bpo-23184: remove unused names and imports in idlelib. Initial patch by Al
+  Sweigart.
 
 Tests
 -----
 
-- Issue #25616: Tests for OrderedDict are extracted from test_collections
-  into separate file test_ordered_dict.
+- bpo-25616: Tests for OrderedDict are extracted from test_collections into
+  separate file test_ordered_dict.
 
-- Issue #25099: Make test_compileall not fail when an entry on sys.path cannot
+- bpo-25099: Make test_compileall not fail when an entry on sys.path cannot
   be written to (commonly seen in administrative installs on Windows).
 
-- Issue #24751: When running regrtest with the ``-w`` command line option,
-  a test run is no longer marked as a failure if all tests succeed when
-  re-run.
+- bpo-24751: When running regrtest with the ``-w`` command line option, a
+  test run is no longer marked as a failure if all tests succeed when re-
+  run.
 
-- Issue #21520: test_zipfile no longer fails if the word 'bad' appears
-  anywhere in the name of the current directory.
+- bpo-21520: test_zipfile no longer fails if the word 'bad' appears anywhere
+  in the name of the current directory.
 
-- Issue #23799: Added test.support.start_threads() for running and
-  cleaning up multiple threads.
+- bpo-23799: Added test.support.start_threads() for running and cleaning up
+  multiple threads.
 
-- Issue #22390: test.regrtest now emits a warning if temporary files or
+- bpo-22390: test.regrtest now emits a warning if temporary files or
   directories are left after running a test.
 
-- Issue #23583: Added tests for standard IO streams in IDLE.
+- bpo-23583: Added tests for standard IO streams in IDLE.
 
 Build
 -----
 
-- Issue #23445: pydebug builds now use "gcc -Og" where possible, to make
-  the resulting executable faster.
+- bpo-23445: pydebug builds now use "gcc -Og" where possible, to make the
+  resulting executable faster.
 
-- Issue #24603: Update Windows builds to use OpenSSL1.0.2d
-  and OS X 10.5 installer to use OpenSSL 1.0.2e.
+- bpo-24603: Update Windows builds to use OpenSSL1.0.2d and OS X 10.5
+  installer to use OpenSSL 1.0.2e.
 
 C API
 -----
 
-- Issue #23998: PyImport_ReInitLock() now checks for lock allocation error
+- bpo-23998: PyImport_ReInitLock() now checks for lock allocation error
 
 Documentation
 -------------
 
-- Issue #12067: Rewrite Comparisons section in the Expressions chapter of the
+- bpo-12067: Rewrite Comparisons section in the Expressions chapter of the
   language reference. Some of the details of comparing mixed types were
   incorrect or ambiguous. NotImplemented is only relevant at a lower level
   than the Expressions chapter. Added details of comparing range() objects,
-  and default behaviour and consistency suggestions for user-defined classes.
-  Patch from Andy Maier.
+  and default behaviour and consistency suggestions for user-defined
+  classes. Patch from Andy Maier.
 
-- Issue #24952: Clarify the default size argument of stack_size() in
-  the "threading" and "_thread" modules. Patch from Mattip.
+- bpo-24952: Clarify the default size argument of stack_size() in the
+  "threading" and "_thread" modules. Patch from Mattip.
 
-- Issue #24808: Update the types of some PyTypeObject fields. Patch by
-  Joseph Weston.
+- bpo-24808: Update the types of some PyTypeObject fields. Patch by Joseph
+  Weston.
 
-- Issue #22812: Fix unittest discovery examples.
-  Patch from Pam McA'Nulty.
+- bpo-22812: Fix unittest discovery examples. Patch from Pam McA'Nulty.
 
-- Issue #24129: Clarify the reference documentation for name resolution.
-  This includes removing the assumption that readers will be familiar with the
+- bpo-24129: Clarify the reference documentation for name resolution. This
+  includes removing the assumption that readers will be familiar with the
   name resolution scheme Python used prior to the introduction of lexical
   scoping for function namespaces. Patch by Ivan Levkivskyi.
 
-- Issue #20769: Improve reload() docs. Patch by Dorian Pula.
+- bpo-20769: Improve reload() docs. Patch by Dorian Pula.
 
-- Issue #23589: Remove duplicate sentence from the FAQ.  Patch by Yongzhi Pan.
+- bpo-23589: Remove duplicate sentence from the FAQ.  Patch by Yongzhi Pan.
 
-- Issue #24729: Correct IO tutorial to match implementation regarding
-  encoding parameter to open function.
+- bpo-24729: Correct IO tutorial to match implementation regarding encoding
+  parameter to open function.
 
-- Issue #24351: Clarify what is meant by "identifier" in the context of
+- bpo-24351: Clarify what is meant by "identifier" in the context of
   string.Template instances.
 
-- Issue #22155: Add File Handlers subsection with createfilehandler to tkinter
+- bpo-22155: Add File Handlers subsection with createfilehandler to tkinter
   doc.  Remove obsolete example from FAQ.  Patch by Martin Panter.
 
-- Issue #24029: Document the name binding behavior for submodule imports.
+- bpo-24029: Document the name binding behavior for submodule imports.
 
-- Issue #24077: Fix typo in man page for -I command option: -s, not -S.
+- bpo-24077: Fix typo in man page for -I command option: -s, not -S.
 
 Tools/Demos
 -----------
 
-- Issue #25440: Fix output of python-config --extension-suffix.
+- bpo-25440: Fix output of python-config --extension-suffix.
 
-- Issue #23330: h2py now supports arbitrary filenames in #include.
+- bpo-23330: h2py now supports arbitrary filenames in #include.
 
-- Issue #24031: make patchcheck now supports git checkouts, too.
+- bpo-24031: make patchcheck now supports git checkouts, too.
 
 Windows
 -------
 
-- Issue #24306: Sets component ID for launcher to match 3.5 and later
-  to avoid downgrading.
+- bpo-24306: Sets component ID for launcher to match 3.5 and later to avoid
+  downgrading.
 
-- Issue #25022: Removed very outdated PC/example_nt/ directory.
+- bpo-25022: Removed very outdated PC/example_nt/ directory.
 
 
-What's New in Python 3.4.3?
-===========================
+What's New in Python 3.4.3 final?
+=================================
 
-Release date: 2015-02-23
+*Release date: 2015-02-23*
 
 Core and Builtins
 -----------------
 
-- Issue #22735: Fix many edge cases (including crashes) involving custom mro()
+- bpo-22735: Fix many edge cases (including crashes) involving custom mro()
   implementations.
 
-- Issue #22896: Avoid using PyObject_AsCharBuffer(), PyObject_AsReadBuffer()
+- bpo-22896: Avoid using PyObject_AsCharBuffer(), PyObject_AsReadBuffer()
   and PyObject_AsWriteBuffer().
 
-- Issue #21295: Revert some changes (issue #16795) to AST line numbers and
+- bpo-21295: Revert some changes (issue #16795) to AST line numbers and
   column offsets that constituted a regression.
 
-- Issue #21408: The default __ne__() now returns NotImplemented if __eq__()
+- bpo-21408: The default __ne__() now returns NotImplemented if __eq__()
   returned NotImplemented.  Original patch by Martin Panter.
 
-- Issue #23321: Fixed a crash in str.decode() when error handler returned
+- bpo-23321: Fixed a crash in str.decode() when error handler returned
   replacment string longer than mailformed input data.
 
-- Issue #23048: Fix jumping out of an infinite while loop in the pdb.
+- bpo-23048: Fix jumping out of an infinite while loop in the pdb.
 
-- Issue #20335: bytes constructor now raises TypeError when encoding or errors
+- bpo-20335: bytes constructor now raises TypeError when encoding or errors
   is specified with non-string argument.  Based on patch by Renaud Blanch.
 
-- Issue #22335: Fix crash when trying to enlarge a bytearray to 0x7fffffff
+- bpo-22335: Fix crash when trying to enlarge a bytearray to 0x7fffffff
   bytes on a 32-bit platform.
 
-- Issue #22653: Fix an assertion failure in debug mode when doing a reentrant
+- bpo-22653: Fix an assertion failure in debug mode when doing a reentrant
   dict insertion in debug mode.
 
-- Issue #22643: Fix integer overflow in Unicode case operations (upper, lower,
+- bpo-22643: Fix integer overflow in Unicode case operations (upper, lower,
   title, swapcase, casefold).
 
-- Issue #22604: Fix assertion error in debug mode when dividing a complex
+- bpo-22604: Fix assertion error in debug mode when dividing a complex
   number by (nan+0j).
 
-- Issue #22470: Fixed integer overflow issues in "backslashreplace",
+- bpo-22470: Fixed integer overflow issues in "backslashreplace",
   "xmlcharrefreplace", and "surrogatepass" error handlers.
 
-- Issue #22520: Fix overflow checking when generating the repr of a unicode
+- bpo-22520: Fix overflow checking when generating the repr of a unicode
   object.
 
-- Issue #22519: Fix overflow checking in PyBytes_Repr.
+- bpo-22519: Fix overflow checking in PyBytes_Repr.
 
-- Issue #22518: Fix integer overflow issues in latin-1 encoding.
+- bpo-22518: Fix integer overflow issues in latin-1 encoding.
 
-- Issue #23165: Perform overflow checks before allocating memory in the
+- bpo-23165: Perform overflow checks before allocating memory in the
   _Py_char2wchar function.
 
 Library
 -------
 
-- Issue #23399: pyvenv creates relative symlinks where possible.
+- bpo-23399: pyvenv creates relative symlinks where possible.
 
-- Issue #23099: Closing io.BytesIO with exported buffer is rejected now to
+- bpo-23099: Closing io.BytesIO with exported buffer is rejected now to
   prevent corrupting exported buffer.
 
-- Issue #23363: Fix possible overflow in itertools.permutations.
+- bpo-23363: Fix possible overflow in itertools.permutations.
 
-- Issue #23364: Fix possible overflow in itertools.product.
+- bpo-23364: Fix possible overflow in itertools.product.
 
-- Issue #23366: Fixed possible integer overflow in itertools.combinations.
+- bpo-23366: Fixed possible integer overflow in itertools.combinations.
 
-- Issue #23369: Fixed possible integer overflow in
+- bpo-23369: Fixed possible integer overflow in
   _json.encode_basestring_ascii.
 
-- Issue #23353: Fix the exception handling of generators in
+- bpo-23353: Fix the exception handling of generators in
   PyEval_EvalFrameEx(). At entry, save or swap the exception state even if
-  PyEval_EvalFrameEx() is called with throwflag=0. At exit, the exception state
-  is now always restored or swapped, not only if why is WHY_YIELD or
+  PyEval_EvalFrameEx() is called with throwflag=0. At exit, the exception
+  state is now always restored or swapped, not only if why is WHY_YIELD or
   WHY_RETURN. Patch co-written with Antoine Pitrou.
 
-- Issue #18518: timeit now rejects statements which can't be compiled outside
-  function or a loop (e.g. "return" or "break").
+- bpo-18518: timeit now rejects statements which can't be compiled outside a
+  function or a loop (e.g. "return" or "break").
 
-- Issue #23094: Fixed readline with frames in Python implementation of pickle.
+- bpo-23094: Fixed readline with frames in Python implementation of pickle.
 
-- Issue #23268: Fixed bugs in the comparison of ipaddress classes.
+- bpo-23268: Fixed bugs in the comparison of ipaddress classes.
 
-- Issue #21408: Removed incorrect implementations of __ne__() which didn't
+- bpo-21408: Removed incorrect implementations of __ne__() which didn't
   returned NotImplemented if __eq__() returned NotImplemented.  The default
   __ne__() now works correctly.
 
-- Issue #19996: :class:`email.feedparser.FeedParser` now handles (malformed)
+- bpo-19996: :class:`email.feedparser.FeedParser` now handles (malformed)
   headers with no key rather than assuming the body has started.
 
-- Issue #23248: Update ssl error codes from latest OpenSSL git master.
+- bpo-23248: Update ssl error codes from latest OpenSSL git master.
 
-- Issue #23098: 64-bit dev_t is now supported in the os module.
+- bpo-23098: 64-bit dev_t is now supported in the os module.
 
-- Issue #23250: In the http.cookies module, capitalize "HttpOnly" and "Secure"
+- bpo-23250: In the http.cookies module, capitalize "HttpOnly" and "Secure"
   as they are written in the standard.
 
-- Issue #23063: In the disutils' check command, fix parsing of reST with code or
-  code-block directives.
+- bpo-23063: In the disutils' check command, fix parsing of reST with code
+  or code-block directives.
 
-- Issue #23209, #23225: selectors.BaseSelector.close() now clears its internal
-  reference to the selector mapping to break a reference cycle. Initial patch
-  written by Martin Richard.
+- bpo-23209: selectors.BaseSelector.close() now clears its internal
+  reference to the selector mapping to break a reference cycle. Initial
+  patch written by Martin Richard. (See also: bpo-23225)
 
-- Issue #21356: Make ssl.RAND_egd() optional to support LibreSSL. The
-  availability of the function is checked during the compilation. Patch written
-  by Bernard Spil.
+- bpo-21356: Make ssl.RAND_egd() optional to support LibreSSL. The
+  availability of the function is checked during the compilation. Patch
+  written by Bernard Spil.
 
-- Issue #20896, #22935: The :func:`ssl.get_server_certificate` function now
-  uses the :data:`~ssl.PROTOCOL_SSLv23` protocol by default, not
-  :data:`~ssl.PROTOCOL_SSLv3`, for maximum compatibility and support platforms
-  where :data:`~ssl.PROTOCOL_SSLv3` support is disabled.
+- bpo-20896: The :func:`ssl.get_server_certificate` function now uses the
+  :data:`~ssl.PROTOCOL_SSLv23` protocol by default, not
+  :data:`~ssl.PROTOCOL_SSLv3`, for maximum compatibility and support
+  platforms where :data:`~ssl.PROTOCOL_SSLv3` support is disabled. (See
+  also: bpo-22935)
 
-- Issue #23111: In the ftplib, make ssl.PROTOCOL_SSLv23 the default protocol
+- bpo-23111: In the ftplib, make ssl.PROTOCOL_SSLv23 the default protocol
   version.
 
-- Issue #23132: Mitigate regression in speed and clarity in functools.total_ordering.
+- bpo-23132: Mitigate regression in speed and clarity in
+  functools.total_ordering.
 
-- Issue #22585: On OpenBSD 5.6 and newer, os.urandom() now calls getentropy(),
+- bpo-22585: On OpenBSD 5.6 and newer, os.urandom() now calls getentropy(),
   instead of reading /dev/urandom, to get pseudo-random bytes.
 
-- Issue #23112: Fix SimpleHTTPServer to correctly carry the query string and
+- bpo-23112: Fix SimpleHTTPServer to correctly carry the query string and
   fragment when it redirects to add a trailing slash.
 
-- Issue #23093: In the io, module allow more operations to work on detached
+- bpo-23093: In the io, module allow more operations to work on detached
   streams.
 
-- Issue #19104: pprint now produces evaluable output for wrapped strings.
+- bpo-19104: pprint now produces evaluable output for wrapped strings.
 
-- Issue #23071: Added missing names to codecs.__all__.  Patch by Martin Panter.
+- bpo-23071: Added missing names to codecs.__all__.  Patch by Martin Panter.
 
-- Issue #15513: Added a __sizeof__ implementation for pickle classes.
+- bpo-15513: Added a __sizeof__ implementation for pickle classes.
 
-- Issue #19858: pickletools.optimize() now aware of the MEMOIZE opcode, can
+- bpo-19858: pickletools.optimize() now aware of the MEMOIZE opcode, can
   produce more compact result and no longer produces invalid output if input
   data contains MEMOIZE opcodes together with PUT or BINPUT opcodes.
 
-- Issue #22095: Fixed HTTPConnection.set_tunnel with default port.  The port
+- bpo-22095: Fixed HTTPConnection.set_tunnel with default port.  The port
   value in the host header was set to "None".  Patch by Demian Brecht.
 
-- Issue #23016: A warning no longer produces an AttributeError when the program
+- bpo-23016: A warning no longer produces an AttributeError when the program
   is run with pythonw.exe.
 
-- Issue #21775: shutil.copytree(): fix crash when copying to VFAT. An exception
-  handler assumed that that OSError objects always have a 'winerror' attribute.
-  That is not the case, so the exception handler itself raised AttributeError
-  when run on Linux (and, presumably, any other non-Windows OS).
-  Patch by Greg Ward.
+- bpo-21775: shutil.copytree(): fix crash when copying to VFAT. An exception
+  handler assumed that that OSError objects always have a 'winerror'
+  attribute. That is not the case, so the exception handler itself raised
+  AttributeError when run on Linux (and, presumably, any other non-Windows
+  OS). Patch by Greg Ward.
 
-- Issue #1218234: Fix inspect.getsource() to load updated source of
-  reloaded module. Initial patch by Berker Peksag.
+- bpo-1218234: Fix inspect.getsource() to load updated source of reloaded
+  module. Initial patch by Berker Peksag.
 
-- Issue #22959: In the constructor of http.client.HTTPSConnection, prefer the
+- bpo-22959: In the constructor of http.client.HTTPSConnection, prefer the
   context's check_hostname attribute over the *check_hostname* parameter.
 
-- Issue #16043: Add a default limit for the amount of data xmlrpclib.gzip_decode
-  will return. This resolves CVE-2013-1753.
+- bpo-16043: Add a default limit for the amount of data
+  xmlrpclib.gzip_decode will return. This resolves CVE-2013-1753.
 
-- Issue #22966: Fix __pycache__ pyc file name clobber when pyc_compile is
-  asked to compile a source file containing multiple dots in the source file
-  name.
+- bpo-22966: Fix __pycache__ pyc file name clobber when pyc_compile is asked
+  to compile a source file containing multiple dots in the source file name.
 
-- Issue #21971: Update turtledemo doc and add module to the index.
+- bpo-21971: Update turtledemo doc and add module to the index.
 
-- Issue #21032. Fixed socket leak if HTTPConnection.getresponse() fails.
+- bpo-21032: Fixed socket leak if HTTPConnection.getresponse() fails.
   Original patch by Martin Panter.
 
-- Issue #22960: Add a context argument to xmlrpclib.ServerProxy constructor.
+- bpo-22960: Add a context argument to xmlrpclib.ServerProxy constructor.
 
-- Issue #22915: SAX parser now supports files opened with file descriptor or
+- bpo-22915: SAX parser now supports files opened with file descriptor or
   bytes path.
 
-- Issue #22609: Constructors and update methods of mapping classes in the
+- bpo-22609: Constructors and update methods of mapping classes in the
   collections module now accept the self keyword argument.
 
-- Issue #22788: Add *context* parameter to logging.handlers.HTTPHandler.
+- bpo-22788: Add *context* parameter to logging.handlers.HTTPHandler.
 
-- Issue #22921: Allow SSLContext to take the *hostname* parameter even if
+- bpo-22921: Allow SSLContext to take the *hostname* parameter even if
   OpenSSL doesn't support SNI.
 
-- Issue #22894: TestCase.subTest() would cause the test suite to be stopped
+- bpo-22894: TestCase.subTest() would cause the test suite to be stopped
   when in failfast mode, even in the absence of failures.
 
-- Issue #22638: SSLv3 is now disabled throughout the standard library.
-  It can still be enabled by instantiating a SSLContext manually.
+- bpo-22638: SSLv3 is now disabled throughout the standard library. It can
+  still be enabled by instantiating a SSLContext manually.
 
-- Issue #22370: Windows detection in pathlib is now more robust.
+- bpo-22370: Windows detection in pathlib is now more robust.
 
-- Issue #22841: Reject coroutines in asyncio add_signal_handler().
-  Patch by Ludovic.Gasc.
+- bpo-22841: Reject coroutines in asyncio add_signal_handler(). Patch by
+  Ludovic.Gasc.
 
-- Issue #22849: Fix possible double free in the io.TextIOWrapper constructor.
+- bpo-22849: Fix possible double free in the io.TextIOWrapper constructor.
 
-- Issue #12728: Different Unicode characters having the same uppercase but
-  different lowercase are now matched in case-insensitive regular expressions.
+- bpo-12728: Different Unicode characters having the same uppercase but
+  different lowercase are now matched in case-insensitive regular
+  expressions.
 
-- Issue #22821: Fixed fcntl() with integer argument on 64-bit big-endian
+- bpo-22821: Fixed fcntl() with integer argument on 64-bit big-endian
   platforms.
 
-- Issue #22406: Fixed the uu_codec codec incorrectly ported to 3.x.
-  Based on patch by Martin Panter.
+- bpo-22406: Fixed the uu_codec codec incorrectly ported to 3.x. Based on
+  patch by Martin Panter.
 
-- Issue #17293: uuid.getnode() now determines MAC address on AIX using netstat.
+- bpo-17293: uuid.getnode() now determines MAC address on AIX using netstat.
   Based on patch by Aivars Kalvāns.
 
-- Issue #22769: Fixed ttk.Treeview.tag_has() when called without arguments.
+- bpo-22769: Fixed ttk.Treeview.tag_has() when called without arguments.
 
-- Issue #22417: Verify certificates by default in httplib (PEP 476).
+- bpo-22417: Verify certificates by default in httplib (PEP 476).
 
-- Issue #22775: Fixed unpickling of http.cookies.SimpleCookie with protocol 2
-  and above.  Patch by Tim Graham.
+- bpo-22775: Fixed unpickling of http.cookies.SimpleCookie with protocol 2
+  and above. Patch by Tim Graham.
 
-- Issue #22366: urllib.request.urlopen will accept a context object
+- bpo-22366: urllib.request.urlopen will accept a context object
   (SSLContext) as an argument which will then used be for HTTPS connection.
   Patch by Alex Gaynor.
 
-- Issue #22776: Brought excluded code into the scope of a try block in
+- bpo-22776: Brought excluded code into the scope of a try block in
   SysLogHandler.emit().
 
-- Issue #22665: Add missing get_terminal_size and SameFileError to
+- bpo-22665: Add missing get_terminal_size and SameFileError to
   shutil.__all__.
 
-- Issue #17381: Fixed handling of case-insensitive ranges in regular
+- bpo-17381: Fixed handling of case-insensitive ranges in regular
   expressions.
 
-- Issue #22410: Module level functions in the re module now cache compiled
+- bpo-22410: Module level functions in the re module now cache compiled
   locale-dependent regular expressions taking into account the locale.
 
-- Issue #22759: Query methods on pathlib.Path() (exists(), is_dir(), etc.)
-  now return False when the underlying stat call raises NotADirectoryError.
+- bpo-22759: Query methods on pathlib.Path() (exists(), is_dir(), etc.) now
+  return False when the underlying stat call raises NotADirectoryError.
 
-- Issue #8876: distutils now falls back to copying files when hard linking
-  doesn't work.  This allows use with special filesystems such as VirtualBox
+- bpo-8876: distutils now falls back to copying files when hard linking
+  doesn't work. This allows use with special filesystems such as VirtualBox
   shared folders.
 
-- Issue #18853: Fixed ResourceWarning in shlex.__nain__.
+- bpo-18853: Fixed ResourceWarning in shlex.__nain__.
 
-- Issue #9351: Defaults set with set_defaults on an argparse subparser
-  are no longer ignored when also set on the parent parser.
+- bpo-9351: Defaults set with set_defaults on an argparse subparser are no
+  longer ignored when also set on the parent parser.
 
-- Issue #21991: Make email.headerregistry's header 'params' attributes
-  be read-only (MappingProxyType).  Previously the dictionary was modifiable
-  but a new one was created on each access of the attribute.
+- bpo-21991: Make email.headerregistry's header 'params' attributes be read-
+  only (MappingProxyType).  Previously the dictionary was modifiable but a
+  new one was created on each access of the attribute.
 
-- Issue #22641: In asyncio, the default SSL context for client connections
-  is now created using ssl.create_default_context(), for stronger security.
+- bpo-22641: In asyncio, the default SSL context for client connections is
+  now created using ssl.create_default_context(), for stronger security.
 
-- Issue #22435: Fix a file descriptor leak when SocketServer bind fails.
+- bpo-22435: Fix a file descriptor leak when SocketServer bind fails.
 
-- Issue #13096: Fixed segfault in CTypes POINTER handling of large
-  values.
+- bpo-13096: Fixed segfault in CTypes POINTER handling of large values.
 
-- Issue #11694: Raise ConversionError in xdrlib as documented.  Patch
-  by Filip Gruszczyński and Claudiu Popa.
+- bpo-11694: Raise ConversionError in xdrlib as documented.  Patch by Filip
+  Gruszczyński and Claudiu Popa.
 
-- Issue #22462: Fix pyexpat's creation of a dummy frame to make it
-  appear in exception tracebacks.
+- bpo-22462: Fix pyexpat's creation of a dummy frame to make it appear in
+  exception tracebacks.
 
-- Issue #21173: Fix len() on a WeakKeyDictionary when .clear() was called
-  with an iterator alive.
+- bpo-21173: Fix len() on a WeakKeyDictionary when .clear() was called with
+  an iterator alive.
 
-- Issue #11866: Eliminated race condition in the computation of names
-  for new threads.
+- bpo-11866: Eliminated race condition in the computation of names for new
+  threads.
 
-- Issue #21905: Avoid RuntimeError in pickle.whichmodule() when sys.modules
-  is mutated while iterating.  Patch by Olivier Grisel.
+- bpo-21905: Avoid RuntimeError in pickle.whichmodule() when sys.modules is
+  mutated while iterating.  Patch by Olivier Grisel.
 
-- Issue #22219: The zipfile module CLI now adds entries for directories
+- bpo-22219: The zipfile module CLI now adds entries for directories
   (including empty directories) in ZIP file.
 
-- Issue #22449: In the ssl.SSLContext.load_default_certs, consult the
+- bpo-22449: In the ssl.SSLContext.load_default_certs, consult the
   environmental variables SSL_CERT_DIR and SSL_CERT_FILE on Windows.
 
-- Issue #20076: Added non derived UTF-8 aliases to locale aliases table.
+- bpo-20076: Added non derived UTF-8 aliases to locale aliases table.
 
-- Issue #20079: Added locales supported in glibc 2.18 to locale alias table.
+- bpo-20079: Added locales supported in glibc 2.18 to locale alias table.
 
-- Issue #22396: On 32-bit AIX platform, don't expose os.posix_fadvise() nor
+- bpo-22396: On 32-bit AIX platform, don't expose os.posix_fadvise() nor
   os.posix_fallocate() because their prototypes in system headers are wrong.
 
-- Issue #22517: When a io.BufferedRWPair object is deallocated, clear its
+- bpo-22517: When a io.BufferedRWPair object is deallocated, clear its
   weakrefs.
 
-- Issue #22448: Improve canceled timer handles cleanup to prevent
-  unbound memory usage. Patch by Joshua Moore-Oliva.
+- bpo-22448: Improve canceled timer handles cleanup to prevent unbound
+  memory usage. Patch by Joshua Moore-Oliva.
 
-- Issue #23009: Make sure selectors.EpollSelecrtor.select() works when no
-  FD is registered.
+- bpo-23009: Make sure selectors.EpollSelecrtor.select() works when no FD is
+  registered.
 
 IDLE
 ----
 
-- Issue #20577: Configuration of the max line length for the FormatParagraph
-  extension has been moved from the General tab of the Idle preferences dialog
-  to the FormatParagraph tab of the Config Extensions dialog.
-  Patch by Tal Einat.
+- bpo-20577: Configuration of the max line length for the FormatParagraph
+  extension has been moved from the General tab of the Idle preferences
+  dialog to the FormatParagraph tab of the Config Extensions dialog. Patch
+  by Tal Einat.
 
-- Issue #16893: Update Idle doc chapter to match current Idle and add new
+- bpo-16893: Update Idle doc chapter to match current Idle and add new
   information.
 
-- Issue #3068: Add Idle extension configuration dialog to Options menu.
-  Changes are written to HOME/.idlerc/config-extensions.cfg.
-  Original patch by Tal Einat.
+- bpo-3068: Add Idle extension configuration dialog to Options menu. Changes
+  are written to HOME/.idlerc/config-extensions.cfg. Original patch by Tal
+  Einat.
 
-- Issue #16233: A module browser (File : Class Browser, Alt+C) requires an
+- bpo-16233: A module browser (File : Class Browser, Alt+C) requires an
   editor window with a filename.  When Class Browser is requested otherwise,
   from a shell, output window, or 'Untitled' editor, Idle no longer displays
-  an error box.  It now pops up an Open Module box (Alt+M). If a valid name
+  an error box. It now pops up an Open Module box (Alt+M). If a valid name
   is entered and a module is opened, a corresponding browser is also opened.
 
-- Issue #4832: Save As to type Python files automatically adds .py to the
-  name you enter (even if your system does not display it).  Some systems
+- bpo-4832: Save As to type Python files automatically adds .py to the name
+  you enter (even if your system does not display it).  Some systems
   automatically add .txt when type is Text files.
 
-- Issue #21986: Code objects are not normally pickled by the pickle module.
-  To match this, they are no longer pickled when running under Idle.
+- bpo-21986: Code objects are not normally pickled by the pickle module. To
+  match this, they are no longer pickled when running under Idle.
 
-- Issue #23180: Rename IDLE "Windows" menu item to "Window".
-  Patch by Al Sweigart.
+- bpo-23180: Rename IDLE "Windows" menu item to "Window". Patch by Al
+  Sweigart.
 
 Tests
 -----
 
-- Issue #23392: Added tests for marshal C API that works with FILE*.
+- bpo-23392: Added tests for marshal C API that works with FILE*.
 
-- Issue #18982: Add tests for CLI of the calendar module.
+- bpo-18982: Add tests for CLI of the calendar module.
 
-- Issue #19548: Added some additional checks to test_codecs to ensure that
+- bpo-19548: Added some additional checks to test_codecs to ensure that
   statements in the updated documentation remain accurate. Patch by Martin
   Panter.
 
-- Issue #22838: All test_re tests now work with unittest test discovery.
+- bpo-22838: All test_re tests now work with unittest test discovery.
 
-- Issue #22173: Update lib2to3 tests to use unittest test discovery.
+- bpo-22173: Update lib2to3 tests to use unittest test discovery.
 
-- Issue #16000: Convert test_curses to use unittest.
+- bpo-16000: Convert test_curses to use unittest.
 
-- Issue #21456: Skip two tests in test_urllib2net.py if _ssl module not
+- bpo-21456: Skip two tests in test_urllib2net.py if _ssl module not
   present. Patch by Remi Pointel.
 
-- Issue #22770: Prevent some Tk segfaults on OS X when running gui tests.
+- bpo-22770: Prevent some Tk segfaults on OS X when running gui tests.
 
-- Issue #23211: Workaround test_logging failure on some OS X 10.6 systems.
+- bpo-23211: Workaround test_logging failure on some OS X 10.6 systems.
 
-- Issue #23345: Prevent test_ssl failures with large OpenSSL patch level
-  values (like 0.9.8zc).
+- bpo-23345: Prevent test_ssl failures with large OpenSSL patch level values
+  (like 0.9.8zc).
 
-- Issue #22289: Prevent test_urllib2net failures due to ftp connection timeout.
+- bpo-22289: Prevent test_urllib2net failures due to ftp connection timeout.
 
 Build
 -----
 
-- Issue #15506: Use standard PKG_PROG_PKG_CONFIG autoconf macro in the configure
-  script.
+- bpo-15506: Use standard PKG_PROG_PKG_CONFIG autoconf macro in the
+  configure script.
 
-- Issue #22935: Allow the ssl module to be compiled if openssl doesn't support
+- bpo-22935: Allow the ssl module to be compiled if openssl doesn't support
   SSL 3.
 
-- Issue #16537: Check whether self.extensions is empty in setup.py. Patch by
+- bpo-16537: Check whether self.extensions is empty in setup.py. Patch by
   Jonathan Hosmer.
 
-- Issue #18096: Fix library order returned by python-config.
+- bpo-18096: Fix library order returned by python-config.
 
-- Issue #17219: Add library build dir for Python extension cross-builds.
+- bpo-17219: Add library build dir for Python extension cross-builds.
 
-- Issue #17128: Use private version of OpenSSL for 3.4.3 OS X 10.5+ installer.
+- bpo-17128: Use private version of OpenSSL for 3.4.3 OS X 10.5+ installer.
 
 C API
 -----
 
-- Issue #22079: PyType_Ready() now checks that statically allocated type has
-  no dynamically allocated bases.
+- bpo-22079: PyType_Ready() now checks that statically allocated type has no
+  dynamically allocated bases.
 
 Documentation
 -------------
 
-- Issue #19548: Update the codecs module documentation to better cover the
+- bpo-19548: Update the codecs module documentation to better cover the
   distinction between text encodings and other codecs, together with other
   clarifications. Patch by Martin Panter.
 
-- Issue #22914: Update the Python 2/3 porting HOWTO to describe a more automated
-  approach.
+- bpo-22914: Update the Python 2/3 porting HOWTO to describe a more
+  automated approach.
 
-- Issue #21514: The documentation of the json module now refers to new JSON RFC
+- bpo-21514: The documentation of the json module now refers to new JSON RFC
   7159 instead of obsoleted RFC 4627.
 
 Tools/Demos
 -----------
 
-- Issue #22314: pydoc now works when the LINES environment variable is set.
+- bpo-22314: pydoc now works when the LINES environment variable is set.
 
 Windows
 -------
 
-- Issue #17896: The Windows build scripts now expect external library sources
+- bpo-17896: The Windows build scripts now expect external library sources
   to be in ``PCbuild\..\externals`` rather than ``PCbuild\..\..``.
 
-- Issue #17717: The Windows build scripts now use a copy of NASM pulled from
+- bpo-17717: The Windows build scripts now use a copy of NASM pulled from
   svn.python.org to build OpenSSL.
 
-- Issue #22644: The bundled version of OpenSSL has been updated to 1.0.1j.
+- bpo-22644: The bundled version of OpenSSL has been updated to 1.0.1j.
 
 
-What's New in Python 3.4.2?
-===========================
+What's New in Python 3.4.2 final?
+=================================
 
-Release date: 2014-10-06
+*Release date: 2014-10-06*
 
 Library
 -------
 
-- Issue #10510: distutils register and upload methods now use HTML standards
+- bpo-10510: distutils register and upload methods now use HTML standards
   compliant CRLF line endings.
 
-- Issue #9850: Fixed macpath.join() for empty first component.  Patch by
-  Oleg Oshmyan.
+- bpo-9850: Fixed macpath.join() for empty first component.  Patch by Oleg
+  Oshmyan.
 
-- Issue #22427: TemporaryDirectory no longer attempts to clean up twice when
+- bpo-22427: TemporaryDirectory no longer attempts to clean up twice when
   used in the with statement in generator.
 
-- Issue #20912: Now directories added to ZIP file have correct Unix and MS-DOS
+- bpo-20912: Now directories added to ZIP file have correct Unix and MS-DOS
   directory attributes.
 
-- Issue #21866: ZipFile.close() no longer writes ZIP64 central directory
+- bpo-21866: ZipFile.close() no longer writes ZIP64 central directory
   records if allowZip64 is false.
 
-- Issue #22415: Fixed debugging output of the GROUPREF_EXISTS opcode in the re
-  module.  Removed trailing spaces in debugging output.
+- bpo-22415: Fixed debugging output of the GROUPREF_EXISTS opcode in the re
+  module. Removed trailing spaces in debugging output.
 
-- Issue #22423: Unhandled exception in thread no longer causes unhandled
+- bpo-22423: Unhandled exception in thread no longer causes unhandled
   AttributeError when sys.stderr is None.
 
-- Issue #21332: Ensure that ``bufsize=1`` in subprocess.Popen() selects
-  line buffering, rather than block buffering.  Patch by Akira Li.
+- bpo-21332: Ensure that ``bufsize=1`` in subprocess.Popen() selects line
+  buffering, rather than block buffering.  Patch by Akira Li.
 
 
-What's New in Python 3.4.2rc1?
-==============================
+What's New in Python 3.4.2 release candidate 1?
+===============================================
 
-Release date: 2014-09-22
+*Release date: 2014-09-22*
 
 Core and Builtins
 -----------------
 
-- Issue #22258: Fix the the internal function set_inheritable() on Illumos.
-  This platform exposes the function ``ioctl(FIOCLEX)``, but calling it fails
-  with errno is ENOTTY: "Inappropriate ioctl for device". set_inheritable()
-  now falls back to the slower ``fcntl()`` (``F_GETFD`` and then ``F_SETFD``).
+- bpo-22258: Fix the the internal function set_inheritable() on Illumos.
+  This platform exposes the function ``ioctl(FIOCLEX)``, but calling it
+  fails with errno is ENOTTY: "Inappropriate ioctl for device".
+  set_inheritable() now falls back to the slower ``fcntl()`` (``F_GETFD``
+  and then ``F_SETFD``).
 
-- Issue #21669: With the aid of heuristics in SyntaxError.__init__, the
-  parser now attempts to generate more meaningful (or at least more search
-  engine friendly) error messages when "exec" and "print" are used as
-  statements.
+- bpo-21669: With the aid of heuristics in SyntaxError.__init__, the parser
+  now attempts to generate more meaningful (or at least more search engine
+  friendly) error messages when "exec" and "print" are used as statements.
 
-- Issue #21642: In the conditional if-else expression, allow an integer written
-  with no space between itself and the ``else`` keyword (e.g. ``True if 42else
-  False``) to be valid syntax.
+- bpo-21642: In the conditional if-else expression, allow an integer written
+  with no space between itself and the ``else`` keyword (e.g. ``True if
+  42else False``) to be valid syntax.
 
-- Issue #21523: Fix over-pessimistic computation of the stack effect of
-  some opcodes in the compiler.  This also fixes a quadratic compilation
-  time issue noticeable when compiling code with a large number of "and"
-  and "or" operators.
+- bpo-21523: Fix over-pessimistic computation of the stack effect of some
+  opcodes in the compiler.  This also fixes a quadratic compilation time
+  issue noticeable when compiling code with a large number of "and" and "or"
+  operators.
 
 Library
 -------
 
-- Issue #21091: Fix API bug: email.message.EmailMessage.is_attachment is now
-  a method.  Since EmailMessage is provisional, we can change the API in a
+- bpo-21091: Fix API bug: email.message.EmailMessage.is_attachment is now a
+  method. Since EmailMessage is provisional, we can change the API in a
   maintenance release, but we use a trick to remain backward compatible with
   3.4.0/1.
 
-- Issue #21079: Fix email.message.EmailMessage.is_attachment to return the
+- bpo-21079: Fix email.message.EmailMessage.is_attachment to return the
   correct result when the header has parameters as well as a value.
 
-- Issue #22247: Add NNTPError to nntplib.__all__.
+- bpo-22247: Add NNTPError to nntplib.__all__.
 
-- Issue #4180: The warnings registries are now reset when the filters
-  are modified.
+- bpo-4180: The warnings registries are now reset when the filters are
+  modified.
 
-- Issue #22419: Limit the length of incoming HTTP request in wsgiref server to
-  65536 bytes and send a 414 error code for higher lengths. Patch contributed
-  by Devin Cook.
+- bpo-22419: Limit the length of incoming HTTP request in wsgiref server to
+  65536 bytes and send a 414 error code for higher lengths. Patch
+  contributed by Devin Cook.
 
 - Lax cookie parsing in http.cookies could be a security issue when combined
   with non-standard cookie handling in some Web browsers.  Reported by
   Sergey Bobrov.
 
-- Issue #22384: An exception in Tkinter callback no longer crashes the program
+- bpo-22384: An exception in Tkinter callback no longer crashes the program
   when it is run with pythonw.exe.
 
-- Issue #22168: Prevent turtle AttributeError with non-default Canvas on OS X.
+- bpo-22168: Prevent turtle AttributeError with non-default Canvas on OS X.
 
-- Issue #21147: sqlite3 now raises an exception if the request contains a null
+- bpo-21147: sqlite3 now raises an exception if the request contains a null
   character instead of truncate it.  Based on patch by Victor Stinner.
 
-- Issue #21951: Fixed a crash in Tkinter on AIX when called Tcl command with
+- bpo-21951: Fixed a crash in Tkinter on AIX when called Tcl command with
   empty string or tuple argument.
 
-- Issue #21951: Tkinter now most likely raises MemoryError instead of crash
-  if the memory allocation fails.
+- bpo-21951: Tkinter now most likely raises MemoryError instead of crash if
+  the memory allocation fails.
 
-- Issue #22338: Fix a crash in the json module on memory allocation failure.
+- bpo-22338: Fix a crash in the json module on memory allocation failure.
 
-- Issue #22226: First letter no longer is stripped from the "status" key in
-  the result of Treeview.heading().
+- bpo-22226: First letter no longer is stripped from the "status" key in the
+  result of Treeview.heading().
 
-- Issue #19524: Fixed resource leak in the HTTP connection when an invalid
+- bpo-19524: Fixed resource leak in the HTTP connection when an invalid
   response is received.  Patch by Martin Panter.
 
-- Issue #22051: turtledemo no longer reloads examples to re-run them.
-  Initialization of variables and gui setup should be done in main(),
-  which is called each time a demo is run, but not on import.
+- bpo-22051: turtledemo no longer reloads examples to re-run them.
+  Initialization of variables and gui setup should be done in main(), which
+  is called each time a demo is run, but not on import.
 
-- Issue #21933: Turtledemo users can change the code font size with a menu
-  selection or control(command) '-' or '+' or control-mousewheel.
-  Original patch by Lita Cho.
+- bpo-21933: Turtledemo users can change the code font size with a menu
+  selection or control(command) '-' or '+' or control-mousewheel. Original
+  patch by Lita Cho.
 
-- Issue #21597: The separator between the turtledemo text pane and the drawing
-  canvas can now be grabbed and dragged with a mouse.  The code text pane can
-  be widened to easily view or copy the full width of the text.  The canvas
-  can be widened on small screens.  Original patches by Jan Kanis and Lita Cho.
+- bpo-21597: The separator between the turtledemo text pane and the drawing
+  canvas can now be grabbed and dragged with a mouse.  The code text pane
+  can be widened to easily view or copy the full width of the text.  The
+  canvas can be widened on small screens.  Original patches by Jan Kanis and
+  Lita Cho.
 
-- Issue #18132: Turtledemo buttons no longer disappear when the window is
+- bpo-18132: Turtledemo buttons no longer disappear when the window is
   shrunk.  Original patches by Jan Kanis and Lita Cho.
 
-- Issue #22216: smtplib now resets its state more completely after a quit.  The
+- bpo-22216: smtplib now resets its state more completely after a quit.  The
   most obvious consequence of the previous behavior was a STARTTLS failure
   during a connect/starttls/quit/connect/starttls sequence.
 
-- Issue #22185: Fix an occasional RuntimeError in threading.Condition.wait()
+- bpo-22185: Fix an occasional RuntimeError in threading.Condition.wait()
   caused by mutation of the waiters queue without holding the lock.  Patch
   by Doug Zongker.
 
-- Issue #22182: Use e.args to unpack exceptions correctly in
+- bpo-22182: Use e.args to unpack exceptions correctly in
   distutils.file_util.move_file. Patch by Claudiu Popa.
 
 - The webbrowser module now uses subprocess's start_new_session=True rather
   than a potentially risky preexec_fn=os.setsid call.
 
-- Issue #22236: Fixed Tkinter images copying operations in NoDefaultRoot mode.
+- bpo-22236: Fixed Tkinter images copying operations in NoDefaultRoot mode.
 
-- Issue #22191: Fix warnings.__all__.
+- bpo-22191: Fix warnings.__all__.
 
-- Issue #15696: Add a __sizeof__ implementation for mmap objects on Windows.
+- bpo-15696: Add a __sizeof__ implementation for mmap objects on Windows.
 
-- Issue #22068: Avoided reference loops with Variables and Fonts in Tkinter.
+- bpo-22068: Avoided reference loops with Variables and Fonts in Tkinter.
 
-- Issue #22165: SimpleHTTPRequestHandler now supports undecodable file names.
+- bpo-22165: SimpleHTTPRequestHandler now supports undecodable file names.
 
-- Issue #8797: Raise HTTPError on failed Basic Authentication immediately.
+- bpo-8797: Raise HTTPError on failed Basic Authentication immediately.
   Initial patch by Sam Bull.
 
-- Issue #20729: Restored the use of lazy iterkeys()/itervalues()/iteritems()
-  in the mailbox module.
+- bpo-20729: Restored the use of lazy iterkeys()/itervalues()/iteritems() in
+  the mailbox module.
 
-- Issue #21448: Changed FeedParser feed() to avoid O(N**2) behavior when
-  parsing long line.  Original patch by Raymond Hettinger.
+- bpo-21448: Changed FeedParser feed() to avoid O(N**2) behavior when
+  parsing long line. Original patch by Raymond Hettinger.
 
-- Issue #22184: The functools LRU Cache decorator factory now gives an earlier
+- bpo-22184: The functools LRU Cache decorator factory now gives an earlier
   and clearer error message when the user forgets the required parameters.
 
-- Issue #17923: glob() patterns ending with a slash no longer match non-dirs on
+- bpo-17923: glob() patterns ending with a slash no longer match non-dirs on
   AIX.  Based on patch by Delhallt.
 
-- Issue #21121: Don't force 3rd party C extensions to be built with
-  -Werror=declaration-after-statement.
+- bpo-21121: Don't force 3rd party C extensions to be built with
+  -Werror=declaration- after-statement.
 
-- Issue #21975: Fixed crash when using uninitialized sqlite3.Row (in particular
-  when unpickling pickled sqlite3.Row).  sqlite3.Row is now initialized in the
-  __new__() method.
+- bpo-21975: Fixed crash when using uninitialized sqlite3.Row (in particular
+  when unpickling pickled sqlite3.Row).  sqlite3.Row is now initialized in
+  the __new__() method.
 
-- Issue #21580: Now Tkinter correctly handles bytes arguments passed to Tk.
-  In particular this allows to initialize images from binary data.
+- bpo-21580: Now Tkinter correctly handles bytes arguments passed to Tk. In
+  particular this allows to initialize images from binary data.
 
-- Issue #17172: Make turtledemo start as active on OS X even when run with
-  subprocess.  Patch by Lita Cho.
+- bpo-17172: Make turtledemo start as active on OS X even when run with
+  subprocess. Patch by Lita Cho.
 
-- Issue #21704: Fix build error for _multiprocessing when semaphores
-  are not available.  Patch by Arfrever Frehtes Taifersar Arahesis.
+- bpo-21704: Fix build error for _multiprocessing when semaphores are not
+  available. Patch by Arfrever Frehtes Taifersar Arahesis.
 
 - Fix repr(_socket.socket) on Windows 64-bit: don't fail with OverflowError
   on closed socket. repr(socket.socket) already works fine.
 
-- Issue #16133: The asynchat.async_chat.handle_read() method now ignores
+- bpo-16133: The asynchat.async_chat.handle_read() method now ignores
   BlockingIOError exceptions.
 
-- Issue #22044: Fixed premature DECREF in call_tzinfo_method.
-  Patch by Tom Flanagan.
+- bpo-22044: Fixed premature DECREF in call_tzinfo_method. Patch by Tom
+  Flanagan.
 
-- Issue #19884: readline: Disable the meta modifier key if stdout is not
-  terminal to not write the ANSI sequence "\033[1034h" into stdout. This
+- bpo-19884: readline: Disable the meta modifier key if stdout is not a
+  terminal to not write the ANSI sequence "\033[1034h" into stdout. This
   sequence is used on some terminal (ex: TERM=xterm-256color") to enable
   support of 8 bit characters.
 
-- Issue #21888: plistlib's load() and loads() now work if the fmt parameter is
+- bpo-21888: plistlib's load() and loads() now work if the fmt parameter is
   specified.
 
-- Issue #21044: tarfile.open() now handles fileobj with an integer 'name'
+- bpo-21044: tarfile.open() now handles fileobj with an integer 'name'
   attribute.  Based on patch by Antoine Pietri.
 
-- Issue #21867: Prevent turtle crash due to invalid undo buffer size.
+- bpo-21867: Prevent turtle crash due to invalid undo buffer size.
 
-- Issue #19076: Don't pass the redundant 'file' argument to self.error().
+- bpo-19076: Don't pass the redundant 'file' argument to self.error().
 
-- Issue #21942: Fixed source file viewing in pydoc's server mode on Windows.
+- bpo-21942: Fixed source file viewing in pydoc's server mode on Windows.
 
-- Issue #11259: asynchat.async_chat().set_terminator() now raises a ValueError
+- bpo-11259: asynchat.async_chat().set_terminator() now raises a ValueError
   if the number of received bytes is negative.
 
-- Issue #12523: asynchat.async_chat.push() now raises a TypeError if it doesn't
+- bpo-12523: asynchat.async_chat.push() now raises a TypeError if it doesn't
   get a bytes string
 
-- Issue #21707: Add missing kwonlyargcount argument to
+- bpo-21707: Add missing kwonlyargcount argument to
   ModuleFinder.replace_paths_in_code().
 
-- Issue #20639: calling Path.with_suffix('') allows removing the suffix
-  again.  Patch by July Tikhonov.
+- bpo-20639: calling Path.with_suffix('') allows removing the suffix again.
+  Patch by July Tikhonov.
 
-- Issue #21714: Disallow the construction of invalid paths using
+- bpo-21714: Disallow the construction of invalid paths using
   Path.with_name().  Original patch by Antony Lee.
 
-- Issue #21897: Fix a crash with the f_locals attribute with closure
-  variables when frame.clear() has been called.
+- bpo-21897: Fix a crash with the f_locals attribute with closure variables
+  when frame.clear() has been called.
 
-- Issue #21151: Fixed a segfault in the winreg module when ``None`` is passed
+- bpo-21151: Fixed a segfault in the winreg module when ``None`` is passed
   as a ``REG_BINARY`` value to SetValueEx.  Patch by John Ehresman.
 
-- Issue #21090: io.FileIO.readall() does not ignore I/O errors anymore. Before,
+- bpo-21090: io.FileIO.readall() does not ignore I/O errors anymore. Before,
   it ignored I/O errors if at least the first C call read() succeed.
 
-- Issue #21781: ssl.RAND_add() now supports strings longer than 2 GB.
+- bpo-21781: ssl.RAND_add() now supports strings longer than 2 GB.
 
-- Issue #11453: asyncore: emit a ResourceWarning when an unclosed file_wrapper
+- bpo-11453: asyncore: emit a ResourceWarning when an unclosed file_wrapper
   object is destroyed. The destructor now closes the file if needed. The
   close() method can now be called twice: the second call does nothing.
 
-- Issue #21858: Better handling of Python exceptions in the sqlite3 module.
+- bpo-21858: Better handling of Python exceptions in the sqlite3 module.
 
-- Issue #21476: Make sure the email.parser.BytesParser TextIOWrapper is
+- bpo-21476: Make sure the email.parser.BytesParser TextIOWrapper is
   discarded after parsing, so the input file isn't unexpectedly closed.
 
-- Issue #21729: Used the "with" statement in the dbm.dumb module to ensure
-  files closing.  Patch by Claudiu Popa.
+- bpo-21729: Used the "with" statement in the dbm.dumb module to ensure
+  files closing. Patch by Claudiu Popa.
 
-- Issue #21491: socketserver: Fix a race condition in child processes reaping.
+- bpo-21491: socketserver: Fix a race condition in child processes reaping.
 
-- Issue #21832: Require named tuple inputs to be exact strings.
+- bpo-21832: Require named tuple inputs to be exact strings.
 
-- Issue #19145: The times argument for itertools.repeat now handles
-  negative values the same way for keyword arguments as it does for
-  positional arguments.
+- bpo-19145: The times argument for itertools.repeat now handles negative
+  values the same way for keyword arguments as it does for positional
+  arguments.
 
-- Issue #21812: turtle.shapetransform did not tranform the turtle on the
-  first call.  (Issue identified and fixed by Lita Cho.)
+- bpo-21812: turtle.shapetransform did not tranform the turtle on the first
+  call.  (Issue identified and fixed by Lita Cho.)
 
-- Issue #21635: The difflib SequenceMatcher.get_matching_blocks() method
-  cache didn't match the actual result.  The former was a list of tuples
-  and the latter was a list of named tuples.
+- bpo-21635: The difflib SequenceMatcher.get_matching_blocks() method cache
+  didn't match the actual result.  The former was a list of tuples and the
+  latter was a list of named tuples.
 
-- Issue #21722: The distutils "upload" command now exits with a non-zero
-  return code when uploading fails.  Patch by Martin Dengler.
+- bpo-21722: The distutils "upload" command now exits with a non-zero return
+  code when uploading fails.  Patch by Martin Dengler.
 
-- Issue #21723: asyncio.Queue: support any type of number (ex: float) for the
+- bpo-21723: asyncio.Queue: support any type of number (ex: float) for the
   maximum size. Patch written by Vajrasky Kok.
 
-- Issue #21326: Add a new is_closed() method to asyncio.BaseEventLoop.
-  run_forever() and run_until_complete() methods of asyncio.BaseEventLoop now
-  raise an exception if the event loop was closed.
+- bpo-21326: Add a new is_closed() method to asyncio.BaseEventLoop.
+  run_forever() and run_until_complete() methods of asyncio.BaseEventLoop
+  now raise an exception if the event loop was closed.
 
-- Issue #21774: Fixed NameError for an incorrect variable reference in the
-  XML Minidom code for creating processing instructions.
-  (Found and fixed by Claudiu Popa.)
+- bpo-21774: Fixed NameError for an incorrect variable reference in the XML
+  Minidom code for creating processing instructions. (Found and fixed by
+  Claudiu Popa.)
 
-- Issue #21766: Prevent a security hole in CGIHTTPServer by URL unquoting paths
+- bpo-21766: Prevent a security hole in CGIHTTPServer by URL unquoting paths
   before checking for a CGI script at that path.
 
-- Issue #21310: Fixed possible resource leak in failed open().
+- bpo-21310: Fixed possible resource leak in failed open().
 
-- Issue #21677: Fixed chaining nonnormalized exceptions in io close() methods.
+- bpo-21677: Fixed chaining nonnormalized exceptions in io close() methods.
 
-- Issue #11709: Fix the pydoc.help function to not fail when sys.stdin is not a
+- bpo-11709: Fix the pydoc.help function to not fail when sys.stdin is not a
   valid file.
 
-- Issue #13223: Fix pydoc.writedoc so that the HTML documentation for methods
+- bpo-13223: Fix pydoc.writedoc so that the HTML documentation for methods
   that use 'self' in the example code is generated correctly.
 
-- Issue #21463: In urllib.request, fix pruning of the FTP cache.
+- bpo-21463: In urllib.request, fix pruning of the FTP cache.
 
-- Issue #21618: The subprocess module could fail to close open fds that were
+- bpo-21618: The subprocess module could fail to close open fds that were
   inherited by the calling process and already higher than POSIX resource
   limits would otherwise allow.  On systems with a functioning /proc/self/fd
   or /dev/fd interface the max is now ignored and all fds are closed.
 
-- Issue #21552: Fixed possible integer overflow of too long string lengths in
+- bpo-21552: Fixed possible integer overflow of too long string lengths in
   the tkinter module on 64-bit platforms.
 
-- Issue #14315: The zipfile module now ignores extra fields in the central
-  directory that are too short to be parsed instead of letting a struct.unpack
-  error bubble up as this "bad data" appears in many real world zip files in
-  the wild and is ignored by other zip tools.
+- bpo-14315: The zipfile module now ignores extra fields in the central
+  directory that are too short to be parsed instead of letting a
+  struct.unpack error bubble up as this "bad data" appears in many real
+  world zip files in the wild and is ignored by other zip tools.
 
-- Issue #21402: tkinter.ttk now works when default root window is not set.
+- bpo-21402: tkinter.ttk now works when default root window is not set.
 
-- Issue #10203: sqlite3.Row now truly supports sequence protocol.  In particular
-  it supports reverse() and negative indices.  Original patch by Claudiu Popa.
+- bpo-10203: sqlite3.Row now truly supports sequence protocol.  In
+  particular it supports reverse() and negative indices.  Original patch by
+  Claudiu Popa.
 
-- Issue #18807: If copying (no symlinks) specified for a venv, then the python
-  interpreter aliases (python, python3) are now created by copying rather than
-  symlinking.
+- bpo-18807: If copying (no symlinks) specified for a venv, then the python
+  interpreter aliases (python, python3) are now created by copying rather
+  than symlinking.
 
-- Issue #14710: pkgutil.get_loader() no longer raises an exception when None is
+- bpo-14710: pkgutil.get_loader() no longer raises an exception when None is
   found in sys.modules.
 
-- Issue #14710: pkgutil.find_loader() no longer raises an exception when a
+- bpo-14710: pkgutil.find_loader() no longer raises an exception when a
   module doesn't exist.
 
-- Issue #21481: Argparse equality and inequality tests now return
+- bpo-21481: Argparse equality and inequality tests now return
   NotImplemented when comparing to an unknown type.
 
-- Issue #8743: Fix interoperability between set objects and the
+- bpo-8743: Fix interoperability between set objects and the
   collections.Set() abstract base class.
 
-- Issue #13355: random.triangular() no longer fails with a ZeroDivisionError
+- bpo-13355: random.triangular() no longer fails with a ZeroDivisionError
   when low equals high.
 
-- Issue #21538: The plistlib module now supports loading of binary plist files
+- bpo-21538: The plistlib module now supports loading of binary plist files
   when reference or offset size is not a power of two.
 
-- Issue #21801: Validate that __signature__ is None or an instance of Signature.
+- bpo-21801: Validate that __signature__ is None or an instance of
+  Signature.
 
-- Issue #21923: Prevent AttributeError in distutils.sysconfig.customize_compiler
-  due to possible uninitialized _config_vars.
+- bpo-21923: Prevent AttributeError in
+  distutils.sysconfig.customize_compiler due to possible uninitialized
+  _config_vars.
 
-- Issue #21323: Fix http.server to again handle scripts in CGI subdirectories,
+- bpo-21323: Fix http.server to again handle scripts in CGI subdirectories,
   broken by the fix for security issue #19435.  Patch by Zach Byrne.
 
-Extension Modules
------------------
-
-- Issue #22176: Update the ctypes module's libffi to v3.1.  This release
-  adds support for the Linux AArch64 and POWERPC ELF ABIv2 little endian
+- bpo-22176: Update the ctypes module's libffi to v3.1.  This release adds
+  support for the Linux AArch64 and POWERPC ELF ABIv2 little endian
   architectures.
 
 Build
 -----
 
-- Issue #15661: python.org OS X installers are now distributed as signed
+- bpo-15661: python.org OS X installers are now distributed as signed
   installer packages compatible with the Gatekeeper security feature.
 
-- Issue #21958: Define HAVE_ROUND when building with Visual Studio 2013 and
+- bpo-21958: Define HAVE_ROUND when building with Visual Studio 2013 and
   above.  Patch by Zachary Turner.
 
-- Issue #15759: "make suspicious", "make linkcheck" and "make doctest" in Doc/
+- bpo-15759: "make suspicious", "make linkcheck" and "make doctest" in Doc/
   now display special message when and only when there are failures.
 
-- Issue #17095: Fix Modules/Setup *shared* support.
+- bpo-17095: Fix Modules/Setup *shared* support.
 
-- Issue #21811: Anticipated fixes to support OS X versions > 10.9.
+- bpo-21811: Anticipated fixes to support OS X versions > 10.9.
 
-- Issue #21166: Prevent possible segfaults and other random failures of
-  python --generate-posix-vars in pybuilddir.txt build target.
+- bpo-21166: Prevent possible segfaults and other random failures of python
+  --generate- posix-vars in pybuilddir.txt build target.
 
 IDLE
 ----
 
-- Issue #17390: Adjust Editor window title; remove 'Python',
-  move version to end.
+- bpo-17390: Adjust Editor window title; remove 'Python', move version to
+  end.
 
-- Issue #14105: Idle debugger breakpoints no longer disappear
-  when inseting or deleting lines.
+- bpo-14105: Idle debugger breakpoints no longer disappear when inseting or
+  deleting lines.
 
-- Issue #17172: Turtledemo can now be run from Idle.
-  Currently, the entry is on the Help menu, but it may move to Run.
-  Patch by Ramchandra Apt and Lita Cho.
+- bpo-17172: Turtledemo can now be run from Idle. Currently, the entry is on
+  the Help menu, but it may move to Run. Patch by Ramchandra Apt and Lita
+  Cho.
 
-- Issue #21765: Add support for non-ascii identifiers to HyperParser.
+- bpo-21765: Add support for non-ascii identifiers to HyperParser.
 
-- Issue #21940: Add unittest for WidgetRedirector. Initial patch by Saimadhav
+- bpo-21940: Add unittest for WidgetRedirector. Initial patch by Saimadhav
   Heblikar.
 
-- Issue #18592: Add unittest for SearchDialogBase. Patch by Phil Webster.
+- bpo-18592: Add unittest for SearchDialogBase. Patch by Phil Webster.
 
-- Issue #21694: Add unittest for ParenMatch. Patch by Saimadhav Heblikar.
+- bpo-21694: Add unittest for ParenMatch. Patch by Saimadhav Heblikar.
 
-- Issue #21686: add unittest for HyperParser. Original patch by Saimadhav
+- bpo-21686: add unittest for HyperParser. Original patch by Saimadhav
   Heblikar.
 
-- Issue #12387: Add missing upper(lower)case versions of default Windows key
-  bindings for Idle so Caps Lock does not disable them. Patch by Roger Serwy.
+- bpo-12387: Add missing upper(lower)case versions of default Windows key
+  bindings for Idle so Caps Lock does not disable them. Patch by Roger
+  Serwy.
 
-- Issue #21695: Closing a Find-in-files output window while the search is
-  still in progress no longer closes Idle.
+- bpo-21695: Closing a Find-in-files output window while the search is still
+  in progress no longer closes Idle.
 
-- Issue #18910: Add unittest for textView. Patch by Phil Webster.
+- bpo-18910: Add unittest for textView. Patch by Phil Webster.
 
-- Issue #18292: Add unittest for AutoExpand. Patch by Saihadhav Heblikar.
+- bpo-18292: Add unittest for AutoExpand. Patch by Saihadhav Heblikar.
 
-- Issue #18409: Add unittest for AutoComplete. Patch by Phil Webster.
+- bpo-18409: Add unittest for AutoComplete. Patch by Phil Webster.
 
 Tests
 -----
 
-- Issue #22166: With the assistance of a new internal _codecs._forget_codec
+- bpo-22166: With the assistance of a new internal _codecs._forget_codec
   helping function, test_codecs now clears the encoding caches to avoid the
   appearance of a reference leak
 
-- Issue #22236: Tkinter tests now don't reuse default root window.  New root
+- bpo-22236: Tkinter tests now don't reuse default root window.  New root
   window is created for every test class.
 
-- Issue #20746: Fix test_pdb to run in refleak mode (-R).  Patch by Xavier
-  de Gaye.
+- bpo-20746: Fix test_pdb to run in refleak mode (-R).  Patch by Xavier de
+  Gaye.
 
-- Issue #22060: test_ctypes has been somewhat cleaned up and simplified; it
-  now uses unittest test discovery to find its tests.
+- bpo-22060: test_ctypes has been somewhat cleaned up and simplified; it now
+  uses unittest test discovery to find its tests.
 
-- Issue #22104: regrtest.py no longer holds a reference to the suite of tests
+- bpo-22104: regrtest.py no longer holds a reference to the suite of tests
   loaded from test modules that don't define test_main().
 
-- Issue #22002: Added ``load_package_tests`` function to test.support and used
+- bpo-22002: Added ``load_package_tests`` function to test.support and used
   it to implement/augment test discovery in test_asyncio, test_email,
   test_importlib, test_json, and test_tools.
 
-- Issue #21976: Fix test_ssl to accept LibreSSL version strings.  Thanks
-  to William Orr.
+- bpo-21976: Fix test_ssl to accept LibreSSL version strings.  Thanks to
+  William Orr.
 
-- Issue #21918: Converted test_tools from a module to a package containing
+- bpo-21918: Converted test_tools from a module to a package containing
   separate test files for each tested script.
 
-- Issue #20155: Changed HTTP method names in failing tests in test_httpservers
-  so that packet filtering software (specifically Windows Base Filtering Engine)
-  does not interfere with the transaction semantics expected by the tests.
+- bpo-20155: Changed HTTP method names in failing tests in test_httpservers
+  so that packet filtering software (specifically Windows Base Filtering
+  Engine) does not interfere with the transaction semantics expected by the
+  tests.
 
-- Issue #19493: Refactored the ctypes test package to skip tests explicitly
+- bpo-19493: Refactored the ctypes test package to skip tests explicitly
   rather than silently.
 
-- Issue #18492: All resources are now allowed when tests are not run by
+- bpo-18492: All resources are now allowed when tests are not run by
   regrtest.py.
 
-- Issue #21634: Fix pystone micro-benchmark: use floor division instead of true
-  division to benchmark integers instead of floating point numbers. Set pystone
-  version to 1.2. Patch written by Lennart Regebro.
+- bpo-21634: Fix pystone micro-benchmark: use floor division instead of true
+  division to benchmark integers instead of floating point numbers. Set
+  pystone version to 1.2. Patch written by Lennart Regebro.
 
-- Issue #21605: Added tests for Tkinter images.
+- bpo-21605: Added tests for Tkinter images.
 
-- Issue #21493: Added test for ntpath.expanduser().  Original patch by
-  Claudiu Popa.
+- bpo-21493: Added test for ntpath.expanduser().  Original patch by Claudiu
+  Popa.
 
-- Issue #19925: Added tests for the spwd module. Original patch by Vajrasky Kok.
+- bpo-19925: Added tests for the spwd module. Original patch by Vajrasky
+  Kok.
 
-- Issue #21522: Added Tkinter tests for Listbox.itemconfigure(),
+- bpo-21522: Added Tkinter tests for Listbox.itemconfigure(),
   PanedWindow.paneconfigure(), and Menu.entryconfigure().
 
 Documentation
 -------------
 
-- Issue #21777: The binary sequence methods on bytes and bytearray are now
+- bpo-21777: The binary sequence methods on bytes and bytearray are now
   documented explicitly, rather than assuming users will be able to derive
-  the expected behaviour from the behaviour of the corresponding str methods.
+  the expected behaviour from the behaviour of the corresponding str
+  methods.
 
 Windows
 -------
 
-- Issue #21671, #22160, CVE-2014-0224: The bundled version of OpenSSL has been
-  updated to 1.0.1i.
+- bpo-21671: The bundled version of OpenSSL has been updated to 1.0.1i. (See
+  also: bpo-22160, CVE-2014-0224)
 
-- Issue #10747: Use versioned labels in the Windows start menu.
-  Patch by Olive Kilburn.
+- bpo-10747: Use versioned labels in the Windows start menu. Patch by Olive
+  Kilburn.
 
 Tools/Demos
 -----------
 
-- Issue #22201: Command-line interface of the zipfile module now correctly
+- bpo-22201: Command-line interface of the zipfile module now correctly
   extracts ZIP files with directory entries.  Patch by Ryan Wilson.
 
-- Issue #21906: Make Tools/scripts/md5sum.py work in Python 3.
-  Patch by Zachary Ware.
+- bpo-21906: Make Tools/scripts/md5sum.py work in Python 3. Patch by Zachary
+  Ware.
 
-- Issue #21629: Fix Argument Clinic's "--converters" feature.
+- bpo-21629: Fix Argument Clinic's "--converters" feature.
 
 
-What's New in Python 3.4.1?
-===========================
+What's New in Python 3.4.1 final?
+=================================
 
-Release date: 2014-05-18
+*Release date: 2014-05-18*
 
 Core and Builtins
 -----------------
 
-- Issue #21418: Fix a crash in the builtin function super() when called without
+- bpo-21418: Fix a crash in the builtin function super() when called without
   argument and without current frame (ex: embedded Python).
 
-- Issue #21425: Fix flushing of standard streams in the interactive
+- bpo-21425: Fix flushing of standard streams in the interactive
   interpreter.
 
-- Issue #21435: In rare cases, when running finalizers on objects in cyclic
+- bpo-21435: In rare cases, when running finalizers on objects in cyclic
   trash a bad pointer dereference could occur due to a subtle flaw in
   internal iteration logic.
 
 Library
 -------
 
-- Issue #10744: Fix PEP 3118 format strings on ctypes objects with a nontrivial
+- bpo-10744: Fix PEP 3118 format strings on ctypes objects with a nontrivial
   shape.
 
-- Issue #20998: Fixed re.fullmatch() of repeated single character pattern
-  with ignore case.  Original patch by Matthew Barnett.
+- bpo-20998: Fixed re.fullmatch() of repeated single character pattern with
+  ignore case. Original patch by Matthew Barnett.
 
-- Issue #21075: fileinput.FileInput now reads bytes from standard stream if
+- bpo-21075: fileinput.FileInput now reads bytes from standard stream if
   binary mode is specified.  Patch by Sam Kimbrel.
 
-- Issue #21396: Fix TextIOWrapper(..., write_through=True) to not force a
+- bpo-21396: Fix TextIOWrapper(..., write_through=True) to not force a
   flush() on the underlying binary stream.  Patch by akira.
 
-- Issue #21470: Do a better job seeding the random number generator by
-  using enough bytes to span the full state space of the Mersenne Twister.
+- bpo-21470: Do a better job seeding the random number generator by using
+  enough bytes to span the full state space of the Mersenne Twister.
 
-- Issue #21398: Fix an unicode error in the pydoc pager when the documentation
+- bpo-21398: Fix an unicode error in the pydoc pager when the documentation
   contains characters not encodable to the stdout encoding.
 
 Tests
 -----
 
-- Issue #17756: Fix test_code test when run from the installed location.
+- bpo-17756: Fix test_code test when run from the installed location.
 
-- Issue #17752: Fix distutils tests when run from the installed location.
+- bpo-17752: Fix distutils tests when run from the installed location.
 
 IDLE
 ----
 
-- Issue #18104: Add idlelib/idle_test/htest.py with a few sample tests to begin
-  consolidating and improving human-validated tests of Idle. Change other files
-  as needed to work with htest.  Running the module as __main__ runs all tests.
+- bpo-18104: Add idlelib/idle_test/htest.py with a few sample tests to begin
+  consolidating and improving human-validated tests of Idle. Change other
+  files as needed to work with htest.  Running the module as __main__ runs
+  all tests.
 
 
-What's New in Python 3.4.1rc1?
-==============================
+What's New in Python 3.4.1 release candidate 1?
+===============================================
 
-Release date: 2014-05-05
+*Release date: 2014-05-05*
 
 Core and Builtins
 -----------------
 
-- Issue #21274: Define PATH_MAX for GNU/Hurd in Python/pythonrun.c.
+- bpo-21274: Define PATH_MAX for GNU/Hurd in Python/pythonrun.c.
 
-- Issue #21209: Fix sending tuples to custom generator objects with the yield
+- bpo-21209: Fix sending tuples to custom generator objects with the yield
   from syntax.
 
-- Issue #21134: Fix segfault when str is called on an uninitialized
+- bpo-21134: Fix segfault when str is called on an uninitialized
   UnicodeEncodeError, UnicodeDecodeError, or UnicodeTranslateError object.
 
-- Issue #19537: Fix PyUnicode_DATA() alignment under m68k.  Patch by
-  Andreas Schwab.
+- bpo-19537: Fix PyUnicode_DATA() alignment under m68k.  Patch by Andreas
+  Schwab.
 
-- Issue #20929: Add a type cast to avoid shifting a negative number.
+- bpo-20929: Add a type cast to avoid shifting a negative number.
 
-- Issue #20731: Properly position in source code files even if they
-  are opened in text mode. Patch by Serhiy Storchaka.
+- bpo-20731: Properly position in source code files even if they are opened
+  in text mode. Patch by Serhiy Storchaka.
 
-- Issue #20637: Key-sharing now also works for instance dictionaries of
+- bpo-20637: Key-sharing now also works for instance dictionaries of
   subclasses.  Patch by Peter Ingebretson.
 
-- Issue #12546: Allow ``\x00`` to be used as a fill character when using str, int,
-  float, and complex __format__ methods.
+- bpo-12546: Allow ``\x00`` to be used as a fill character when using str,
+  int, float, and complex __format__ methods.
 
-- Issue #13598: Modify string.Formatter to support auto-numbering of
-  replacement fields. It now matches the behavior of str.format() in
-  this regard. Patches by Phil Elson and Ramchandra Apte.
+- bpo-13598: Modify string.Formatter to support auto-numbering of
+  replacement fields. It now matches the behavior of str.format() in this
+  regard. Patches by Phil Elson and Ramchandra Apte.
 
 Library
 -------
 
-- Issue #21088: Bugfix for curses.window.addch() regression in 3.4.0.
-  In porting to Argument Clinic, the first two arguments were reversed.
+- bpo-21088: Bugfix for curses.window.addch() regression in 3.4.0. In
+  porting to Argument Clinic, the first two arguments were reversed.
 
-- Issue #21469: Reduced the risk of false positives in robotparser by
-  checking to make sure that robots.txt has been read or does not exist
-  prior to returning True in can_fetch().
+- bpo-21469: Reduced the risk of false positives in robotparser by checking
+  to make sure that robots.txt has been read or does not exist prior to
+  returning True in can_fetch().
 
-- Issue #21321: itertools.islice() now releases the reference to the source
+- bpo-21321: itertools.islice() now releases the reference to the source
   iterator when the slice is exhausted.  Patch by Anton Afanasyev.
 
-- Issue #9815: assertRaises now tries to clear references to local variables
-  in the exception's traceback.
+- bpo-9815: assertRaises now tries to clear references to local variables in
+  the exception's traceback.
 
-- Issue #13204: Calling sys.flags.__new__ would crash the interpreter,
-  now it raises a TypeError.
+- bpo-13204: Calling sys.flags.__new__ would crash the interpreter, now it
+  raises a TypeError.
 
-- Issue #19385: Make operations on a closed dbm.dumb database always raise the
+- bpo-19385: Make operations on a closed dbm.dumb database always raise the
   same exception.
 
-- Issue #21207: Detect when the os.urandom cached fd has been closed or
+- bpo-21207: Detect when the os.urandom cached fd has been closed or
   replaced, and open it anew.
 
-- Issue #21291: subprocess's Popen.wait() is now thread safe so that
-  multiple threads may be calling wait() or poll() on a Popen instance
-  at the same time without losing the Popen.returncode value.
+- bpo-21291: subprocess's Popen.wait() is now thread safe so that multiple
+  threads may be calling wait() or poll() on a Popen instance at the same
+  time without losing the Popen.returncode value.
 
-- Issue #21127: Path objects can now be instantiated from str subclass
+- bpo-21127: Path objects can now be instantiated from str subclass
   instances (such as ``numpy.str_``).
 
-- Issue #15002: urllib.response object to use _TemporaryFileWrapper (and
+- bpo-15002: urllib.response object to use _TemporaryFileWrapper (and
   _TemporaryFileCloser) facility. Provides a better way to handle file
   descriptor close. Patch contributed by Christian Theune.
 
-- Issue #12220: mindom now raises a custom ValueError indicating it doesn't
+- bpo-12220: mindom now raises a custom ValueError indicating it doesn't
   support spaces in URIs instead of letting a 'split' ValueError bubble up.
 
-- Issue #21239: patch.stopall() didn't work deterministically when the same
+- bpo-21239: patch.stopall() didn't work deterministically when the same
   name was patched more than once.
 
-- Issue #21222: Passing name keyword argument to mock.create_autospec now
+- bpo-21222: Passing name keyword argument to mock.create_autospec now
   works.
 
-- Issue #21197: Add lib64 -> lib symlink in venvs on 64-bit non-OS X POSIX.
+- bpo-21197: Add lib64 -> lib symlink in venvs on 64-bit non-OS X POSIX.
 
-- Issue #17498: Some SMTP servers disconnect after certain errors, violating
-  strict RFC conformance.  Instead of losing the error code when we issue the
-  subsequent RSET, smtplib now returns the error code and defers raising the
-  SMTPServerDisconnected error until the next command is issued.
+- bpo-17498: Some SMTP servers disconnect after certain errors, violating
+  strict RFC conformance.  Instead of losing the error code when we issue
+  the subsequent RSET, smtplib now returns the error code and defers raising
+  the SMTPServerDisconnected error until the next command is issued.
 
-- Issue #17826: setting an iterable side_effect on a mock function created by
+- bpo-17826: setting an iterable side_effect on a mock function created by
   create_autospec now works. Patch by Kushal Das.
 
-- Issue #7776: Fix ``Host:`` header and reconnection when using
+- bpo-7776: Fix ``Host:`` header and reconnection when using
   http.client.HTTPConnection.set_tunnel(). Patch by Nikolaus Rath.
 
-- Issue #20968: unittest.mock.MagicMock now supports division.
-  Patch by Johannes Baiter.
+- bpo-20968: unittest.mock.MagicMock now supports division. Patch by
+  Johannes Baiter.
 
-- Issue #21529 (CVE-2014-4616): Fix arbitrary memory access in
-  JSONDecoder.raw_decode with a negative second parameter. Bug reported by Guido
-  Vranken.
+- bpo-21529: Fix arbitrary memory access in JSONDecoder.raw_decode with a
+  negative second parameter. Bug reported by Guido Vranken. (See also:
+  CVE-2014-4616)
 
-- Issue #21169: getpass now handles non-ascii characters that the
-  input stream encoding cannot encode by re-encoding using the
-  replace error handler.
+- bpo-21169: getpass now handles non-ascii characters that the input stream
+  encoding cannot encode by re-encoding using the replace error handler.
 
-- Issue #21171: Fixed undocumented filter API of the rot13 codec.
-  Patch by Berker Peksag.
+- bpo-21171: Fixed undocumented filter API of the rot13 codec. Patch by
+  Berker Peksag.
 
-- Issue #21172: isinstance check relaxed from dict to collections.Mapping.
+- bpo-21172: isinstance check relaxed from dict to collections.Mapping.
 
-- Issue #21155: asyncio.EventLoop.create_unix_server() now raises a ValueError
+- bpo-21155: asyncio.EventLoop.create_unix_server() now raises a ValueError
   if path and sock are specified at the same time.
 
-- Issue #21149: Improved thread-safety in logging cleanup during interpreter
+- bpo-21149: Improved thread-safety in logging cleanup during interpreter
   shutdown. Thanks to Devin Jeanpierre for the patch.
 
-- Issue #20145: `assertRaisesRegex` and `assertWarnsRegex` now raise a
+- bpo-20145: `assertRaisesRegex` and `assertWarnsRegex` now raise a
   TypeError if the second argument is not a string or compiled regex.
 
-- Issue #21058: Fix a leak of file descriptor in
+- bpo-21058: Fix a leak of file descriptor in
   :func:`tempfile.NamedTemporaryFile`, close the file descriptor if
   :func:`io.open` fails
 
-- Issue #21200: Return None from pkgutil.get_loader() when __spec__ is missing.
+- bpo-21200: Return None from pkgutil.get_loader() when __spec__ is missing.
 
-- Issue #21013: Enhance ssl.create_default_context() when used for server side
+- bpo-21013: Enhance ssl.create_default_context() when used for server side
   sockets to provide better security by default.
 
-- Issue #20633: Replace relative import by absolute import.
+- bpo-20633: Replace relative import by absolute import.
 
-- Issue #20980: Stop wrapping exception when using ThreadPool.
+- bpo-20980: Stop wrapping exception when using ThreadPool.
 
-- Issue #21082: In os.makedirs, do not set the process-wide umask. Note this
+- bpo-21082: In os.makedirs, do not set the process-wide umask. Note this
   changes behavior of makedirs when exist_ok=True.
 
-- Issue #20990: Fix issues found by pyflakes for multiprocessing.
+- bpo-20990: Fix issues found by pyflakes for multiprocessing.
 
-- Issue #21015: SSL contexts will now automatically select an elliptic
-  curve for ECDH key exchange on OpenSSL 1.0.2 and later, and otherwise
-  default to "prime256v1".
+- bpo-21015: SSL contexts will now automatically select an elliptic curve
+  for ECDH key exchange on OpenSSL 1.0.2 and later, and otherwise default to
+  "prime256v1".
 
-- Issue #20995: Enhance default ciphers used by the ssl module to enable
-  better security an prioritize perfect forward secrecy.
+- bpo-20995: Enhance default ciphers used by the ssl module to enable better
+  security an prioritize perfect forward secrecy.
 
-- Issue #20884: Don't assume that __file__ is defined on importlib.__init__.
+- bpo-20884: Don't assume that __file__ is defined on importlib.__init__.
 
-- Issue #21499: Ignore __builtins__ in several test_importlib.test_api tests.
+- bpo-21499: Ignore __builtins__ in several test_importlib.test_api tests.
 
-- Issue #20879: Delay the initialization of encoding and decoding tables for
+- bpo-20879: Delay the initialization of encoding and decoding tables for
   base32, ascii85 and base85 codecs in the base64 module, and delay the
-  initialization of the unquote_to_bytes() table of the urllib.parse module, to
-  not waste memory if these modules are not used.
+  initialization of the unquote_to_bytes() table of the urllib.parse module,
+  to not waste memory if these modules are not used.
 
-- Issue #19157: Include the broadcast address in the usuable hosts for IPv6
-  in ipaddress.
+- bpo-19157: Include the broadcast address in the usuable hosts for IPv6 in
+  ipaddress.
 
-- Issue #11599: When an external command (e.g. compiler) fails, distutils now
-  prints out the whole command line (instead of just the command name) if the
-  environment variable DISTUTILS_DEBUG is set.
+- bpo-11599: When an external command (e.g. compiler) fails, distutils now
+  prints out the whole command line (instead of just the command name) if
+  the environment variable DISTUTILS_DEBUG is set.
 
-- Issue #4931: distutils should not produce unhelpful "error: None" messages
-  anymore.  distutils.util.grok_environment_error is kept but doc-deprecated.
+- bpo-4931: distutils should not produce unhelpful "error: None" messages
+  anymore. distutils.util.grok_environment_error is kept but doc-deprecated.
 
-- Issue #20875: Prevent possible gzip "'read' is not defined" NameError.
-  Patch by Claudiu Popa.
+- bpo-20875: Prevent possible gzip "'read' is not defined" NameError. Patch
+  by Claudiu Popa.
 
-- Issue #11558: ``email.message.Message.attach`` now returns a more
-  useful error message if ``attach`` is called on a message for which
+- bpo-11558: ``email.message.Message.attach`` now returns a more useful
+  error message if ``attach`` is called on a message for which
   ``is_multipart`` is False.
 
-- Issue #20283: RE pattern methods now accept the string keyword parameters
-  as documented.  The pattern and source keyword parameters are left as
+- bpo-20283: RE pattern methods now accept the string keyword parameters as
+  documented. The pattern and source keyword parameters are left as
   deprecated aliases.
 
-- Issue #20778: Fix modulefinder to work with bytecode-only modules.
+- bpo-20778: Fix modulefinder to work with bytecode-only modules.
 
-- Issue #20791: copy.copy() now doesn't make a copy when the input is
-  a bytes object.  Initial patch by Peter Otten.
+- bpo-20791: copy.copy() now doesn't make a copy when the input is a bytes
+  object. Initial patch by Peter Otten.
 
-- Issue #19748: On AIX, time.mktime() now raises an OverflowError for year
+- bpo-19748: On AIX, time.mktime() now raises an OverflowError for year
   outsize range [1902; 2037].
 
-- Issue #20816: Fix inspect.getcallargs() to raise correct TypeError for
-  missing keyword-only arguments. Patch by Jeremiah Lowin.
-
-- Issue #20817: Fix inspect.getcallargs() to fail correctly if more
-  than 3 arguments are missing. Patch by Jeremiah Lowin.
+- bpo-20816: Fix inspect.getcallargs() to raise correct TypeError for
+  missing keyword- only arguments. Patch by Jeremiah Lowin.
 
-- Issue #6676: Ensure a meaningful exception is raised when attempting
-  to parse more than one XML document per pyexpat xmlparser instance.
-  (Original patches by Hirokazu Yamamoto and Amaury Forgeot d'Arc, with
-  suggested wording by David Gutteridge)
+- bpo-20817: Fix inspect.getcallargs() to fail correctly if more than 3
+  arguments are missing. Patch by Jeremiah Lowin.
 
-- Issue #21117: Fix inspect.signature to better support functools.partial.
-  Due to the specifics of functools.partial implementation,
-  positional-or-keyword arguments passed as keyword arguments become
-  keyword-only.
+- bpo-6676: Ensure a meaningful exception is raised when attempting to parse
+  more than one XML document per pyexpat xmlparser instance. (Original
+  patches by Hirokazu Yamamoto and Amaury Forgeot d'Arc, with suggested
+  wording by David Gutteridge)
 
-- Issue #21209: Fix asyncio.tasks.CoroWrapper to workaround a bug
-  in yield-from implementation in CPythons prior to 3.4.1.
+- bpo-21117: Fix inspect.signature to better support functools.partial. Due
+  to the specifics of functools.partial implementation, positional-or-
+  keyword arguments passed as keyword arguments become keyword-only.
 
-- asyncio: Add gi_{frame,running,code} properties to CoroWrapper
-  (upstream issue #163).
+- bpo-21209: Fix asyncio.tasks.CoroWrapper to workaround a bug in yield-from
+  implementation in CPythons prior to 3.4.1.
 
-- Issue #21311: Avoid exception in _osx_support with non-standard compiler
-  configurations.  Patch by John Szakmeister.
+- asyncio: Add gi_{frame,running,code} properties to CoroWrapper (upstream
+  issue #163).
 
-- Issue #11571: Ensure that the turtle window becomes the topmost window
-  when launched on OS X.
+- bpo-21311: Avoid exception in _osx_support with non-standard compiler
+  configurations. Patch by John Szakmeister.
 
-Extension Modules
------------------
+- bpo-11571: Ensure that the turtle window becomes the topmost window when
+  launched on OS X.
 
-- Issue #21276: posixmodule: Don't define USE_XATTRS on KFreeBSD and the Hurd.
+- bpo-21276: posixmodule: Don't define USE_XATTRS on KFreeBSD and the Hurd.
 
-- Issue #21226: Set up modules properly in PyImport_ExecCodeModuleObject
-  (and friends).
+- bpo-21226: Set up modules properly in PyImport_ExecCodeModuleObject (and
+  friends).
 
 IDLE
 ----
 
-- Issue #21139: Change default paragraph width to 72, the PEP 8 recommendation.
+- bpo-21139: Change default paragraph width to 72, the PEP 8 recommendation.
 
-- Issue #21284: Paragraph reformat test passes after user changes reformat width.
+- bpo-21284: Paragraph reformat test passes after user changes reformat
+  width.
 
-- Issue #17654: Ensure IDLE menus are customized properly on OS X for
-  non-framework builds and for all variants of Tk.
+- bpo-17654: Ensure IDLE menus are customized properly on OS X for non-
+  framework builds and for all variants of Tk.
 
 Build
 -----
 
 - The Windows build now includes OpenSSL 1.0.1g
 
-- Issue #21285: Refactor and fix curses configure check to always search
-  in a ncursesw directory.
+- bpo-21285: Refactor and fix curses configure check to always search in a
+  ncursesw directory.
 
-- Issue #15234: For BerkelyDB and Sqlite, only add the found library and
-  include directories if they aren't already being searched. This avoids
-  an explicit runtime library dependency.
+- bpo-15234: For BerkelyDB and Sqlite, only add the found library and
+  include directories if they aren't already being searched. This avoids an
+  explicit runtime library dependency.
 
-- Issue #20644: OS X installer build support for documentation build changes
-  in 3.4.1: assume externally supplied sphinx-build is available in /usr/bin.
+- bpo-20644: OS X installer build support for documentation build changes in
+  3.4.1: assume externally supplied sphinx-build is available in /usr/bin.
 
 C API
 -----
 
-- Issue #20942: PyImport_ImportFrozenModuleObject() no longer sets __file__ to
+- bpo-20942: PyImport_ImportFrozenModuleObject() no longer sets __file__ to
   match what importlib does; this affects _frozen_importlib as well as any
   module loaded using imp.init_frozen().
 
 Documentation
 -------------
 
-- Issue #17386: Expanded functionality of the ``Doc/make.bat`` script to make
+- bpo-17386: Expanded functionality of the ``Doc/make.bat`` script to make
   it much more comparable to ``Doc/Makefile``.
 
-- Issue #21043: Remove the recommendation for specific CA organizations and to
+- bpo-21043: Remove the recommendation for specific CA organizations and to
   mention the ability to load the OS certificates.
 
-- Issue #20765: Add missing documentation for PurePath.with_name() and
+- bpo-20765: Add missing documentation for PurePath.with_name() and
   PurePath.with_suffix().
 
-- Issue #19407: New package installation and distribution guides based on
-  the Python Packaging Authority tools. Existing guides have been retained
-  as legacy links from the distutils docs, as they still contain some
-  required reference material for tool developers that isn't recorded
-  anywhere else.
+- bpo-19407: New package installation and distribution guides based on the
+  Python Packaging Authority tools. Existing guides have been retained as
+  legacy links from the distutils docs, as they still contain some required
+  reference material for tool developers that isn't recorded anywhere else.
 
-- Issue #19697: Document cases where __main__.__spec__ is None.
+- bpo-19697: Document cases where __main__.__spec__ is None.
 
 Tests
 -----
 
-- Issue #18604: Consolidated checks for GUI availability.  All platforms now
-  at least check whether Tk can be instantiated when the GUI resource is
+- bpo-18604: Consolidated checks for GUI availability.  All platforms now at
+  least check whether Tk can be instantiated when the GUI resource is
   requested.
 
-- Issue #21275: Fix a socket test on KFreeBSD.
+- bpo-21275: Fix a socket test on KFreeBSD.
 
-- Issue #21223: Pass test_site/test_startup_imports when some of the extensions
+- bpo-21223: Pass test_site/test_startup_imports when some of the extensions
   are built as builtins.
 
-- Issue #20635: Added tests for Tk geometry managers.
+- bpo-20635: Added tests for Tk geometry managers.
 
 - Add test case for freeze.
 
-- Issue #20743: Fix a reference leak in test_tcl.
+- bpo-20743: Fix a reference leak in test_tcl.
 
-- Issue #21097: Move test_namespace_pkgs into test_importlib.
+- bpo-21097: Move test_namespace_pkgs into test_importlib.
 
-- Issue #20939: Avoid various network test failures due to new
-  redirect of http://www.python.org/ to https://www.python.org:
-  use http://www.example.com instead.
+- bpo-20939: Avoid various network test failures due to new redirect of
+  http://www.python.org/ to https://www.python.org: use
+  http://www.example.com instead.
 
-- Issue #20668: asyncio tests no longer rely on tests.txt file.
-  (Patch by Vajrasky Kok)
+- bpo-20668: asyncio tests no longer rely on tests.txt file. (Patch by
+  Vajrasky Kok)
 
-- Issue #21093: Prevent failures of ctypes test_macholib on OS X if a
-  copy of libz exists in $HOME/lib or /usr/local/lib.
+- bpo-21093: Prevent failures of ctypes test_macholib on OS X if a copy of
+  libz exists in $HOME/lib or /usr/local/lib.
 
 Tools/Demos
 -----------
@@ -2179,25 +2260,25 @@ Tools/Demos
 
 - Add support for the PEP 465 matrix multiplication operator to 2to3.
 
-- Issue #16047: Fix module exception list and __file__ handling in freeze.
+- bpo-16047: Fix module exception list and __file__ handling in freeze.
   Patch by Meador Inge.
 
-- Issue #11824: Consider ABI tags in freeze. Patch by Meador Inge.
+- bpo-11824: Consider ABI tags in freeze. Patch by Meador Inge.
 
-- Issue #20535: PYTHONWARNING no longer affects the run_tests.py script.
-  Patch by Arfrever Frehtes Taifersar Arahesis.
+- bpo-20535: PYTHONWARNING no longer affects the run_tests.py script. Patch
+  by Arfrever Frehtes Taifersar Arahesis.
 
 
-What's New in Python 3.4.0?
-===========================
+What's New in Python 3.4.0 final?
+=================================
 
-Release date: 2014-03-16
+*Release date: 2014-03-16*
 
 Library
 -------
 
-- Issue #20939: Fix test_geturl failure in test_urllibnet due to
-  new redirect of http://www.python.org/ to https://www.python.org.
+- bpo-20939: Fix test_geturl failure in test_urllibnet due to new redirect
+  of http://www.python.org/ to https://www.python.org.
 
 Documentation
 -------------
@@ -2208,1002 +2289,1005 @@ Documentation
 What's New in Python 3.4.0 release candidate 3?
 ===============================================
 
-Release date: 2014-03-09
+*Release date: 2014-03-09*
 
 Core and Builtins
 -----------------
 
-- Issue #20786: Fix signatures for dict.__delitem__ and
-  property.__delete__ builtins.
+- bpo-20786: Fix signatures for dict.__delitem__ and property.__delete__
+  builtins.
 
 Library
 -------
 
-- Issue #20839: Don't trigger a DeprecationWarning in the still supported
-  pkgutil.get_loader() API when __loader__ isn't set on a module (nor
-  when pkgutil.find_loader() is called directly).
+- bpo-20839: Don't trigger a DeprecationWarning in the still supported
+  pkgutil.get_loader() API when __loader__ isn't set on a module (nor when
+  pkgutil.find_loader() is called directly).
 
 Build
 -----
 
-- Issue #14512: Launch pydoc -b instead of pydocgui.pyw on Windows.
+- bpo-14512: Launch pydoc -b instead of pydocgui.pyw on Windows.
 
-- Issue #20748: Uninstalling pip does not leave behind the pyc of
-  the uninstaller anymore.
+- bpo-20748: Uninstalling pip does not leave behind the pyc of the
+  uninstaller anymore.
 
-- Issue #20568: The Windows installer now installs the unversioned ``pip``
+- bpo-20568: The Windows installer now installs the unversioned ``pip``
   command in addition to the versioned ``pip3`` and ``pip3.4`` commands.
 
-- Issue #20757: The ensurepip helper for the Windows uninstaller now skips
+- bpo-20757: The ensurepip helper for the Windows uninstaller now skips
   uninstalling pip (rather than failing) if the user has updated pip to a
   different version from the one bundled with ensurepip.
 
-- Issue #20465: Update OS X and Windows installer builds to use
-  SQLite 3.8.3.1.
+- bpo-20465: Update OS X and Windows installer builds to use SQLite 3.8.3.1.
 
 
 What's New in Python 3.4.0 release candidate 2?
 ===============================================
 
-Release date: 2014-02-23
+*Release date: 2014-02-23*
 
 Core and Builtins
 -----------------
 
-- Issue #20625: Parameter names in __annotations__ were not mangled properly.
+- bpo-20625: Parameter names in __annotations__ were not mangled properly.
   Discovered by Jonas Wielicki, patch by Yury Selivanov.
 
-- Issue #20261: In pickle, lookup __getnewargs__ and __getnewargs_ex__ on the
+- bpo-20261: In pickle, lookup __getnewargs__ and __getnewargs_ex__ on the
   type of the object.
 
-- Issue #20619: Give the AST nodes of keyword-only arguments a column and line
+- bpo-20619: Give the AST nodes of keyword-only arguments a column and line
   number.
 
-- Issue #20526: Revert changes of issue #19466 which introduces a regression:
+- bpo-20526: Revert changes of issue #19466 which introduces a regression:
   don't clear anymore the state of Python threads early during the Python
   shutdown.
 
 Library
 -------
 
-- Issue #20710: The pydoc summary line no longer displays the "self" parameter
+- bpo-20710: The pydoc summary line no longer displays the "self" parameter
   for bound methods.
 
-- Issue #20566: Change asyncio.as_completed() to use a Queue, to
-  avoid O(N**2) behavior.
+- bpo-20566: Change asyncio.as_completed() to use a Queue, to avoid O(N**2)
+  behavior.
 
-- Issue #20704: Implement new debug API in asyncio. Add new methods
-  BaseEventLoop.set_debug() and BaseEventLoop.get_debug().
-  Add support for setting 'asyncio.tasks._DEBUG' variable with
-  'PYTHONASYNCIODEBUG' environment variable.
+- bpo-20704: Implement new debug API in asyncio. Add new methods
+  BaseEventLoop.set_debug() and BaseEventLoop.get_debug(). Add support for
+  setting 'asyncio.tasks._DEBUG' variable with 'PYTHONASYNCIODEBUG'
+  environment variable.
 
 - asyncio: Refactoring and fixes: BaseEventLoop.sock_connect() raises an
   error if the address is not resolved; use __slots__ in Handle and
-  TimerHandle; as_completed() and wait() raise TypeError if the passed
-  list of Futures is a single Future; call_soon() and other 'call_*()'
-  functions raise TypeError if the passed callback is a coroutine
-  function; _ProactorBasePipeTransport uses _FlowControlMixin;
-  WriteTransport.set_write_buffer_size() calls _maybe_pause_protocol()
-  to consider pausing receiving if the watermark limits have changed;
-  fix _check_resolved_address() for IPv6 address; and other minor
-  improvements, along with multiple documentation updates.
-
-- Issue #20684: Fix inspect.getfullargspec() to not to follow __wrapped__
+  TimerHandle; as_completed() and wait() raise TypeError if the passed list
+  of Futures is a single Future; call_soon() and other 'call_*()' functions
+  raise TypeError if the passed callback is a coroutine function;
+  _ProactorBasePipeTransport uses _FlowControlMixin;
+  WriteTransport.set_write_buffer_size() calls _maybe_pause_protocol() to
+  consider pausing receiving if the watermark limits have changed; fix
+  _check_resolved_address() for IPv6 address; and other minor improvements,
+  along with multiple documentation updates.
+
+- bpo-20684: Fix inspect.getfullargspec() to not to follow __wrapped__
   chains. Make its behaviour consistent with bound methods first argument.
   Patch by Nick Coghlan and Yury Selivanov.
 
-- Issue #20681: Add new error handling API in asyncio. New APIs:
+- bpo-20681: Add new error handling API in asyncio. New APIs:
   loop.set_exception_handler(), loop.default_exception_handler(), and
   loop.call_exception_handler().
 
-- Issue #20673: Implement support for UNIX Domain Sockets in asyncio.
-  New APIs: loop.create_unix_connection(), loop.create_unix_server(),
+- bpo-20673: Implement support for UNIX Domain Sockets in asyncio. New APIs:
+  loop.create_unix_connection(), loop.create_unix_server(),
   streams.open_unix_connection(), and streams.start_unix_server().
 
-- Issue #20616: Add a format() method to tracemalloc.Traceback.
+- bpo-20616: Add a format() method to tracemalloc.Traceback.
 
-- Issue #19744: the ensurepip installation step now just prints a warning to
+- bpo-19744: the ensurepip installation step now just prints a warning to
   stderr rather than failing outright if SSL/TLS is unavailable. This allows
   local installation of POSIX builds without SSL/TLS support.
 
-- Issue #20594: Avoid name clash with the libc function posix_close.
+- bpo-20594: Avoid name clash with the libc function posix_close.
 
 Build
 -----
 
-- Issue #20641: Run MSI custom actions (pip installation, pyc compilation)
-  with the NoImpersonate flag, to support elevated execution (UAC).
+- bpo-20641: Run MSI custom actions (pip installation, pyc compilation) with
+  the NoImpersonate flag, to support elevated execution (UAC).
 
-- Issue #20221: Removed conflicting (or circular) hypot definition when
+- bpo-20221: Removed conflicting (or circular) hypot definition when
   compiled with VS 2010 or above.  Initial patch by Tabrez Mohammed.
 
-- Issue #20609: Restored the ability to build 64-bit Windows binaries on
-  32-bit Windows, which was broken by the change in issue #19788.
+- bpo-20609: Restored the ability to build 64-bit Windows binaries on 32-bit
+  Windows, which was broken by the change in issue #19788.
 
 
 What's New in Python 3.4.0 release candidate 1?
 ===============================================
 
-Release date: 2014-02-10
+*Release date: 2014-02-10*
 
 Core and Builtins
 -----------------
 
-- Issue #19255: The builtins module is restored to initial value before
+- bpo-19255: The builtins module is restored to initial value before
   cleaning other modules.  The sys and builtins modules are cleaned last.
 
-- Issue #20588: Make Python-ast.c C89 compliant.
+- bpo-20588: Make Python-ast.c C89 compliant.
 
-- Issue #20437: Fixed 22 potential bugs when deleting objects references.
+- bpo-20437: Fixed 22 potential bugs when deleting objects references.
 
-- Issue #20500: Displaying an exception at interpreter shutdown no longer
-  risks triggering an assertion failure in PyObject_Str.
+- bpo-20500: Displaying an exception at interpreter shutdown no longer risks
+  triggering an assertion failure in PyObject_Str.
 
-- Issue #20538: UTF-7 incremental decoder produced inconsistent string when
+- bpo-20538: UTF-7 incremental decoder produced inconsistent string when
   input was truncated in BASE64 section.
 
-- Issue #20404: io.TextIOWrapper (and hence the open() builtin) now uses the
+- bpo-20404: io.TextIOWrapper (and hence the open() builtin) now uses the
   internal codec marking system added for issue #19619 to throw LookupError
-  for known non-text encodings at stream construction time. The existing
+  for known non- text encodings at stream construction time. The existing
   output type checks remain in place to deal with unmarked third party
   codecs.
 
-- Issue #17162: Add PyType_GetSlot.
+- bpo-17162: Add PyType_GetSlot.
 
-- Issue #20162: Fix an alignment issue in the siphash24() hash function which
+- bpo-20162: Fix an alignment issue in the siphash24() hash function which
   caused a crash on PowerPC 64-bit (ppc64).
 
 Library
 -------
 
-- Issue #20530: The signatures for slot builtins have been updated
-  to reflect the fact that they only accept positional-only arguments.
+- bpo-20530: The signatures for slot builtins have been updated to reflect
+  the fact that they only accept positional-only arguments.
 
-- Issue #20517: Functions in the os module that accept two filenames
-  now register both filenames in the exception on failure.
+- bpo-20517: Functions in the os module that accept two filenames now
+  register both filenames in the exception on failure.
 
-- Issue #20563: The ipaddress module API is now considered stable.
+- bpo-20563: The ipaddress module API is now considered stable.
 
-- Issue #14983: email.generator now always adds a line end after each MIME
+- bpo-14983: email.generator now always adds a line end after each MIME
   boundary marker, instead of doing so only when there is an epilogue.  This
   fixes an RFC compliance bug and solves an issue with signed MIME parts.
 
-- Issue #20540: Fix a performance regression (vs. Python 3.2) when layering
-  multiprocessing Connection over a TCP socket.  For small payloads, Nagle's
+- bpo-20540: Fix a performance regression (vs. Python 3.2) when layering a
+  multiprocessing Connection over a TCP socket.  For small payloads, Nagle's
   algorithm would introduce idle delays before the entire transmission of a
   message.
 
-- Issue #16983: the new email header parsing code will now decode encoded words
+- bpo-16983: the new email header parsing code will now decode encoded words
   that are (incorrectly) surrounded by quotes, and register a defect.
 
-- Issue #19772: email.generator no longer mutates the message object when
-  doing a down-transform from 8bit to 7bit CTEs.
+- bpo-19772: email.generator no longer mutates the message object when doing
+  a down- transform from 8bit to 7bit CTEs.
 
-- Issue #20536: the statistics module now correctly handle Decimal instances
+- bpo-20536: the statistics module now correctly handle Decimal instances
   with positive exponents
 
-- Issue #18805: the netmask/hostmask parsing in ipaddress now more reliably
+- bpo-18805: the netmask/hostmask parsing in ipaddress now more reliably
   filters out illegal values and correctly allows any valid prefix length.
 
-- Issue #20481: For at least Python 3.4, the statistics module will require
+- bpo-20481: For at least Python 3.4, the statistics module will require
   that all inputs for a single operation be of a single consistent type, or
-  else a mixed of ints and a single other consistent type. This avoids
-  some interoperability issues that arose with the previous approach of
-  coercing to a suitable common type.
+  else a mixed of ints and a single other consistent type. This avoids some
+  interoperability issues that arose with the previous approach of coercing
+  to a suitable common type.
 
-- Issue #20478: the statistics module now treats collections.Counter inputs
+- bpo-20478: the statistics module now treats collections.Counter inputs
   like any other iterable.
 
-- Issue #17369: get_filename was raising an exception if the filename
-  parameter's RFC2231 encoding was broken in certain ways.  This was
-  regression relative to python2.
+- bpo-17369: get_filename was raising an exception if the filename
+  parameter's RFC2231 encoding was broken in certain ways.  This was a
+  regression relative to python2.
 
-- Issue #20013: Some imap servers disconnect if the current mailbox is
-  deleted, and imaplib did not handle that case gracefully.  Now it
-  handles the 'bye' correctly.
+- bpo-20013: Some imap servers disconnect if the current mailbox is deleted,
+  and imaplib did not handle that case gracefully.  Now it handles the 'bye'
+  correctly.
 
-- Issue #20531: Revert 3.4 version of fix for #19063, and apply the 3.3
+- bpo-20531: Revert 3.4 version of fix for #19063, and apply the 3.3
   version.  That is, do *not* raise an error if unicode is passed to
   email.message.Message.set_payload.
 
-- Issue #20476: If a non-compat32 policy is used with any of the email parsers,
+- bpo-20476: If a non-compat32 policy is used with any of the email parsers,
   EmailMessage is now used as the factory class.  The factory class should
   really come from the policy; that will get fixed in 3.5.
 
-- Issue #19920: TarFile.list() no longer fails when outputs a listing
-  containing non-encodable characters.  Based on patch by Vajrasky Kok.
+- bpo-19920: TarFile.list() no longer fails when outputs a listing
+  containing non- encodable characters.  Based on patch by Vajrasky Kok.
 
-- Issue #20515: Fix NULL pointer dereference introduced by issue #20368.
+- bpo-20515: Fix NULL pointer dereference introduced by issue #20368.
 
-- Issue #19186: Restore namespacing of expat symbols inside the pyexpat module.
+- bpo-19186: Restore namespacing of expat symbols inside the pyexpat module.
 
-- Issue #20053: ensurepip (and hence venv) are no longer affected by the
+- bpo-20053: ensurepip (and hence venv) are no longer affected by the
   settings in the default pip configuration file.
 
-- Issue #20426: When passing the re.DEBUG flag, re.compile() displays the
-  debug output every time it is called, regardless of the compilation cache.
+- bpo-20426: When passing the re.DEBUG flag, re.compile() displays the debug
+  output every time it is called, regardless of the compilation cache.
 
-- Issue #20368: The null character now correctly passed from Tcl to Python.
+- bpo-20368: The null character now correctly passed from Tcl to Python.
   Improved error handling in variables-related commands.
 
-- Issue #20435: Fix _pyio.StringIO.getvalue() to take into account newline
+- bpo-20435: Fix _pyio.StringIO.getvalue() to take into account newline
   translation settings.
 
 - tracemalloc: Fix slicing traces and fix slicing a traceback.
 
-- Issue #20354: Fix an alignment issue in the tracemalloc module on 64-bit
+- bpo-20354: Fix an alignment issue in the tracemalloc module on 64-bit
   platforms. Bug seen on 64-bit Linux when using "make profile-opt".
 
-- Issue #17159: inspect.signature now accepts duck types of functions,
-  which adds support for Cython functions. Initial patch by Stefan Behnel.
+- bpo-17159: inspect.signature now accepts duck types of functions, which
+  adds support for Cython functions. Initial patch by Stefan Behnel.
 
-- Issue #18801: Fix inspect.classify_class_attrs to correctly classify
+- bpo-18801: Fix inspect.classify_class_attrs to correctly classify
   object.__new__ and object.__init__.
 
 - Fixed cmath.isinf's name in its argument parsing code.
 
-- Issue #20311, #20452: poll and epoll now round the timeout away from zero,
-  instead of rounding towards zero, in select and selectors modules:
+- bpo-20311: poll and epoll now round the timeout away from zero, instead of
+  rounding towards zero, in select and selectors modules:
   select.epoll.poll(), selectors.PollSelector.poll() and
   selectors.EpollSelector.poll(). For example, a timeout of one microsecond
-  (1e-6) is now rounded to one millisecondi (1e-3), instead of being rounded to
-  zero.  However, the granularity property and asyncio's resolution feature
-  were removed again.
+  (1e-6) is now rounded to one millisecondi (1e-3), instead of being rounded
+  to zero.  However, the granularity property and asyncio's resolution
+  feature were removed again. (See also: bpo-20452)
 
-- asyncio: Some refactoring; various fixes; add write flow control to
-  unix pipes; Future.set_exception() instantiates the exception
-  argument if it is a class; improved proactor pipe transport; support
-  wait_for(f, None); don't log broken/disconnected pipes; use
-  ValueError instead of assert for forbidden subprocess_{shell,exec}
-  arguments; added a convenience API for subprocess management; added
-  StreamReader.at_eof(); properly handle duplicate coroutines/futures
-  in gather(), wait(), as_completed(); use a bytearray for buffering
-  in StreamReader; and more.
+- asyncio: Some refactoring; various fixes; add write flow control to unix
+  pipes; Future.set_exception() instantiates the exception argument if it is
+  a class; improved proactor pipe transport; support wait_for(f, None);
+  don't log broken/disconnected pipes; use ValueError instead of assert for
+  forbidden subprocess_{shell,exec} arguments; added a convenience API for
+  subprocess management; added StreamReader.at_eof(); properly handle
+  duplicate coroutines/futures in gather(), wait(), as_completed(); use a
+  bytearray for buffering in StreamReader; and more.
 
-- Issue #20288: fix handling of invalid numeric charrefs in HTMLParser.
+- bpo-20288: fix handling of invalid numeric charrefs in HTMLParser.
 
-- Issue #20424: Python implementation of io.StringIO now supports lone surrogates.
+- bpo-20424: Python implementation of io.StringIO now supports lone
+  surrogates.
 
-- Issue #20308: inspect.signature now works on classes without user-defined
+- bpo-20308: inspect.signature now works on classes without user-defined
   __init__ or __new__ methods.
 
-- Issue #20372: inspect.getfile (and a bunch of other inspect functions that
-  use it) doesn't crash with unexpected AttributeError on classes defined in C
-  without __module__.
+- bpo-20372: inspect.getfile (and a bunch of other inspect functions that
+  use it) doesn't crash with unexpected AttributeError on classes defined in
+  without __module__.
 
-- Issue #20356: inspect.signature formatting uses '/' to separate
-  positional-only parameters from others.
+- bpo-20356: inspect.signature formatting uses '/' to separate positional-
+  only parameters from others.
 
-- Issue #20223: inspect.signature now supports methods defined with
+- bpo-20223: inspect.signature now supports methods defined with
   functools.partialmethods.
 
-- Issue #19456: ntpath.join() now joins relative paths correctly when a drive
+- bpo-19456: ntpath.join() now joins relative paths correctly when a drive
   is present.
 
-- Issue #19077: tempfile.TemporaryDirectory cleanup no longer fails when
-  called during shutdown.  Emitting resource warning in __del__ no longer fails.
+- bpo-19077: tempfile.TemporaryDirectory cleanup no longer fails when called
+  during shutdown.  Emitting resource warning in __del__ no longer fails.
   Original patch by Antoine Pitrou.
 
-- Issue #20394: Silence Coverity warning in audioop module.
+- bpo-20394: Silence Coverity warning in audioop module.
 
-- Issue #20367: Fix behavior of concurrent.futures.as_completed() for
-  duplicate arguments.  Patch by Glenn Langford.
+- bpo-20367: Fix behavior of concurrent.futures.as_completed() for duplicate
+  arguments. Patch by Glenn Langford.
 
-- Issue #8260: The read(), readline() and readlines() methods of
+- bpo-8260: The read(), readline() and readlines() methods of
   codecs.StreamReader returned incomplete data when were called after
-  readline() or read(size).  Based on patch by Amaury Forgeot d'Arc.
+  readline() or read(size). Based on patch by Amaury Forgeot d'Arc.
 
-- Issue #20105: the codec exception chaining now correctly sets the
-  traceback of the original exception as its __traceback__ attribute.
+- bpo-20105: the codec exception chaining now correctly sets the traceback
+  of the original exception as its __traceback__ attribute.
 
-- Issue #17481: inspect.getfullargspec() now uses inspect.signature() API.
+- bpo-17481: inspect.getfullargspec() now uses inspect.signature() API.
 
-- Issue #15304: concurrent.futures.wait() can block forever even if
-  Futures have completed. Patch by Glenn Langford.
+- bpo-15304: concurrent.futures.wait() can block forever even if Futures
+  have completed. Patch by Glenn Langford.
 
-- Issue #14455: plistlib: fix serializing integers in the range
-  of an unsigned long long but outside of the range of signed long long for
-  binary plist files.
+- bpo-14455: plistlib: fix serializing integers in the range of an unsigned
+  long long but outside of the range of signed long long for binary plist
+  files.
 
 IDLE
 ----
 
-- Issue #20406: Use Python application icons for Idle window title bars.
-  Patch mostly by Serhiy Storchaka.
+- bpo-20406: Use Python application icons for Idle window title bars. Patch
+  mostly by Serhiy Storchaka.
 
-- Update the python.gif icon for the Idle classbrowser and pathbowser
-  from the old green snake to the new blue and yellow snakes.
+- Update the python.gif icon for the Idle classbrowser and pathbowser from
+  the old green snake to the new blue and yellow snakes.
 
-- Issue #17721: Remove non-functional configuration dialog help button until we
+- bpo-17721: Remove non-functional configuration dialog help button until we
   make it actually gives some help when clicked. Patch by Guilherme Simões.
 
 Tests
 -----
 
-- Issue #20532: Tests which use _testcapi now are marked as CPython only.
+- bpo-20532: Tests which use _testcapi now are marked as CPython only.
 
-- Issue #19920: Added tests for TarFile.list().  Based on patch by Vajrasky Kok.
+- bpo-19920: Added tests for TarFile.list().  Based on patch by Vajrasky
+  Kok.
 
-- Issue #19990: Added tests for the imghdr module.  Based on patch by
-  Claudiu Popa.
+- bpo-19990: Added tests for the imghdr module.  Based on patch by Claudiu
+  Popa.
 
-- Issue #20474: Fix test_socket "unexpected success" failures on OS X 10.7+.
+- bpo-20474: Fix test_socket "unexpected success" failures on OS X 10.7+.
 
 Tools/Demos
 -----------
 
-- Issue #20530: Argument Clinic's signature format has been revised again.
-  The new syntax is highly human readable while still preventing false
+- bpo-20530: Argument Clinic's signature format has been revised again. The
+  new syntax is highly human readable while still preventing false
   positives.  The syntax also extends Python syntax to denote "self" and
   positional-only parameters, allowing inspect.Signature objects to be
   totally accurate for all supported builtins in Python 3.4.
 
-- Issue #20456: Argument Clinic now observes the C preprocessor conditional
+- bpo-20456: Argument Clinic now observes the C preprocessor conditional
   compilation statements of the C files it parses.  When a Clinic block is
   inside a conditional code, it adjusts its output to match, including
   automatically generating an empty methoddef macro.
 
-- Issue #20456: Cloned functions in Argument Clinic now use the correct
-  name, not the name of the function they were cloned from, for text
-  strings inside generated code.
+- bpo-20456: Cloned functions in Argument Clinic now use the correct name,
+  not the name of the function they were cloned from, for text strings
+  inside generated code.
 
-- Issue #20456: Fixed Argument Clinic's test suite and "--converters" feature.
+- bpo-20456: Fixed Argument Clinic's test suite and "--converters" feature.
 
-- Issue #20456: Argument Clinic now allows specifying different names
-  for a parameter in Python and C, using "as" on the parameter line.
+- bpo-20456: Argument Clinic now allows specifying different names for a
+  parameter in Python and C, using "as" on the parameter line.
 
-- Issue #20326: Argument Clinic now uses a simple, unique signature to
-  annotate text signatures in docstrings, resulting in fewer false
-  positives.  "self" parameters are also explicitly marked, allowing
-  inspect.Signature() to authoritatively detect (and skip) said parameters.
+- bpo-20326: Argument Clinic now uses a simple, unique signature to annotate
+  text signatures in docstrings, resulting in fewer false positives.  "self"
+  parameters are also explicitly marked, allowing inspect.Signature() to
+  authoritatively detect (and skip) said parameters.
 
-- Issue #20326: Argument Clinic now generates separate checksums for the
-  input and output sections of the block, allowing external tools to verify
-  that the input has not changed (and thus the output is not out-of-date).
+- bpo-20326: Argument Clinic now generates separate checksums for the input
+  and output sections of the block, allowing external tools to verify that
+  the input has not changed (and thus the output is not out-of-date).
 
 Build
 -----
 
-- Issue #20465: Update SQLite shipped with OS X installer to 3.8.3.
+- bpo-20465: Update SQLite shipped with OS X installer to 3.8.3.
 
-C-API
+C API
 -----
 
-- Issue #20517: Added new functions allowing OSError exceptions to reference
+- bpo-20517: Added new functions allowing OSError exceptions to reference
   two filenames instead of one: PyErr_SetFromErrnoWithFilenameObjects() and
   PyErr_SetExcFromWindowsErrWithFilenameObjects().
 
 Documentation
 -------------
 
-- Issue #20488: Change wording to say importlib is *the* implementation of
+- bpo-20488: Change wording to say importlib is *the* implementation of
   import instead of just *an* implementation.
 
-- Issue #6386: Clarify in the tutorial that specifying a symlink to execute
+- bpo-6386: Clarify in the tutorial that specifying a symlink to execute
   means the directory containing the executed script and not the symlink is
   added to sys.path.
 
 
-What's New in Python 3.4.0 Beta 3?
+What's New in Python 3.4.0 beta 3?
 ==================================
 
-Release date: 2014-01-26
+*Release date: 2014-01-26*
 
 Core and Builtins
 -----------------
 
-- Issue #20189: Four additional builtin types (PyTypeObject,
-  PyMethodDescr_Type, _PyMethodWrapper_Type, and PyWrapperDescr_Type)
-  have been modified to provide introspection information for builtins.
+- bpo-20189: Four additional builtin types (PyTypeObject,
+  PyMethodDescr_Type, _PyMethodWrapper_Type, and PyWrapperDescr_Type) have
+  been modified to provide introspection information for builtins.
 
-- Issue #17825: Cursor "^" is correctly positioned for SyntaxError and
+- bpo-17825: Cursor "^" is correctly positioned for SyntaxError and
   IndentationError.
 
-- Issue #2382: SyntaxError cursor "^" is now written at correct position in most
-  cases when multibyte characters are in line (before "^").  This still not
-  works correctly with wide East Asian characters.
+- bpo-2382: SyntaxError cursor "^" is now written at correct position in
+  most cases when multibyte characters are in line (before "^").  This still
+  not works correctly with wide East Asian characters.
 
-- Issue #18960: The first line of Python script could be executed twice when
-  the source encoding was specified on the second line.  Now the source encoding
-  declaration on the second line isn't effective if the first line contains
-  anything except a comment.  'python -x' works now again with files with the
-  source encoding declarations, and can be used to make Python batch files
-  on Windows.
+- bpo-18960: The first line of Python script could be executed twice when
+  the source encoding was specified on the second line.  Now the source
+  encoding declaration on the second line isn't effective if the first line
+  contains anything except a comment.  'python -x' works now again with
+  files with the source encoding declarations, and can be used to make
+  Python batch files on Windows.
 
 Library
 -------
 
-- asyncio: Various improvements and small changes not all covered by
-  issues listed below.  E.g. wait_for() now cancels the inner task if
-  the timeout occcurs; tweaked the set of exported symbols; renamed
-  Empty/Full to QueueEmpty/QueueFull; "with (yield from lock)" now
-  uses a separate context manager; readexactly() raises if not enough
-  data was read; PTY support tweaks.
+- asyncio: Various improvements and small changes not all covered by issues
+  listed below.  E.g. wait_for() now cancels the inner task if the timeout
+  occcurs; tweaked the set of exported symbols; renamed Empty/Full to
+  QueueEmpty/QueueFull; "with (yield from lock)" now uses a separate context
+  manager; readexactly() raises if not enough data was read; PTY support
+  tweaks.
 
-- Issue #20311: asyncio: Add a granularity attribute to BaseEventLoop: maximum
-  between the resolution of the BaseEventLoop.time() method and the resolution
-  of the selector. The granuarility is used in the scheduler to round time and
-  deadline.
+- bpo-20311: asyncio: Add a granularity attribute to BaseEventLoop: maximum
+  between the resolution of the BaseEventLoop.time() method and the
+  resolution of the selector. The granuarility is used in the scheduler to
+  round time and deadline.
 
-- Issue #20311: selectors: Add a resolution attribute to BaseSelector.
+- bpo-20311: selectors: Add a resolution attribute to BaseSelector.
 
-- Issue #20189: unittest.mock now no longer assumes that any object for
-  which it could get an inspect.Signature is a callable written in Python.
-  Fix courtesy of Michael Foord.
+- bpo-20189: unittest.mock now no longer assumes that any object for which
+  it could get an inspect.Signature is a callable written in Python. Fix
+  courtesy of Michael Foord.
 
-- Issue #20317: ExitStack.__exit__ could create a self-referential loop if an
+- bpo-20317: ExitStack.__exit__ could create a self-referential loop if an
   exception raised by a cleanup operation already had its context set
   correctly (for example, by the @contextmanager decorator). The infinite
   loop this caused is now avoided by checking if the expected context is
   already set before trying to fix it.
 
-- Issue #20374: Fix build with GNU readline >= 6.3.
+- bpo-20374: Fix build with GNU readline >= 6.3.
 
-- Issue #20262: Warnings are raised now when duplicate names are added in the
+- bpo-20262: Warnings are raised now when duplicate names are added in the
   ZIP file or too long ZIP file comment is truncated.
 
-- Issue #20165: The unittest module no longer considers tests marked with
+- bpo-20165: The unittest module no longer considers tests marked with
   @expectedFailure successful if they pass.
 
-- Issue #18574: Added missing newline in 100-Continue reply from
+- bpo-18574: Added missing newline in 100-Continue reply from
   http.server.BaseHTTPRequestHandler. Patch by Nikolaus Rath.
 
-- Issue #20270: urllib.urlparse now supports empty ports.
+- bpo-20270: urllib.urlparse now supports empty ports.
 
-- Issue #20243: TarFile no longer raise ReadError when opened in write mode.
+- bpo-20243: TarFile no longer raise ReadError when opened in write mode.
 
-- Issue #20238: TarFile opened with external fileobj and "w:gz" mode didn't
+- bpo-20238: TarFile opened with external fileobj and "w:gz" mode didn't
   write complete output on close.
 
-- Issue #20245: The open functions in the tarfile module now correctly handle
+- bpo-20245: The open functions in the tarfile module now correctly handle
   empty mode.
 
-- Issue #20242: Fixed basicConfig() format strings for the alternative
+- bpo-20242: Fixed basicConfig() format strings for the alternative
   formatting styles. Thanks to kespindler for the bug report and patch.
 
-- Issue #20246: Fix buffer overflow in socket.recvfrom_into.
+- bpo-20246: Fix buffer overflow in socket.recvfrom_into.
 
-- Issues #20206 and #5803: Fix edge case in email.quoprimime.encode where it
-  truncated lines ending in a character needing encoding but no newline by
-  using a more efficient algorithm that doesn't have the bug.
+- bpo-20206: Fix edge case in email.quoprimime.encode where it truncated
+  lines ending in a character needing encoding but no newline by using a
+  more efficient algorithm that doesn't have the bug. (See also: bpo-5803)
 
-- Issue #19082: Working xmlrpc.server and xmlrpc.client examples. Both in
+- bpo-19082: Working xmlrpc.server and xmlrpc.client examples. Both in
   modules and in documentation. Initial patch contributed by Vajrasky Kok.
 
-- Issue #20138: The wsgiref.application_uri() and wsgiref.request_uri()
+- bpo-20138: The wsgiref.application_uri() and wsgiref.request_uri()
   functions now conform to PEP 3333 when handle non-ASCII URLs.
 
-- Issue #19097: Raise the correct Exception when cgi.FieldStorage is given an
+- bpo-19097: Raise the correct Exception when cgi.FieldStorage is given an
   invalid fileobj.
 
-- Issue #20152: Ported Python/import.c over to Argument Clinic.
+- bpo-20152: Ported Python/import.c over to Argument Clinic.
 
-- Issue #13107: argparse and optparse no longer raises an exception when output
-  a help on environment with too small COLUMNS.  Based on patch by
-  Elazar Gershuni.
+- bpo-13107: argparse and optparse no longer raises an exception when output
+  a help on environment with too small COLUMNS.  Based on patch by Elazar
+  Gershuni.
 
-- Issue #20207: Always disable SSLv2 except when PROTOCOL_SSLv2 is explicitly
+- bpo-20207: Always disable SSLv2 except when PROTOCOL_SSLv2 is explicitly
   asked for.
 
-- Issue #18960: The tokenize module now ignore the source encoding declaration
+- bpo-18960: The tokenize module now ignore the source encoding declaration
   on the second line if the first line contains anything except a comment.
 
-- Issue #20078: Reading malformed zipfiles no longer hangs with 100% CPU
+- bpo-20078: Reading malformed zipfiles no longer hangs with 100% CPU
   consumption.
 
-- Issue #20113: os.readv() and os.writev() now raise an OSError exception on
+- bpo-20113: os.readv() and os.writev() now raise an OSError exception on
   error instead of returning -1.
 
-- Issue #19719: Make importlib.abc.MetaPathFinder.find_module(),
-  PathEntryFinder.find_loader(), and Loader.load_module() use PEP 451 APIs to
-  help with backwards-compatibility.
+- bpo-19719: Make importlib.abc.MetaPathFinder.find_module(),
+  PathEntryFinder.find_loader(), and Loader.load_module() use PEP 451 APIs
+  to help with backwards-compatibility.
 
-- Issue #20144: inspect.Signature now supports parsing simple symbolic
+- bpo-20144: inspect.Signature now supports parsing simple symbolic
   constants as parameter default values in __text_signature__.
 
-- Issue #20072: Fixed multiple errors in tkinter with wantobjects is False.
+- bpo-20072: Fixed multiple errors in tkinter with wantobjects is False.
 
-- Issue #20229: Avoid plistlib deprecation warning in platform.mac_ver().
+- bpo-20229: Avoid plistlib deprecation warning in platform.mac_ver().
 
-- Issue #14455: Fix some problems with the new binary plist support in plistlib.
+- bpo-14455: Fix some problems with the new binary plist support in
+  plistlib.
 
 IDLE
 ----
 
-- Issue #17390: Add Python version to Idle editor window title bar.
-  Original patches by Edmond Burnett and Kent Johnson.
+- bpo-17390: Add Python version to Idle editor window title bar. Original
+  patches by Edmond Burnett and Kent Johnson.
 
-- Issue #18960: IDLE now ignores the source encoding declaration on the second
+- bpo-18960: IDLE now ignores the source encoding declaration on the second
   line if the first line contains anything except a comment.
 
 Tests
 -----
 
-- Issue #20358: Tests for curses.window.overlay and curses.window.overwrite
-  no longer specify min{row,col} > max{row,col}.
+- bpo-20358: Tests for curses.window.overlay and curses.window.overwrite no
+  longer specify min{row,col} > max{row,col}.
 
-- Issue #19804: The test_find_mac test in test_uuid is now skipped if the
+- bpo-19804: The test_find_mac test in test_uuid is now skipped if the
   ifconfig executable is not available.
 
-- Issue #19886: Use better estimated memory requirements for bigmem tests.
+- bpo-19886: Use better estimated memory requirements for bigmem tests.
 
 Tools/Demos
 -----------
 
-- Issue #20390: Argument Clinic's "file" output preset now defaults to
+- bpo-20390: Argument Clinic's "file" output preset now defaults to
   "{dirname}/clinic/{basename}.h".
 
-- Issue #20390: Argument Clinic's "class" directive syntax has been extended
+- bpo-20390: Argument Clinic's "class" directive syntax has been extended
   with two new required arguments: "typedef" and "type_object".
 
-- Issue #20390: Argument Clinic: If __new__ or __init__ functions didn't use
+- bpo-20390: Argument Clinic: If __new__ or __init__ functions didn't use
   kwargs (or args), the PyArg_NoKeywords (or PyArg_NoPositional) calls
   generated are only run when the type object is an exact match.
 
-- Issue #20390: Argument Clinic now fails if you have required parameters after
+- bpo-20390: Argument Clinic now fails if you have required parameters after
   optional parameters.
 
-- Issue #20390: Argument Clinic converters now have a new template they can
+- bpo-20390: Argument Clinic converters now have a new template they can
   inject code into: "modifiers".  Code put there is run in the parsing
   function after argument parsing but before the call to the impl.
 
-- Issue #20376: Argument Clinic now escapes backslashes in docstrings.
+- bpo-20376: Argument Clinic now escapes backslashes in docstrings.
 
-- Issue #20381: Argument Clinic now sanity checks the default argument when
+- bpo-20381: Argument Clinic now sanity checks the default argument when
   c_default is also specified, providing a nice failure message for
   disallowed values.
 
-- Issue #20189: Argument Clinic now ensures that parser functions for
-  __new__ are always of type newfunc, the type of the tp_new slot.
-  Similarly, parser functions for __init__ are now always of type initproc,
-  the type of tp_init.
+- bpo-20189: Argument Clinic now ensures that parser functions for __new__
+  are always of type newfunc, the type of the tp_new slot. Similarly, parser
+  functions for __init__ are now always of type initproc, the type of
+  tp_init.
 
-- Issue #20189: Argument Clinic now suppresses the docstring for __new__
-  and __init__ functions if no docstring is provided in the input.
+- bpo-20189: Argument Clinic now suppresses the docstring for __new__ and
+  __init__ functions if no docstring is provided in the input.
 
-- Issue #20189: Argument Clinic now suppresses the "self" parameter in the
-  impl for @staticmethod functions.
+- bpo-20189: Argument Clinic now suppresses the "self" parameter in the impl
+  for @staticmethod functions.
 
-- Issue #20294: Argument Clinic now supports argument parsing for __new__ and
+- bpo-20294: Argument Clinic now supports argument parsing for __new__ and
   __init__ functions.
 
-- Issue #20299: Argument Clinic custom converters may now change the default
+- bpo-20299: Argument Clinic custom converters may now change the default
   value of c_default and py_default with a class member.
 
-- Issue #20287: Argument Clinic's output is now configurable, allowing
-  delaying its output or even redirecting it to a separate file.
+- bpo-20287: Argument Clinic's output is now configurable, allowing delaying
+  its output or even redirecting it to a separate file.
 
-- Issue #20226: Argument Clinic now permits simple expressions
-  (e.g. "sys.maxsize - 1") as default values for parameters.
+- bpo-20226: Argument Clinic now permits simple expressions (e.g.
+  "sys.maxsize - 1") as default values for parameters.
 
-- Issue #19936: Added executable bits or shebang lines to Python scripts which
+- bpo-19936: Added executable bits or shebang lines to Python scripts which
   requires them.  Disable executable bits and shebang lines in test and
   benchmark files in order to prevent using a random system python, and in
   source files of modules which don't provide command line interface.  Fixed
   shebang lines in the unittestgui and checkpip scripts.
 
-- Issue #20268: Argument Clinic now supports cloning the parameters and
-  return converter of existing functions.
+- bpo-20268: Argument Clinic now supports cloning the parameters and return
+  converter of existing functions.
 
-- Issue #20228: Argument Clinic now has special support for class special
+- bpo-20228: Argument Clinic now has special support for class special
   methods.
 
-- Issue #20214: Fixed a number of small issues and documentation errors in
+- bpo-20214: Fixed a number of small issues and documentation errors in
   Argument Clinic (see issue for details).
 
-- Issue #20196: Fixed a bug where Argument Clinic did not generate correct
-  parsing code for functions with positional-only parameters where all arguments
-  are optional.
+- bpo-20196: Fixed a bug where Argument Clinic did not generate correct
+  parsing code for functions with positional-only parameters where all
+  arguments are optional.
 
-- Issue #18960: 2to3 and the findnocoding.py script now ignore the source
-  encoding declaration on the second line if the first line contains anything
-  except a comment.
+- bpo-18960: 2to3 and the findnocoding.py script now ignore the source
+  encoding declaration on the second line if the first line contains
+  anything except a comment.
 
-- Issue #19723: The marker comments Argument Clinic uses have been changed
-  to improve readability.
+- bpo-19723: The marker comments Argument Clinic uses have been changed to
+  improve readability.
 
-- Issue #20157: When Argument Clinic renames a parameter because its name
-  collides with a C keyword, it no longer exposes that rename to PyArg_Parse.
+- bpo-20157: When Argument Clinic renames a parameter because its name
+  collides with a C keyword, it no longer exposes that rename to
+  PyArg_Parse.
 
-- Issue #20141: Improved Argument Clinic's support for the PyArg_Parse "O!"
+- bpo-20141: Improved Argument Clinic's support for the PyArg_Parse "O!"
   format unit.
 
-- Issue #20144: Argument Clinic now supports simple symbolic constants
-  as parameter default values.
+- bpo-20144: Argument Clinic now supports simple symbolic constants as
+  parameter default values.
 
-- Issue #20143: The line numbers reported in Argument Clinic errors are
-  now more accurate.
+- bpo-20143: The line numbers reported in Argument Clinic errors are now
+  more accurate.
 
-- Issue #20142: Py_buffer variables generated by Argument Clinic are now
+- bpo-20142: Py_buffer variables generated by Argument Clinic are now
   initialized with a default value.
 
 Build
 -----
 
-- Issue #12837: Silence a tautological comparison warning on OS X under Clang in
-  socketmodule.c.
+- bpo-12837: Silence a tautological comparison warning on OS X under Clang
+  in socketmodule.c.
 
 
-What's New in Python 3.4.0 Beta 2?
+What's New in Python 3.4.0 beta 2?
 ==================================
 
-Release date: 2014-01-05
+*Release date: 2014-01-05*
 
 Core and Builtins
 -----------------
 
-- Issue #17432: Drop UCS2 from names of Unicode functions in python3.def.
+- bpo-17432: Drop UCS2 from names of Unicode functions in python3.def.
 
-- Issue #19526: Exclude all new API from the stable ABI. Exceptions can be
-  made if a need is demonstrated.
+- bpo-19526: Exclude all new API from the stable ABI. Exceptions can be made
+  if a need is demonstrated.
 
-- Issue #19969: PyBytes_FromFormatV() now raises an OverflowError if "%c"
+- bpo-19969: PyBytes_FromFormatV() now raises an OverflowError if "%c"
   argument is not in range [0; 255].
 
-- Issue #19995: %c, %o, %x, and %X now issue a DeprecationWarning on non-integer
-  input; reworded docs to clarify that an integer type should define both __int__
-  and __index__.
+- bpo-19995: %c, %o, %x, and %X now issue a DeprecationWarning on non-
+  integer input; reworded docs to clarify that an integer type should define
+  both __int__ and __index__.
 
-- Issue #19787: PyThread_set_key_value() now always set the value. In Python
-  3.3, the function did nothing if the key already exists (if the current value
-  is a non-NULL pointer).
+- bpo-19787: PyThread_set_key_value() now always set the value. In Python
+  3.3, the function did nothing if the key already exists (if the current
+  value is a non-NULL pointer).
 
-- Issue #14432: Remove the thread state field from the frame structure. Fix a
-  crash when a generator is created in a C thread that is destroyed while the
-  generator is still used. The issue was that a generator contains a frame, and
-  the frame kept a reference to the Python state of the destroyed C thread. The
-  crash occurs when a trace function is setup.
+- bpo-14432: Remove the thread state field from the frame structure. Fix a
+  crash when a generator is created in a C thread that is destroyed while
+  the generator is still used. The issue was that a generator contains a
+  frame, and the frame kept a reference to the Python state of the destroyed
+  C thread. The crash occurs when a trace function is setup.
 
-- Issue #19576: PyGILState_Ensure() now initializes threads. At startup, Python
-  has no concrete GIL. If PyGILState_Ensure() is called from a new thread for
-  the first time and PyEval_InitThreads() was not called yet, a GIL needs to be
-  created.
+- bpo-19576: PyGILState_Ensure() now initializes threads. At startup, Python
+  has no concrete GIL. If PyGILState_Ensure() is called from a new thread
+  for the first time and PyEval_InitThreads() was not called yet, a GIL
+  needs to be created.
 
-- Issue #17576: Deprecation warning emitted now when __int__() or __index__()
+- bpo-17576: Deprecation warning emitted now when __int__() or __index__()
   return not int instance.
 
-- Issue #19932: Fix typo in import.h, missing whitespaces in function prototypes.
+- bpo-19932: Fix typo in import.h, missing whitespaces in function
+  prototypes.
 
-- Issue #19736: Add module-level statvfs constants defined for GNU/glibc
-  based systems.
+- bpo-19736: Add module-level statvfs constants defined for GNU/glibc based
+  systems.
 
-- Issue #20097: Fix bad use of "self" in importlib's WindowsRegistryFinder.
+- bpo-20097: Fix bad use of "self" in importlib's WindowsRegistryFinder.
 
-- Issue #19729: In str.format(), fix recursive expansion in format spec.
+- bpo-19729: In str.format(), fix recursive expansion in format spec.
 
-- Issue #19638: Fix possible crash / undefined behaviour from huge (more than 2
+- bpo-19638: Fix possible crash / undefined behaviour from huge (more than 2
   billion characters) input strings in _Py_dg_strtod.
 
 Library
 -------
 
-- Issue #20154: Deadlock in asyncio.StreamReader.readexactly().
+- bpo-20154: Deadlock in asyncio.StreamReader.readexactly().
 
-- Issue #16113: Remove sha3 module again.
+- bpo-16113: Remove sha3 module again.
 
-- Issue #20111: pathlib.Path.with_suffix() now sanity checks the given suffix.
+- bpo-20111: pathlib.Path.with_suffix() now sanity checks the given suffix.
 
 - Fix breakage in TestSuite.countTestCases() introduced by issue #11798.
 
-- Issue #20108: Avoid parameter name clash in inspect.getcallargs().
+- bpo-20108: Avoid parameter name clash in inspect.getcallargs().
 
-- Issue #19918: Fix PurePath.relative_to() under Windows.
+- bpo-19918: Fix PurePath.relative_to() under Windows.
 
-- Issue #19422: Explicitly disallow non-SOCK_STREAM sockets in the ssl
-  module, rather than silently let them emit clear text data.
+- bpo-19422: Explicitly disallow non-SOCK_STREAM sockets in the ssl module,
+  rather than silently let them emit clear text data.
 
-- Issue #20046: Locale alias table no longer contains entities which can be
-  calculated.  Generalized support of the euro modifier.
+- bpo-20046: Locale alias table no longer contains entities which can be
+  calculated. Generalized support of the euro modifier.
 
-- Issue #20027: Fixed locale aliases for devanagari locales.
+- bpo-20027: Fixed locale aliases for devanagari locales.
 
-- Issue #20067: Tkinter variables now work when wantobjects is false.
+- bpo-20067: Tkinter variables now work when wantobjects is false.
 
-- Issue #19020: Tkinter now uses splitlist() instead of split() in configure
+- bpo-19020: Tkinter now uses splitlist() instead of split() in configure
   methods.
 
-- Issue #19744: ensurepip now provides a better error message when Python is
+- bpo-19744: ensurepip now provides a better error message when Python is
   built without SSL/TLS support (pip currently requires that support to run,
   even if only operating with local wheel files)
 
-- Issue #19734: ensurepip now ignores all pip environment variables to avoid
+- bpo-19734: ensurepip now ignores all pip environment variables to avoid
   odd behaviour based on user configuration settings
 
 - Fix TypeError on "setup.py upload --show-response".
 
-- Issue #20045: Fix "setup.py register --list-classifiers".
+- bpo-20045: Fix "setup.py register --list-classifiers".
 
-- Issue #18879: When a method is looked up on a temporary file, avoid closing
+- bpo-18879: When a method is looked up on a temporary file, avoid closing
   the file before the method is possibly called.
 
-- Issue #20037: Avoid crashes when opening a text file late at interpreter
+- bpo-20037: Avoid crashes when opening a text file late at interpreter
   shutdown.
 
-- Issue #19967: Thanks to the PEP 442, asyncio.Future now uses a
-  destructor to log uncaught exceptions, instead of the dedicated
-  _TracebackLogger class.
+- bpo-19967: Thanks to the PEP 442, asyncio.Future now uses a destructor to
+  log uncaught exceptions, instead of the dedicated _TracebackLogger class.
 
 - Added a Task.current_task() class method to asyncio.
 
-- Issue #19850: Set SA_RESTART in asyncio when registering a signal
-  handler to limit EINTR occurrences.
+- bpo-19850: Set SA_RESTART in asyncio when registering a signal handler to
+  limit EINTR occurrences.
 
-- Implemented write flow control in asyncio for proactor event loop (Windows).
+- Implemented write flow control in asyncio for proactor event loop
+  (Windows).
 
 - Change write buffer in asyncio use to avoid O(N**2) behavior.  Make
   write()/sendto() accept bytearray/memoryview.
 
-- Issue #20034: Updated alias mapping to most recent locale.alias file
-  from X.org distribution using makelocalealias.py.
+- bpo-20034: Updated alias mapping to most recent locale.alias file from
+  X.org distribution using makelocalealias.py.
 
-- Issue #5815: Fixed support for locales with modifiers.  Fixed support for
+- bpo-5815: Fixed support for locales with modifiers.  Fixed support for
   locale encodings with hyphens.
 
-- Issue #20026: Fix the sqlite module to handle correctly invalid isolation
+- bpo-20026: Fix the sqlite module to handle correctly invalid isolation
   level (wrong type).
 
-- Issue #18829: csv.Dialect() now checks type for delimiter, escapechar and
+- bpo-18829: csv.Dialect() now checks type for delimiter, escapechar and
   quotechar fields.  Original patch by Vajrasky Kok.
 
-- Issue #19855: uuid.getnode() on Unix now looks on the PATH for the
+- bpo-19855: uuid.getnode() on Unix now looks on the PATH for the
   executables used to find the mac address, with /sbin and /usr/sbin as
   fallbacks.
 
-- Issue #20007: HTTPResponse.read(0) no more prematurely closes connection.
+- bpo-20007: HTTPResponse.read(0) no more prematurely closes connection.
   Original patch by Simon Sapin.
 
-- Issue #19946: multiprocessing now uses runpy to initialize __main__ in
-  child processes when necessary, allowing it to correctly handle scripts
-  without suffixes and submodules that use explicit relative imports or
-  otherwise rely on parent modules being correctly imported prior to
-  execution.
+- bpo-19946: multiprocessing now uses runpy to initialize __main__ in child
+  processes when necessary, allowing it to correctly handle scripts without
+  suffixes and submodules that use explicit relative imports or otherwise
+  rely on parent modules being correctly imported prior to execution.
 
-- Issue #19921: When Path.mkdir() is called with parents=True, any missing
+- bpo-19921: When Path.mkdir() is called with parents=True, any missing
   parent is created with the default permissions, ignoring the mode argument
   (mimicking the POSIX "mkdir -p" command).
 
-- Issue #19887: Improve the Path.resolve() algorithm to support certain
-  symlink chains.
+- bpo-19887: Improve the Path.resolve() algorithm to support certain symlink
+  chains.
 
-- Issue #19912: Fixed numerous bugs in ntpath.splitunc().
+- bpo-19912: Fixed numerous bugs in ntpath.splitunc().
 
-- Issue #19911: ntpath.splitdrive() now correctly processes the 'İ' character
+- bpo-19911: ntpath.splitdrive() now correctly processes the 'İ' character
   (U+0130, LATIN CAPITAL LETTER I WITH DOT ABOVE).
 
-- Issue #19532: python -m compileall with no filename/directory arguments now
+- bpo-19532: python -m compileall with no filename/directory arguments now
   respects the -f and -q flags instead of ignoring them.
 
-- Issue #19623: Fixed writing to unseekable files in the aifc module.
+- bpo-19623: Fixed writing to unseekable files in the aifc module.
 
-- Issue #19946: multiprocessing.spawn now raises ImportError when the module to
+- bpo-19946: multiprocessing.spawn now raises ImportError when the module to
   be used as the main module cannot be imported.
 
-- Issue #17919: select.poll.register() again works with poll.POLLNVAL on AIX.
+- bpo-17919: select.poll.register() again works with poll.POLLNVAL on AIX.
   Fixed integer overflow in the eventmask parameter.
 
-- Issue #19063: if a Charset's body_encoding was set to None, the email
-  package would generate a message claiming the Content-Transfer-Encoding
-  was 7bit, and produce garbage output for the content.  This now works.
-  A couple of other set_payload mishandlings of non-ASCII are also fixed.
-  In addition, calling set_payload with a string argument without
-  specifying a charset now raises an error (this is a new error in 3.4).
+- bpo-19063: if a Charset's body_encoding was set to None, the email package
+  would generate a message claiming the Content-Transfer-Encoding was 7bit,
+  and produce garbage output for the content.  This now works. A couple of
+  other set_payload mishandlings of non-ASCII are also fixed. In addition,
+  calling set_payload with a string argument without specifying a charset
+  now raises an error (this is a new error in 3.4).
 
-- Issue #15475: Add __sizeof__ implementations for itertools objects.
+- bpo-15475: Add __sizeof__ implementations for itertools objects.
 
-- Issue #19944: Fix importlib.find_spec() so it imports parents as needed
-  and move the function to importlib.util.
+- bpo-19944: Fix importlib.find_spec() so it imports parents as needed and
+  move the function to importlib.util.
 
-- Issue #19880: Fix a reference leak in unittest.TestCase. Explicitly break
+- bpo-19880: Fix a reference leak in unittest.TestCase. Explicitly break
   reference cycles between frames and the _Outcome instance.
 
-- Issue #17429: platform.linux_distribution() now decodes files from the UTF-8
-  encoding with the surrogateescape error handler, instead of decoding from the
-  locale encoding in strict mode. It fixes the function on Fedora 19 which is
-  probably the first major distribution release with a non-ASCII name. Patch
-  written by Toshio Kuratomi.
+- bpo-17429: platform.linux_distribution() now decodes files from the UTF-8
+  encoding with the surrogateescape error handler, instead of decoding from
+  the locale encoding in strict mode. It fixes the function on Fedora 19
+  which is probably the first major distribution release with a non-ASCII
+  name. Patch written by Toshio Kuratomi.
 
-- Issue #19343: Expose FreeBSD-specific APIs in resource module.  Original
+- bpo-19343: Expose FreeBSD-specific APIs in resource module.  Original
   patch by Koobs.
 
-- Issue #19929: Call os.read with 32768 within subprocess.Popen.communicate
+- bpo-19929: Call os.read with 32768 within subprocess.Popen.communicate
   rather than 4096 for efficiency.  A microbenchmark shows Linux and OS X
   both using ~50% less cpu time this way.
 
-- Issue #19506: Use a memoryview to avoid a data copy when piping data
-  to stdin within subprocess.Popen.communicate.  5-10% less cpu usage.
+- bpo-19506: Use a memoryview to avoid a data copy when piping data to stdin
+  within subprocess.Popen.communicate.  5-10% less cpu usage.
 
-- Issue #19876: selectors unregister() no longer raises ValueError or OSError
+- bpo-19876: selectors unregister() no longer raises ValueError or OSError
   if the FD is closed (as long as it was registered).
 
-- Issue #19908: pathlib now joins relative Windows paths correctly when a drive
-  is present.  Original patch by Antoine Pitrou.
+- bpo-19908: pathlib now joins relative Windows paths correctly when a drive
+  is present. Original patch by Antoine Pitrou.
 
-- Issue #19296: Silence compiler warning in dbm_open
+- bpo-19296: Silence compiler warning in dbm_open
 
-- Issue #6784: Strings from Python 2 can now be unpickled as bytes
-  objects by setting the encoding argument of Unpickler to be 'bytes'.
-  Initial patch by Merlijn van Deen.
+- bpo-6784: Strings from Python 2 can now be unpickled as bytes objects by
+  setting the encoding argument of Unpickler to be 'bytes'. Initial patch by
+  Merlijn van Deen.
 
-- Issue #19839: Fix regression in bz2 module's handling of non-bzip2 data at
+- bpo-19839: Fix regression in bz2 module's handling of non-bzip2 data at
   EOF, and analogous bug in lzma module.
 
-- Issue #19881: Fix pickling bug where cpickle would emit bad pickle data for
+- bpo-19881: Fix pickling bug where cpickle would emit bad pickle data for
   large bytes string (i.e., with size greater than 2**32-1).
 
-- Issue #19138: doctest's IGNORE_EXCEPTION_DETAIL now allows a match when
-  no exception detail exists (no colon following the exception's name, or
-  colon does follow but no text follows the colon).
+- bpo-19138: doctest's IGNORE_EXCEPTION_DETAIL now allows a match when no
+  exception detail exists (no colon following the exception's name, or a
+  colon does follow but no text follows the colon).
 
-- Issue #19927: Add __eq__ to path-based loaders in importlib.
+- bpo-19927: Add __eq__ to path-based loaders in importlib.
 
-- Issue #19827: On UNIX, setblocking() and settimeout() methods of
-  socket.socket can now avoid a second syscall if the ioctl() function can be
-  used, or if the non-blocking flag of the socket is unchanged.
+- bpo-19827: On UNIX, setblocking() and settimeout() methods of
+  socket.socket can now avoid a second syscall if the ioctl() function can
+  be used, or if the non- blocking flag of the socket is unchanged.
 
-- Issue #19785: smtplib now supports SSLContext.check_hostname and server name
+- bpo-19785: smtplib now supports SSLContext.check_hostname and server name
   indication for TLS/SSL connections.
 
-- Issue #19784: poplib now supports SSLContext.check_hostname and server name
+- bpo-19784: poplib now supports SSLContext.check_hostname and server name
   indication for TLS/SSL connections.
 
-- Issue #19783: nntplib now supports SSLContext.check_hostname and server name
+- bpo-19783: nntplib now supports SSLContext.check_hostname and server name
   indication for TLS/SSL connections.
 
-- Issue #19782: imaplib now supports SSLContext.check_hostname and server name
+- bpo-19782: imaplib now supports SSLContext.check_hostname and server name
   indication for TLS/SSL connections.
 
-- Issue #20123: Fix pydoc.synopsis() for "binary" modules.
+- bpo-20123: Fix pydoc.synopsis() for "binary" modules.
 
-- Issue #19834: Support unpickling of exceptions pickled by Python 2.
+- bpo-19834: Support unpickling of exceptions pickled by Python 2.
 
-- Issue #19781: ftplib now supports SSLContext.check_hostname and server name
+- bpo-19781: ftplib now supports SSLContext.check_hostname and server name
   indication for TLS/SSL connections.
 
-- Issue #19509: Add SSLContext.check_hostname to match the peer's certificate
+- bpo-19509: Add SSLContext.check_hostname to match the peer's certificate
   with server_hostname on handshake.
 
-- Issue #15798: Fixed subprocess.Popen() to no longer fail if file
-  descriptor 0, 1 or 2 is closed.
+- bpo-15798: Fixed subprocess.Popen() to no longer fail if file descriptor
+  0, 1 or 2 is closed.
 
-- Issue #17897: Optimized unpickle prefetching.
+- bpo-17897: Optimized unpickle prefetching.
 
-- Issue #3693: Make the error message more helpful when the array.array()
-  constructor is given a str. Move the array module typecode documentation to
-  the docstring of the constructor.
+- bpo-3693: Make the error message more helpful when the array.array()
+  constructor is given a str. Move the array module typecode documentation
+  to the docstring of the constructor.
 
-- Issue #19088: Fixed incorrect caching of the copyreg module in
+- bpo-19088: Fixed incorrect caching of the copyreg module in
   object.__reduce__() and object.__reduce_ex__().
 
-- Issue #19698: Removed exec_module() methods from
+- bpo-19698: Removed exec_module() methods from
   importlib.machinery.BuiltinImporter and ExtensionFileLoader.
 
-- Issue #18864: Added a setter for ModuleSpec.has_location.
+- bpo-18864: Added a setter for ModuleSpec.has_location.
 
 - Fixed _pickle.Unpickler to not fail when loading empty strings as
   persistent IDs.
 
-- Issue #11480: Fixed copy.copy to work with classes with custom metaclasses.
+- bpo-11480: Fixed copy.copy to work with classes with custom metaclasses.
   Patch by Daniel Urban.
 
-- Issue #6477: Added support for pickling the types of built-in singletons
+- bpo-6477: Added support for pickling the types of built-in singletons
   (i.e., Ellipsis, NotImplemented, None).
 
-- Issue #19713: Add remaining PEP 451-related deprecations and move away
-  from using find_module/find_loaer/load_module.
+- bpo-19713: Add remaining PEP 451-related deprecations and move away from
+  using find_module/find_loaer/load_module.
 
-- Issue #19708: Update pkgutil to use the new importer APIs.
+- bpo-19708: Update pkgutil to use the new importer APIs.
 
-- Issue #19703: Update pydoc to use the new importer APIs.
+- bpo-19703: Update pydoc to use the new importer APIs.
 
-- Issue #19851: Fixed a regression in reloading sub-modules.
+- bpo-19851: Fixed a regression in reloading sub-modules.
 
 - ssl.create_default_context() sets OP_NO_COMPRESSION to prevent CRIME.
 
-- Issue #19802: Add socket.SO_PRIORITY.
+- bpo-19802: Add socket.SO_PRIORITY.
 
-- Issue #11508: Fixed uuid.getnode() and uuid.uuid1() on environment with
-  virtual interface.  Original patch by Kent Frazier.
+- bpo-11508: Fixed uuid.getnode() and uuid.uuid1() on environment with
+  virtual interface. Original patch by Kent Frazier.
 
-- Issue #11489: JSON decoder now accepts lone surrogates.
+- bpo-11489: JSON decoder now accepts lone surrogates.
 
-- Issue #19545: Avoid chained exceptions while passing stray % to
+- bpo-19545: Avoid chained exceptions while passing stray % to
   time.strptime().  Initial patch by Claudiu Popa.
 
 IDLE
 ----
 
-- Issue #20058: sys.stdin.readline() in IDLE now always returns only one line.
+- bpo-20058: sys.stdin.readline() in IDLE now always returns only one line.
 
-- Issue #19481: print() of string subclass instance in IDLE no longer hangs.
+- bpo-19481: print() of string subclass instance in IDLE no longer hangs.
 
-- Issue #18270: Prevent possible IDLE AttributeError on OS X when no initial
+- bpo-18270: Prevent possible IDLE AttributeError on OS X when no initial
   shell window is present.
 
 Tests
 -----
 
-- Issue #20055: Fix test_shutil under Windows with symlink privileges held.
+- bpo-20055: Fix test_shutil under Windows with symlink privileges held.
   Patch by Vajrasky Kok.
 
-- Issue #20070: Don't run test_urllib2net when network resources are not
+- bpo-20070: Don't run test_urllib2net when network resources are not
   enabled.
 
-- Issue #19938: Re-enabled test_bug_1333982 in test_dis, which had been
+- bpo-19938: Re-enabled test_bug_1333982 in test_dis, which had been
   disabled since 3.0 due to the changes in listcomp handling.
 
-- Issue #19320: test_tcl no longer fails when wantobjects is false.
+- bpo-19320: test_tcl no longer fails when wantobjects is false.
 
-- Issue #19919: Fix flaky SSL test. connect_ex() sometimes returns
-  EWOULDBLOCK on Windows or VMs hosted on Windows.
+- bpo-19919: Fix flaky SSL test. connect_ex() sometimes returns EWOULDBLOCK
+  on Windows or VMs hosted on Windows.
 
-- Issue #19912: Added tests for ntpath.splitunc().
+- bpo-19912: Added tests for ntpath.splitunc().
 
-- Issue #19828: Fixed test_site when the whole suite is run with -S.
+- bpo-19828: Fixed test_site when the whole suite is run with -S.
 
-- Issue #19928: Implemented a test for repr() of cell objects.
+- bpo-19928: Implemented a test for repr() of cell objects.
 
-- Issue #19535: Fixed test_docxmlrpc, test_functools, test_inspect, and
+- bpo-19535: Fixed test_docxmlrpc, test_functools, test_inspect, and
   test_statistics when python is run with -OO.
 
-- Issue #19926: Removed unneeded test_main from test_abstract_numbers.
-  Patch by Vajrasky Kok.
+- bpo-19926: Removed unneeded test_main from test_abstract_numbers. Patch by
+  Vajrasky Kok.
 
-- Issue #19572: More skipped tests explicitly marked as skipped.
+- bpo-19572: More skipped tests explicitly marked as skipped.
 
-- Issue #19595, #19987: Re-enabled a long-disabled test in test_winsound.
+- bpo-19595: Re-enabled a long-disabled test in test_winsound. (See also:
+  bpo-19987)
 
-- Issue #19588: Fixed tests in test_random that were silently skipped most
-  of the time.  Patch by Julian Gindi.
+- bpo-19588: Fixed tests in test_random that were silently skipped most of
+  the time. Patch by Julian Gindi.
 
 Build
 -----
 
-- Issue #19728: Enable pip installation by default on Windows.
+- bpo-19728: Enable pip installation by default on Windows.
 
-- Issue #16136: Remove VMS support
+- bpo-16136: Remove VMS support
 
-- Issue #18215: Add script Tools/ssl/test_multiple_versions.py to compile and
+- bpo-18215: Add script Tools/ssl/test_multiple_versions.py to compile and
   run Python's unit tests with multiple versions of OpenSSL.
 
-- Issue #19922: define _INCLUDE__STDC_A1_SOURCE in HP-UX to include mbstate_t
+- bpo-19922: define _INCLUDE__STDC_A1_SOURCE in HP-UX to include mbstate_t
   for mbrtowc().
 
-- Issue #19788: kill_python(_d).exe is now run as a PreBuildEvent on the
-  pythoncore sub-project.  This should prevent build errors due a previous
+- bpo-19788: kill_python(_d).exe is now run as a PreBuildEvent on the
+  pythoncore sub- project.  This should prevent build errors due a previous
   build's python(_d).exe still running.
 
 Documentation
 -------------
 
-- Issue #20265: Updated some parts of the Using Windows document.
+- bpo-20265: Updated some parts of the Using Windows document.
 
-- Issue #20266: Updated some parts of the Windows FAQ.
+- bpo-20266: Updated some parts of the Windows FAQ.
 
-- Issue #20255: Updated the about and bugs pages.
+- bpo-20255: Updated the about and bugs pages.
 
-- Issue #20253: Fixed a typo in the ipaddress docs that advertised an
-  illegal attribute name.  Found by INADA Naoki.
+- bpo-20253: Fixed a typo in the ipaddress docs that advertised an illegal
+  attribute name.  Found by INADA Naoki.
 
-- Issue #18840: Introduce the json module in the tutorial, and de-emphasize
-  the pickle module.
+- bpo-18840: Introduce the json module in the tutorial, and de-emphasize the
+  pickle module.
 
-- Issue #19845: Updated the Compiling Python on Windows section.
+- bpo-19845: Updated the Compiling Python on Windows section.
 
-- Issue #19795: Improved markup of True/False constants.
+- bpo-19795: Improved markup of True/False constants.
 
 Tools/Demos
 -----------
 
-- Issue #19659: Added documentation for Argument Clinic.
+- bpo-19659: Added documentation for Argument Clinic.
 
-- Issue #19976: Argument Clinic METH_NOARGS functions now always
-  take two parameters.
+- bpo-19976: Argument Clinic METH_NOARGS functions now always take two
+  parameters.
 
 
-What's New in Python 3.4.0 Beta 1?
+What's New in Python 3.4.0 beta 1?
 ==================================
 
-Release date: 2013-11-24
+*Release date: 2013-11-24*
 
 Core and Builtins
 -----------------
@@ -3211,644 +3295,644 @@ Core and Builtins
 - Use the repr of a module name in more places in import, especially
   exceptions.
 
-- Issue #19619: str.encode, bytes.decode and bytearray.decode now use an
+- bpo-19619: str.encode, bytes.decode and bytearray.decode now use an
   internal API to throw LookupError for known non-text encodings, rather
   than attempting the encoding or decoding operation and then throwing a
-  TypeError for an unexpected output type. (The latter mechanism remains
-  in place for third party non-text encodings)
+  TypeError for an unexpected output type. (The latter mechanism remains in
+  place for third party non-text encodings)
 
-- Issue #19183: Implement PEP 456 'secure and interchangeable hash algorithm'.
+- bpo-19183: Implement PEP 456 'secure and interchangeable hash algorithm'.
   Python now uses SipHash24 on all major platforms.
 
-- Issue #12892: The utf-16* and utf-32* encoders no longer allow surrogate code
-  points (U+D800-U+DFFF) to be encoded.  The utf-32* decoders no longer decode
-  byte sequences that correspond to surrogate code points.  The surrogatepass
-  error handler now works with the utf-16* and utf-32* codecs.  Based on
-  patches by Victor Stinner and Kang-Hao (Kenny) Lu.
+- bpo-12892: The utf-16* and utf-32* encoders no longer allow surrogate code
+  points (U+D800-U+DFFF) to be encoded.  The utf-32* decoders no longer
+  decode byte sequences that correspond to surrogate code points.  The
+  surrogatepass error handler now works with the utf-16* and utf-32* codecs.
+  Based on patches by Victor Stinner and Kang-Hao (Kenny) Lu.
 
-- Issue #17806: Added keyword-argument support for "tabsize" to
+- bpo-17806: Added keyword-argument support for "tabsize" to
   str/bytes.expandtabs().
 
-- Issue #17828: Output type errors in str.encode(), bytes.decode() and
+- bpo-17828: Output type errors in str.encode(), bytes.decode() and
   bytearray.decode() now direct users to codecs.encode() or codecs.decode()
   as appropriate.
 
-- Issue #17828: The interpreter now attempts to chain errors that occur in
+- bpo-17828: The interpreter now attempts to chain errors that occur in
   codec processing with a replacement exception of the same type that
   includes the codec name in the error message. It ensures it only does this
   when the creation of the replacement exception won't lose any information.
 
-- Issue #19466: Clear the frames of daemon threads earlier during the
-  Python shutdown to call objects destructors. So "unclosed file" resource
-  warnings are now corretly emitted for daemon threads.
+- bpo-19466: Clear the frames of daemon threads earlier during the Python
+  shutdown to call objects destructors. So "unclosed file" resource warnings
+  are now corretly emitted for daemon threads.
 
-- Issue #19514: Deduplicate some _Py_IDENTIFIER declarations.
-  Patch by Andrei Dorian Duma.
+- bpo-19514: Deduplicate some _Py_IDENTIFIER declarations. Patch by Andrei
+  Dorian Duma.
 
-- Issue #17936: Fix O(n**2) behaviour when adding or removing many subclasses
+- bpo-17936: Fix O(n**2) behaviour when adding or removing many subclasses
   of a given type.
 
-- Issue #19428: zipimport now handles errors when reading truncated or invalid
+- bpo-19428: zipimport now handles errors when reading truncated or invalid
   ZIP archive.
 
-- Issue #18408: Add a new PyFrame_FastToLocalsWithError() function to handle
+- bpo-18408: Add a new PyFrame_FastToLocalsWithError() function to handle
   exceptions when merging fast locals into f_locals of a frame.
   PyEval_GetLocals() now raises an exception and return NULL on failure.
 
-- Issue #19369: Optimized the usage of __length_hint__().
+- bpo-19369: Optimized the usage of __length_hint__().
 
-- Issue #18603: Ensure that PyOS_mystricmp and PyOS_mystrnicmp are in the
+- bpo-18603: Ensure that PyOS_mystricmp and PyOS_mystrnicmp are in the
   Python executable and not removed by the linker's optimizer.
 
-- Issue #19306: Add extra hints to the faulthandler module's stack
-  dumps that these are "upside down".
+- bpo-19306: Add extra hints to the faulthandler module's stack dumps that
+  these are "upside down".
 
 Library
 -------
 
-- Issue #3158: doctest can now find doctests in functions and methods
-  written in C.
+- bpo-3158: doctest can now find doctests in functions and methods written
+  in C.
 
-- Issue #13477: Added command line interface to the tarfile module.
-  Original patch by Berker Peksag.
+- bpo-13477: Added command line interface to the tarfile module. Original
+  patch by Berker Peksag.
 
-- Issue #19674: inspect.signature() now produces a correct signature
-  for some builtins.
+- bpo-19674: inspect.signature() now produces a correct signature for some
+  builtins.
 
-- Issue #19722: Added opcode.stack_effect(), which
-  computes the stack effect of bytecode instructions.
+- bpo-19722: Added opcode.stack_effect(), which computes the stack effect of
+  bytecode instructions.
 
-- Issue #19735: Implement private function ssl._create_stdlib_context() to
+- bpo-19735: Implement private function ssl._create_stdlib_context() to
   create SSLContext objects in Python's stdlib module. It provides a single
   configuration point and makes use of SSLContext.load_default_certs().
 
-- Issue #16203: Add re.fullmatch() function and regex.fullmatch() method,
-  which anchor the pattern at both ends of the string to match.
-  Original patch by Matthew Barnett.
+- bpo-16203: Add re.fullmatch() function and regex.fullmatch() method, which
+  anchor the pattern at both ends of the string to match. Original patch by
+  Matthew Barnett.
 
-- Issue #13592: Improved the repr for regular expression pattern objects.
-  Based on patch by Hugo Lopes Tavares.
+- bpo-13592: Improved the repr for regular expression pattern objects. Based
+  on patch by Hugo Lopes Tavares.
 
-- Issue #19641: Added the audioop.byteswap() function to convert big-endian
+- bpo-19641: Added the audioop.byteswap() function to convert big-endian
   samples to little-endian and vice versa.
 
-- Issue #15204: Deprecated the 'U' mode in file-like objects.
+- bpo-15204: Deprecated the 'U' mode in file-like objects.
 
-- Issue #17810: Implement PEP 3154, pickle protocol 4.
+- bpo-17810: Implement PEP 3154, pickle protocol 4.
 
-- Issue #19668: Added support for the cp1125 encoding.
+- bpo-19668: Added support for the cp1125 encoding.
 
-- Issue #19689: Add ssl.create_default_context() factory function. It creates
-  new SSLContext object with secure default settings.
+- bpo-19689: Add ssl.create_default_context() factory function. It creates a
+  new SSLContext object with secure default settings.
 
-- Issue #19727: os.utime(..., None) is now potentially more precise
-  under Windows.
+- bpo-19727: os.utime(..., None) is now potentially more precise under
+  Windows.
 
-- Issue #17201: ZIP64 extensions now are enabled by default.  Patch by
-  William Mallard.
+- bpo-17201: ZIP64 extensions now are enabled by default.  Patch by William
+  Mallard.
 
-- Issue #19292: Add SSLContext.load_default_certs() to load default root CA
+- bpo-19292: Add SSLContext.load_default_certs() to load default root CA
   certificates from default stores or system stores. By default the method
   loads CA certs for authentication of server certs.
 
-- Issue #19673: Add pathlib to the stdlib as a provisional module (PEP 428).
+- bpo-19673: Add pathlib to the stdlib as a provisional module (PEP 428).
 
-- Issue #16596: pdb in a generator now properly skips over yield and
-  yield from rather than stepping out of the generator into its
-  caller.  (This is essential for stepping through asyncio coroutines.)
+- bpo-16596: pdb in a generator now properly skips over yield and yield from
+  rather than stepping out of the generator into its caller.  (This is
+  essential for stepping through asyncio coroutines.)
 
-- Issue #17916: Added dis.Bytecode.from_traceback() and
+- bpo-17916: Added dis.Bytecode.from_traceback() and
   dis.Bytecode.current_offset to easily display "current instruction"
   markers in the new disassembly API (Patch by Claudiu Popa).
 
-- Issue #19552: venv now supports bootstrapping pip into virtual environments
+- bpo-19552: venv now supports bootstrapping pip into virtual environments
 
-- Issue #17134: Finalize interface to Windows' certificate store. Cert and
-  CRL enumeration are now two functions. enum_certificates() also returns
+- bpo-17134: Finalize interface to Windows' certificate store. Cert and CRL
+  enumeration are now two functions. enum_certificates() also returns
   purpose flags as set of OIDs.
 
-- Issue #19555: Restore sysconfig.get_config_var('SO'), (and the distutils
+- bpo-19555: Restore sysconfig.get_config_var('SO'), (and the distutils
   equivalent) with a DeprecationWarning pointing people at $EXT_SUFFIX.
 
-- Issue #8813: Add SSLContext.verify_flags to change the verification flags
-  of the context in order to enable certification revocation list (CRL)
-  checks or strict X509 rules.
+- bpo-8813: Add SSLContext.verify_flags to change the verification flags of
+  the context in order to enable certification revocation list (CRL) checks
+  or strict X509 rules.
 
-- Issue #18294: Fix the zlib module to make it 64-bit safe.
+- bpo-18294: Fix the zlib module to make it 64-bit safe.
 
-- Issue #19682: Fix compatibility issue with old version of OpenSSL that
-  was introduced by Issue #18379.
+- bpo-19682: Fix compatibility issue with old version of OpenSSL that was
+  introduced by Issue #18379.
 
-- Issue #14455: plistlib now supports binary plists and has an updated API.
+- bpo-14455: plistlib now supports binary plists and has an updated API.
 
-- Issue #19633: Fixed writing not compressed 16- and 32-bit wave files on
-  big-endian platforms.
+- bpo-19633: Fixed writing not compressed 16- and 32-bit wave files on big-
+  endian platforms.
 
-- Issue #18379: SSLSocket.getpeercert() returns CA issuer AIA fields, OCSP
-  and CRL distribution points.
+- bpo-18379: SSLSocket.getpeercert() returns CA issuer AIA fields, OCSP and
+  CRL distribution points.
 
-- Issue #18138: Implement cadata argument of SSLContext.load_verify_location()
+- bpo-18138: Implement cadata argument of SSLContext.load_verify_location()
   to load CA certificates and CRL from memory. It supports PEM and DER
   encoded strings.
 
-- Issue #18775: Add name and block_size attribute to HMAC object. They now
+- bpo-18775: Add name and block_size attribute to HMAC object. They now
   provide the same API elements as non-keyed cryptographic hash functions.
 
-- Issue #17276: MD5 as default digestmod for HMAC is deprecated. The HMAC
+- bpo-17276: MD5 as default digestmod for HMAC is deprecated. The HMAC
   module supports digestmod names, e.g. hmac.HMAC('sha1').
 
-- Issue #19449: in csv's writerow, handle non-string keys when generating the
+- bpo-19449: in csv's writerow, handle non-string keys when generating the
   error message that certain keys are not in the 'fieldnames' list.
 
-- Issue #13633: Added a new convert_charrefs keyword arg to HTMLParser that,
+- bpo-13633: Added a new convert_charrefs keyword arg to HTMLParser that,
   when True, automatically converts all character references.
 
-- Issue #2927: Added the unescape() function to the html module.
+- bpo-2927: Added the unescape() function to the html module.
 
-- Issue #8402: Added the escape() function to the glob module.
+- bpo-8402: Added the escape() function to the glob module.
 
-- Issue #17618: Add Base85 and Ascii85 encoding/decoding to the base64 module.
+- bpo-17618: Add Base85 and Ascii85 encoding/decoding to the base64 module.
 
-- Issue #19634: time.strftime("%y") now raises a ValueError on AIX when given a
+- bpo-19634: time.strftime("%y") now raises a ValueError on AIX when given a
   year before 1900.
 
-- Fix test.support.bind_port() to not cause an error when Python was compiled
-  on a system with SO_REUSEPORT defined in the headers but run on a system
-  with an OS kernel that does not support that reasonably new socket option.
+- Fix test.support.bind_port() to not cause an error when Python was
+  compiled on a system with SO_REUSEPORT defined in the headers but run on a
+  system with an OS kernel that does not support that reasonably new socket
+  option.
 
-- Fix compilation error under gcc of the ctypes module bundled libffi for arm.
+- Fix compilation error under gcc of the ctypes module bundled libffi for
+  arm.
 
-- Issue #19448: Add private API to SSL module to lookup ASN.1 objects by OID,
+- bpo-19448: Add private API to SSL module to lookup ASN.1 objects by OID,
   NID, short name and long name.
 
-- Issue #19282: dbm.open now supports the context management protocol. (Inital
+- bpo-19282: dbm.open now supports the context management protocol. (Inital
   patch by Claudiu Popa)
 
-- Issue #8311: Added support for writing any bytes-like objects in the aifc,
+- bpo-8311: Added support for writing any bytes-like objects in the aifc,
   sunau, and wave modules.
 
-- Issue #5202: Added support for unseekable files in the wave module.
+- bpo-5202: Added support for unseekable files in the wave module.
 
-- Issue #19544 and Issue #1180: Restore global option to ignore
-  ~/.pydistutils.cfg in Distutils, accidentally removed in backout of
-  distutils2 changes.
+- bpo-19544: Restore global option to ignore ~/.pydistutils.cfg in
+  Distutils, accidentally removed in backout of distutils2 changes. (See
+  also: bpo-1180)
 
-- Issue #19523: Closed FileHandler leak which occurred when delay was set.
+- bpo-19523: Closed FileHandler leak which occurred when delay was set.
 
-- Issue #19544 and Issue #6516: Restore support for --user and --group
-  parameters to sdist command accidentally rolled back as part of the
-  distutils2 rollback.
+- bpo-19544: Restore support for --user and --group parameters to sdist
+  command accidentally rolled back as part of the distutils2 rollback. (See
+  also: bpo-6516)
 
-- Issue #13674: Prevented time.strftime from crashing on Windows when given
-  year before 1900 and a format of %y.
+- bpo-13674: Prevented time.strftime from crashing on Windows when given a
+  year before 1900 and a format of %y.
 
-- Issue #19406: implementation of the ensurepip module (part of PEP 453).
-  Patch by Donald Stufft and Nick Coghlan.
+- bpo-19406: implementation of the ensurepip module (part of PEP 453). Patch
+  by Donald Stufft and Nick Coghlan.
 
-- Issue #19544 and Issue #6286: Restore use of urllib over http allowing use
-  of http_proxy for Distutils upload command, a feature accidentally lost
-  in the rollback of distutils2.
+- bpo-19544: Restore use of urllib over http allowing use of http_proxy for
+  Distutils upload command, a feature accidentally lost in the rollback of
+  distutils2. (See also: bpo-6286)
 
-- Issue #19544 and Issue #7457: Restore the read_pkg_file method to
+- bpo-19544: Restore the read_pkg_file method to
   distutils.dist.DistributionMetadata accidentally removed in the undo of
-  distutils2.
+  distutils2. (See also: bpo-7457)
 
-- Issue #16685: Added support for any bytes-like objects in the audioop module.
+- bpo-16685: Added support for any bytes-like objects in the audioop module.
   Removed support for strings.
 
-- Issue #7171: Add Windows implementation of ``inet_ntop`` and ``inet_pton``
-  to socket module. Patch by Atsuo Ishimoto.
+- bpo-7171: Add Windows implementation of ``inet_ntop`` and ``inet_pton`` to
+  socket module. Patch by Atsuo Ishimoto.
 
-- Issue #19261: Added support for writing 24-bit samples in the sunau module.
+- bpo-19261: Added support for writing 24-bit samples in the sunau module.
 
-- Issue #1097797: Added CP273 encoding, used on IBM mainframes in
-  Germany and Austria.  Mapping provided by Michael Bierenfeld.
+- bpo-1097797: Added CP273 encoding, used on IBM mainframes in Germany and
+  Austria. Mapping provided by Michael Bierenfeld.
 
-- Issue #1575020: Fixed support of 24-bit wave files on big-endian platforms.
+- bpo-1575020: Fixed support of 24-bit wave files on big-endian platforms.
 
-- Issue #19378: Fixed a number of cases in the dis module where the new
-  "file" parameter was not being honoured correctly
+- bpo-19378: Fixed a number of cases in the dis module where the new "file"
+  parameter was not being honoured correctly
 
-- Issue #19378: Removed the "dis.Bytecode.show_info" method
+- bpo-19378: Removed the "dis.Bytecode.show_info" method
 
-- Issue #19378: Renamed the "dis.Bytecode.display_code" method to
+- bpo-19378: Renamed the "dis.Bytecode.display_code" method to
   "dis.Bytecode.dis" and converted it to returning a string rather than
   printing output.
 
-- Issue #19378: the "line_offset" parameter in the new "dis.get_instructions"
+- bpo-19378: the "line_offset" parameter in the new "dis.get_instructions"
   API has been renamed to "first_line" (and the default value and usage
-  changed accordingly). This should reduce confusion with the more common use
-  of "offset" in the dis docs to refer to bytecode offsets.
+  changed accordingly). This should reduce confusion with the more common
+  use of "offset" in the dis docs to refer to bytecode offsets.
 
-- Issue #18678: Corrected spwd struct member names in spwd module:
+- bpo-18678: Corrected spwd struct member names in spwd module:
   sp_nam->sp_namp, and sp_pwd->sp_pwdp.  The old names are kept as extra
   structseq members, for backward compatibility.
 
-- Issue #6157: Fixed tkinter.Text.debug().  tkinter.Text.bbox() now raises
-  TypeError instead of TclError on wrong number of arguments.  Original patch
-  by Guilherme Polo.
+- bpo-6157: Fixed tkinter.Text.debug().  tkinter.Text.bbox() now raises
+  TypeError instead of TclError on wrong number of arguments.  Original
+  patch by Guilherme Polo.
 
-- Issue #10197: Rework subprocess.get[status]output to use subprocess
+- bpo-10197: Rework subprocess.get[status]output to use subprocess
   functionality and thus to work on Windows. Patch by Nick Coghlan
 
-- Issue #6160: The bbox() method of tkinter.Spinbox now returns a tuple of
+- bpo-6160: The bbox() method of tkinter.Spinbox now returns a tuple of
   integers instead of a string.  Based on patch by Guilherme Polo.
 
-- Issue #19403: contextlib.redirect_stdout is now reentrant
+- bpo-19403: contextlib.redirect_stdout is now reentrant
 
-- Issue #19286: Directories in ``package_data`` are no longer added to
-  the filelist, preventing failure outlined in the ticket.
+- bpo-19286: Directories in ``package_data`` are no longer added to the
+  filelist, preventing failure outlined in the ticket.
 
-- Issue #19480: HTMLParser now accepts all valid start-tag names as defined
-  by the HTML5 standard.
+- bpo-19480: HTMLParser now accepts all valid start-tag names as defined by
+  the HTML5 standard.
 
-- Issue #15114: The html.parser module now raises a DeprecationWarning when the
+- bpo-15114: The html.parser module now raises a DeprecationWarning when the
   strict argument of HTMLParser or the HTMLParser.error method are used.
 
-- Issue #19410: Undo the special-casing removal of '' for
+- bpo-19410: Undo the special-casing removal of '' for
   importlib.machinery.FileFinder.
 
-- Issue #19424: Fix the warnings module to accept filename containing surrogate
+- bpo-19424: Fix the warnings module to accept filename containing surrogate
   characters.
 
-- Issue #19435: Fix directory traversal attack on CGIHttpRequestHandler.
+- bpo-19435: Fix directory traversal attack on CGIHttpRequestHandler.
 
-- Issue #19227: Remove pthread_atfork() handler. The handler was added to
-  solve #18747 but has caused issues.
+- bpo-19227: Remove pthread_atfork() handler. The handler was added to solve
+  #18747 but has caused issues.
 
-- Issue #19420: Fix reference leak in module initalization code of
+- bpo-19420: Fix reference leak in module initalization code of
   _hashopenssl.c
 
-- Issue #19329: Optimized compiling charsets in regular expressions.
+- bpo-19329: Optimized compiling charsets in regular expressions.
 
-- Issue #19227: Try to fix deadlocks caused by re-seeding then OpenSSL
-  pseudo-random number generator on fork().
+- bpo-19227: Try to fix deadlocks caused by re-seeding then OpenSSL pseudo-
+  random number generator on fork().
 
-- Issue #16037: HTTPMessage.readheaders() raises an HTTPException when more than
-  100 headers are read.  Adapted from patch by Jyrki Pulliainen.
+- bpo-16037: HTTPMessage.readheaders() raises an HTTPException when more
+  than 100 headers are read.  Adapted from patch by Jyrki Pulliainen.
 
-- Issue #16040: CVE-2013-1752: nntplib: Limit maximum line lengths to 2048 to
+- bpo-16040: CVE-2013-1752: nntplib: Limit maximum line lengths to 2048 to
   prevent readline() calls from consuming too much memory.  Patch by Jyrki
   Pulliainen.
 
-- Issue #16041: CVE-2013-1752: poplib: Limit maximum line lengths to 2048 to
+- bpo-16041: CVE-2013-1752: poplib: Limit maximum line lengths to 2048 to
   prevent readline() calls from consuming too much memory.  Patch by Jyrki
   Pulliainen.
 
-- Issue #17997: Change behavior of ``ssl.match_hostname()`` to follow RFC 6125,
-  for security reasons.  It now doesn't match multiple wildcards nor wildcards
-  inside IDN fragments.
+- bpo-17997: Change behavior of ``ssl.match_hostname()`` to follow RFC 6125,
+  for security reasons.  It now doesn't match multiple wildcards nor
+  wildcards inside IDN fragments.
 
-- Issue #16039: CVE-2013-1752: Change use of readline in imaplib module to limit
-  line length.  Patch by Emil Lind.
+- bpo-16039: CVE-2013-1752: Change use of readline in imaplib module to
+  limit line length.  Patch by Emil Lind.
 
-- Issue #19330: the unnecessary wrapper functions have been removed from the
+- bpo-19330: the unnecessary wrapper functions have been removed from the
   implementations of the new contextlib.redirect_stdout and
   contextlib.suppress context managers, which also ensures they provide
   reasonable help() output on instances
 
-- Issue #19393: Fix symtable.symtable function to not be confused when there are
-  functions or classes named "top".
+- bpo-19393: Fix symtable.symtable function to not be confused when there
+  are functions or classes named "top".
 
-- Issue #18685: Restore re performance to pre-PEP 393 levels.
+- bpo-18685: Restore re performance to pre-PEP 393 levels.
 
-- Issue #19339: telnetlib module is now using time.monotonic() when available
+- bpo-19339: telnetlib module is now using time.monotonic() when available
   to compute timeout.
 
-- Issue #19399: fix sporadic test_subprocess failure.
+- bpo-19399: fix sporadic test_subprocess failure.
 
-- Issue #13234: Fix os.listdir to work with extended paths on Windows.
-  Patch by Santoso Wijaya.
+- bpo-13234: Fix os.listdir to work with extended paths on Windows. Patch by
+  Santoso Wijaya.
 
-- Issue #19375: The site module adding a "site-python" directory to sys.path,
+- bpo-19375: The site module adding a "site-python" directory to sys.path,
   if it exists, is now deprecated.
 
-- Issue #19379: Lazily import linecache in the warnings module, to make
-  startup with warnings faster until a warning gets printed.
+- bpo-19379: Lazily import linecache in the warnings module, to make startup
+  with warnings faster until a warning gets printed.
 
-- Issue #19288: Fixed the "in" operator of dbm.gnu databases for string
+- bpo-19288: Fixed the "in" operator of dbm.gnu databases for string
   argument.  Original patch by Arfrever Frehtes Taifersar Arahesis.
 
-- Issue #19287: Fixed the "in" operator of dbm.ndbm databases for string
+- bpo-19287: Fixed the "in" operator of dbm.ndbm databases for string
   argument.  Original patch by Arfrever Frehtes Taifersar Arahesis.
 
-- Issue #19327: Fixed the working of regular expressions with too big charset.
+- bpo-19327: Fixed the working of regular expressions with too big charset.
 
-- Issue #17400: New 'is_global' attribute for ipaddress to tell if an address
+- bpo-17400: New 'is_global' attribute for ipaddress to tell if an address
   is allocated by IANA for global or private networks.
 
-- Issue #19350: Increasing the test coverage of macurl2path. Patch by Colin
+- bpo-19350: Increasing the test coverage of macurl2path. Patch by Colin
   Williams.
 
-- Issue #19365: Optimized the parsing of long replacement string in re.sub*()
+- bpo-19365: Optimized the parsing of long replacement string in re.sub*()
   functions.
 
-- Issue #19352: Fix unittest discovery when a module can be reached
-  through several paths (e.g. under Debian/Ubuntu with virtualenv).
+- bpo-19352: Fix unittest discovery when a module can be reached through
+  several paths (e.g. under Debian/Ubuntu with virtualenv).
 
-- Issue #15207: Fix mimetypes to read from correct part of Windows registry
+- bpo-15207: Fix mimetypes to read from correct part of Windows registry
   Original patch by Dave Chambers
 
-- Issue #16595: Add prlimit() to resource module.
+- bpo-16595: Add prlimit() to resource module.
 
-- Issue #19324: Expose Linux-specific constants in resource module.
+- bpo-19324: Expose Linux-specific constants in resource module.
 
 - Load SSL's error strings in hashlib.
 
-- Issue #18527: Upgrade internal copy of zlib to 1.2.8.
+- bpo-18527: Upgrade internal copy of zlib to 1.2.8.
 
-- Issue #19274: Add a filterfunc parameter to PyZipFile.writepy.
+- bpo-19274: Add a filterfunc parameter to PyZipFile.writepy.
 
-- Issue #8964: fix platform._sys_version to handle IronPython 2.6+.
-  Patch by Martin Matusiak.
+- bpo-8964: fix platform._sys_version to handle IronPython 2.6+. Patch by
+  Martin Matusiak.
 
-- Issue #19413: Restore pre-3.3 reload() semantics of re-finding modules.
+- bpo-19413: Restore pre-3.3 reload() semantics of re-finding modules.
 
-- Issue #18958: Improve error message for json.load(s) while passing a string
+- bpo-18958: Improve error message for json.load(s) while passing a string
   that starts with a UTF-8 BOM.
 
-- Issue #19307: Improve error message for json.load(s) while passing objects
-  of the wrong type.
+- bpo-19307: Improve error message for json.load(s) while passing objects of
+  the wrong type.
 
-- Issue #16038: CVE-2013-1752: ftplib: Limit amount of data read by
-  limiting the call to readline().  Original patch by Michał
-  Jastrzębski and Giampaolo Rodola.
+- bpo-16038: CVE-2013-1752: ftplib: Limit amount of data read by limiting
+  the call to readline().  Original patch by Michał Jastrzębski and
+  Giampaolo Rodola.
 
-- Issue #17087: Improved the repr for regular expression match objects.
+- bpo-17087: Improved the repr for regular expression match objects.
 
 Tests
 -----
 
-- Issue #19664: test_userdict's repr test no longer depends on the order
-  of dict elements.
+- bpo-19664: test_userdict's repr test no longer depends on the order of
+  dict elements.
 
-- Issue #19440: Clean up test_capi by removing an unnecessary __future__
+- bpo-19440: Clean up test_capi by removing an unnecessary __future__
   import, converting from test_main to unittest.main, and running the
   _testcapi module tests as subTests of a unittest TestCase method.
 
-- Issue #19378: the main dis module tests are now run with both stdout
+- bpo-19378: the main dis module tests are now run with both stdout
   redirection *and* passing an explicit file parameter
 
-- Issue #19378: removed the not-actually-helpful assertInstructionMatches
-  and assertBytecodeExactlyMatches helpers from bytecode_helper
+- bpo-19378: removed the not-actually-helpful assertInstructionMatches and
+  assertBytecodeExactlyMatches helpers from bytecode_helper
 
-- Issue #18702: All skipped tests now reported as skipped.
+- bpo-18702: All skipped tests now reported as skipped.
 
-- Issue #19439: interpreter embedding tests are now executed on Windows
-  (Patch by Zachary Ware)
+- bpo-19439: interpreter embedding tests are now executed on Windows (Patch
+  by Zachary Ware)
 
-- Issue #19085: Added basic tests for all tkinter widget options.
+- bpo-19085: Added basic tests for all tkinter widget options.
 
-- Issue #19384: Fix test_py_compile for root user, patch by Claudiu Popa.
+- bpo-19384: Fix test_py_compile for root user, patch by Claudiu Popa.
 
 Documentation
 -------------
 
-- Issue #18326: Clarify that list.sort's arguments are keyword-only.  Also,
+- bpo-18326: Clarify that list.sort's arguments are keyword-only.  Also,
   attempt to reduce confusion in the glossary by not saying there are
   different "types" of arguments and parameters.
 
 Build
 -----
 
-- Issue #19358: "make clinic" now runs the Argument Clinic preprocessor
-  over all CPython source files.
+- bpo-19358: "make clinic" now runs the Argument Clinic preprocessor over
+  all CPython source files.
 
 - Update SQLite to 3.8.1, xz to 5.0.5, and Tcl/Tk to 8.6.1 on Windows.
 
-- Issue #16632: Enable DEP and ASLR on Windows.
+- bpo-16632: Enable DEP and ASLR on Windows.
 
-- Issue #17791: Drop PREFIX and EXEC_PREFIX definitions from PC/pyconfig.h
+- bpo-17791: Drop PREFIX and EXEC_PREFIX definitions from PC/pyconfig.h
 
 - Add workaround for VS 2010 nmake clean issue. VS 2010 doesn't set up PATH
   for nmake.exe correctly.
 
-- Issue #19550: Implement Windows installer changes of PEP 453 (ensurepip).
+- bpo-19550: Implement Windows installer changes of PEP 453 (ensurepip).
 
-- Issue #19520: Fix compiler warning in the _sha3 module on 32bit Windows.
+- bpo-19520: Fix compiler warning in the _sha3 module on 32bit Windows.
 
-- Issue #19356: Avoid using a C variabled named "_self", it's a reserved
-  word in some C compilers.
+- bpo-19356: Avoid using a C variabled named "_self", it's a reserved word
+  in some C compilers.
 
-- Issue #15792: Correct build options on Win64. Patch by Jeremy Kloth.
+- bpo-15792: Correct build options on Win64. Patch by Jeremy Kloth.
 
-- Issue #19373: Apply upstream change to Tk 8.5.15 fixing OS X 10.9
-  screen refresh problem for OS X installer build.
+- bpo-19373: Apply upstream change to Tk 8.5.15 fixing OS X 10.9 screen
+  refresh problem for OS X installer build.
 
-- Issue #19649: On OS X, the same set of file names are now installed
-  in bin directories for all configurations: non-framework vs framework,
-  and single arch vs universal builds.  pythonx.y-32 is now always
-  installed for 64-bit/32-bit universal builds.  The obsolete and
-  undocumented pythonw* symlinks are no longer installed anywhere.
+- bpo-19649: On OS X, the same set of file names are now installed in bin
+  directories for all configurations: non-framework vs framework, and single
+  arch vs universal builds.  pythonx.y-32 is now always installed for
+  64-bit/32-bit universal builds.  The obsolete and undocumented pythonw*
+  symlinks are no longer installed anywhere.
 
-- Issue #19553: PEP 453 - "make install" and "make altinstall" now install or
-  upgrade pip by default, using the bundled pip provided by the new ensurepip
-  module.  A new configure option, --with-ensurepip[=upgrade|install|no], is
-  available to override the default ensurepip "--upgrade" option.  The option
-  can also be set with "make [alt]install ENSUREPIP=[upgrade|install|no]".
+- bpo-19553: PEP 453 - "make install" and "make altinstall" now install or
+  upgrade pip by default, using the bundled pip provided by the new
+  ensurepip module.  A new configure option, --with-
+  ensurepip[=upgrade|install|no], is available to override the default
+  ensurepip "--upgrade" option.  The option can also be set with "make
+  [alt]install ENSUREPIP=[upgrade|install|no]".
 
-- Issue #19551: PEP 453 - the OS X installer now installs pip by default.
+- bpo-19551: PEP 453 - the OS X installer now installs pip by default.
 
 - Update third-party libraries for OS X installers: xz 5.0.3 -> 5.0.5,
   SQLite 3.7.13 -> 3.8.1
 
-- Issue #15663: Revert OS X installer built-in Tcl/Tk support for 3.4.0b1.
-  Some third-party projects, such as Matplotlib and PIL/Pillow,
-  depended on being able to build with Tcl and Tk frameworks in
-  /Library/Frameworks.
+- bpo-15663: Revert OS X installer built-in Tcl/Tk support for 3.4.0b1. Some
+  third-party projects, such as Matplotlib and PIL/Pillow, depended on being
+  able to build with Tcl and Tk frameworks in /Library/Frameworks.
 
 Tools/Demos
 -----------
 
-- Issue #19730: Argument Clinic now supports all the existing PyArg
-  "format units" as legacy converters, as well as two new features:
-  "self converters" and the "version" directive.
+- bpo-19730: Argument Clinic now supports all the existing PyArg "format
+  units" as legacy converters, as well as two new features: "self
+  converters" and the "version" directive.
 
-- Issue #19552: pyvenv now bootstraps pip into virtual environments by
-  default (pass --without-pip to request the old behaviour)
+- bpo-19552: pyvenv now bootstraps pip into virtual environments by default
+  (pass --without-pip to request the old behaviour)
 
-- Issue #19390: Argument Clinic no longer accepts malformed Python
-  and C ids.
+- bpo-19390: Argument Clinic no longer accepts malformed Python and C ids.
 
 
-What's New in Python 3.4.0 Alpha 4?
+What's New in Python 3.4.0 alpha 4?
 ===================================
 
-Release date: 2013-10-20
+*Release date: 2013-10-20*
 
 Core and Builtins
 -----------------
 
-- Issue #19301: Give classes and functions that are explicitly marked global a
+- bpo-19301: Give classes and functions that are explicitly marked global a
   global qualname.
 
-- Issue #19279: UTF-7 decoder no longer produces illegal strings.
+- bpo-19279: UTF-7 decoder no longer produces illegal strings.
 
-- Issue #16612: Add "Argument Clinic", a compile-time preprocessor for
-  C files to generate argument parsing code.  (See PEP 436.)
+- bpo-16612: Add "Argument Clinic", a compile-time preprocessor for C files
+  to generate argument parsing code.  (See PEP 436.)
 
-- Issue #18810: Shift stat calls in importlib.machinery.FileFinder such that
-  the code is optimistic that if something exists in a directory named exactly
-  like the possible package being searched for that it's in actuality a
-  directory.
+- bpo-18810: Shift stat calls in importlib.machinery.FileFinder such that
+  the code is optimistic that if something exists in a directory named
+  exactly like the possible package being searched for that it's in
+  actuality a directory.
 
-- Issue #18416: importlib.machinery.PathFinder now treats '' as the cwd and
-  importlib.machinery.FileFinder no longer special-cases '' to '.'. This leads
-  to modules imported from cwd to now possess an absolute file path for
-  __file__ (this does not affect modules specified by path on the CLI but it
-  does affect -m/runpy). It also allows FileFinder to be more consistent by not
-  having an edge case.
+- bpo-18416: importlib.machinery.PathFinder now treats '' as the cwd and
+  importlib.machinery.FileFinder no longer special-cases '' to '.'. This
+  leads to modules imported from cwd to now possess an absolute file path
+  for __file__ (this does not affect modules specified by path on the CLI
+  but it does affect -m/runpy). It also allows FileFinder to be more
+  consistent by not having an edge case.
 
-- Issue #4555: All exported C symbols are now prefixed with either
-  "Py" or "_Py".
+- bpo-4555: All exported C symbols are now prefixed with either "Py" or
+  "_Py".
 
-- Issue #19219: Speed up marshal.loads(), and make pyc files slightly
-  (5% to 10%) smaller.
+- bpo-19219: Speed up marshal.loads(), and make pyc files slightly (5% to
+  10%) smaller.
 
-- Issue #19221: Upgrade Unicode database to version 6.3.0.
+- bpo-19221: Upgrade Unicode database to version 6.3.0.
 
-- Issue #16742: The result of the C callback PyOS_ReadlineFunctionPointer must
-  now be a string allocated by PyMem_RawMalloc() or PyMem_RawRealloc() (or NULL
-  if an error occurred), instead of a string allocated by PyMem_Malloc() or
-  PyMem_Realloc().
+- bpo-16742: The result of the C callback PyOS_ReadlineFunctionPointer must
+  now be a string allocated by PyMem_RawMalloc() or PyMem_RawRealloc() (or
+  NULL if an error occurred), instead of a string allocated by
+  PyMem_Malloc() or PyMem_Realloc().
 
-- Issue #19199: Remove ``PyThreadState.tick_counter`` field
+- bpo-19199: Remove ``PyThreadState.tick_counter`` field
 
 - Fix macro expansion of _PyErr_OCCURRED(), and make sure to use it in at
   least one place so as to avoid regressions.
 
-- Issue #19087: Improve bytearray allocation in order to allow cheap popping
-  of data at the front (slice deletion).
+- bpo-19087: Improve bytearray allocation in order to allow cheap popping of
+  data at the front (slice deletion).
 
-- Issue #19014: memoryview.cast() is now allowed on zero-length views.
+- bpo-19014: memoryview.cast() is now allowed on zero-length views.
 
-- Issue #18690: memoryview is now automatically registered with
+- bpo-18690: memoryview is now automatically registered with
   collections.abc.Sequence
 
-- Issue #19078: memoryview now correctly supports the reversed builtin
-  (Patch by Claudiu Popa)
+- bpo-19078: memoryview now correctly supports the reversed builtin (Patch
+  by Claudiu Popa)
 
 Library
 -------
 
-- Issue #17457: unittest test discovery now works with namespace packages.
+- bpo-17457: unittest test discovery now works with namespace packages.
   Patch by Claudiu Popa.
 
-- Issue #18235: Fix the sysconfig variables LDSHARED and BLDSHARED under AIX.
+- bpo-18235: Fix the sysconfig variables LDSHARED and BLDSHARED under AIX.
   Patch by David Edelsohn.
 
-- Issue #18606: Add the new "statistics" module (PEP 450).  Contributed
-  by Steven D'Aprano.
+- bpo-18606: Add the new "statistics" module (PEP 450).  Contributed by
+  Steven D'Aprano.
 
-- Issue #12866: The audioop module now supports 24-bit samples.
+- bpo-12866: The audioop module now supports 24-bit samples.
 
-- Issue #19254: Provide an optimized Python implementation of pbkdf2_hmac.
+- bpo-19254: Provide an optimized Python implementation of pbkdf2_hmac.
 
-- Issues #19201, Issue #19222, Issue #19223: Add "x" mode (exclusive creation)
-  in opening file to bz2, gzip and lzma modules. Patches by Tim Heaney and
-  Vajrasky Kok.
+- bpo-19201: Add "x" mode (exclusive creation) in opening file to bz2, gzip
+  and lzma modules. Patches by Tim Heaney and Vajrasky Kok. (See also:
+  bpo-19222, bpo-19223)
 
 - Fix a reference count leak in _sre.
 
-- Issue #19262: Initial check in of the 'asyncio' package (a.k.a. Tulip,
-  a.k.a. PEP 3156).  There are no docs yet, and the PEP is slightly
-  out of date with the code.  This module will have *provisional* status
-  in Python 3.4.
+- bpo-19262: Initial check in of the 'asyncio' package (a.k.a. Tulip, a.k.a.
+  PEP 3156). There are no docs yet, and the PEP is slightly out of date with
+  the code. This module will have *provisional* status in Python 3.4.
 
-- Issue #19276: Fixed the wave module on 64-bit big-endian platforms.
+- bpo-19276: Fixed the wave module on 64-bit big-endian platforms.
 
-- Issue #19266: Rename the new-in-3.4 ``contextlib.ignore`` context manager
-  to ``contextlib.suppress`` in order to be more consistent with existing
+- bpo-19266: Rename the new-in-3.4 ``contextlib.ignore`` context manager to
+  ``contextlib.suppress`` in order to be more consistent with existing
   descriptions of that operation elsewhere in the language and standard
   library documentation (Patch by Zero Piraeus).
 
-- Issue #18891: Completed the new email package (provisional) API additions
-  by adding new classes EmailMessage, MIMEPart, and ContentManager.
+- bpo-18891: Completed the new email package (provisional) API additions by
+  adding new classes EmailMessage, MIMEPart, and ContentManager.
 
-- Issue #18281: Unused stat constants removed from `tarfile`.
+- bpo-18281: Unused stat constants removed from `tarfile`.
 
-- Issue #18999: Multiprocessing now supports 'contexts' with the same API
-  as the module, but bound to specified start methods.
+- bpo-18999: Multiprocessing now supports 'contexts' with the same API as
+  the module, but bound to specified start methods.
 
-- Issue #18468: The re.split, re.findall, and re.sub functions and the group()
+- bpo-18468: The re.split, re.findall, and re.sub functions and the group()
   and groups() methods of match object now always return a string or a bytes
   object.
 
-- Issue #18725: The textwrap module now supports truncating multiline text.
+- bpo-18725: The textwrap module now supports truncating multiline text.
 
-- Issue #18776: atexit callbacks now display their full traceback when they
+- bpo-18776: atexit callbacks now display their full traceback when they
   raise an exception.
 
-- Issue #17827: Add the missing documentation for ``codecs.encode`` and
+- bpo-17827: Add the missing documentation for ``codecs.encode`` and
   ``codecs.decode``.
 
-- Issue #19218: Rename collections.abc to _collections_abc in order to
-  speed up interpreter start.
+- bpo-19218: Rename collections.abc to _collections_abc in order to speed up
+  interpreter start.
 
-- Issue #18582: Add 'pbkdf2_hmac' to the hashlib module. It implements PKCS#5
-  password-based key derivation functions with HMAC as pseudorandom function.
+- bpo-18582: Add 'pbkdf2_hmac' to the hashlib module. It implements PKCS#5
+  password-based key derivation functions with HMAC as pseudorandom
+  function.
 
-- Issue #19131: The aifc module now correctly reads and writes sampwidth of
+- bpo-19131: The aifc module now correctly reads and writes sampwidth of
   compressed streams.
 
-- Issue #19209: Remove import of copyreg from the os module to speed up
+- bpo-19209: Remove import of copyreg from the os module to speed up
   interpreter startup. stat_result and statvfs_result are now hard-coded to
   reside in the os module.
 
-- Issue #19205: Don't import the 're' module in site and sysconfig module to
+- bpo-19205: Don't import the 're' module in site and sysconfig module to
   speed up interpreter start.
 
-- Issue #9548: Add a minimal "_bootlocale" module that is imported by the
-  _io module instead of the full locale module.
+- bpo-9548: Add a minimal "_bootlocale" module that is imported by the _io
+  module instead of the full locale module.
 
-- Issue #18764: Remove the 'print' alias for the PDB 'p' command so that it no
+- bpo-18764: Remove the 'print' alias for the PDB 'p' command so that it no
   longer shadows the print function.
 
-- Issue #19158: A rare race in BoundedSemaphore could allow .release() too
+- bpo-19158: A rare race in BoundedSemaphore could allow .release() too
   often.
 
-- Issue #15805: Add contextlib.redirect_stdout().
+- bpo-15805: Add contextlib.redirect_stdout().
 
-- Issue #18716: Deprecate the formatter module.
+- bpo-18716: Deprecate the formatter module.
 
-- Issue #10712: 2to3 has a new "asserts" fixer that replaces deprecated names
+- bpo-10712: 2to3 has a new "asserts" fixer that replaces deprecated names
   of unittest methods (e.g. failUnlessEqual -> assertEqual).
 
-- Issue #18037: 2to3 now escapes ``'\u'`` and ``'\U'`` in native strings.
+- bpo-18037: 2to3 now escapes ``'\u'`` and ``'\U'`` in native strings.
 
-- Issue #17839: base64.decodebytes and base64.encodebytes now accept any
-  object that exports a 1 dimensional array of bytes (this means the same
-  is now also true for base64_codec)
+- bpo-17839: base64.decodebytes and base64.encodebytes now accept any object
+  that exports a 1 dimensional array of bytes (this means the same is now
+  also true for base64_codec)
 
-- Issue #19132: The pprint module now supports compact mode.
+- bpo-19132: The pprint module now supports compact mode.
 
-- Issue #19137: The pprint module now correctly formats instances of set and
+- bpo-19137: The pprint module now correctly formats instances of set and
   frozenset subclasses.
 
-- Issue #10042: functools.total_ordering now correctly handles
-  NotImplemented being returned by the underlying comparison function (Patch
-  by Katie Miller)
+- bpo-10042: functools.total_ordering now correctly handles NotImplemented
+  being returned by the underlying comparison function (Patch by Katie
+  Miller)
 
-- Issue #19092: contextlib.ExitStack now correctly reraises exceptions
-  from the __exit__ callbacks of inner context managers (Patch by Hrvoje
-  Nikšić)
+- bpo-19092: contextlib.ExitStack now correctly reraises exceptions from the
+  __exit__ callbacks of inner context managers (Patch by Hrvoje Nikšić)
 
-- Issue #12641: Avoid passing "-mno-cygwin" to the mingw32 compiler, except
-  when necessary.  Patch by Oscar Benjamin.
+- bpo-12641: Avoid passing "-mno-cygwin" to the mingw32 compiler, except
+  when necessary. Patch by Oscar Benjamin.
 
-- Issue #5845: In site.py, only load readline history from ~/.python_history
-  if no history has been read already.  This avoids double writes to the
+- bpo-5845: In site.py, only load readline history from ~/.python_history if
+  no history has been read already.  This avoids double writes to the
   history file at shutdown.
 
 - Properly initialize all fields of a SSL object after allocation.
 
-- Issue #19095: SSLSocket.getpeercert() now raises ValueError when the
-  SSL handshake hasn't been done.
+- bpo-19095: SSLSocket.getpeercert() now raises ValueError when the SSL
+  handshake hasn't been done.
 
-- Issue #4366: Fix building extensions on all platforms when --enable-shared
-  is used.
+- bpo-4366: Fix building extensions on all platforms when --enable-shared is
+  used.
 
-- Issue #19030: Fixed `inspect.getmembers` and `inspect.classify_class_attrs`
+- bpo-19030: Fixed `inspect.getmembers` and `inspect.classify_class_attrs`
   to attempt activating descriptors before falling back to a __dict__ search
   for faulty descriptors.  `inspect.classify_class_attrs` no longer returns
   Attributes whose home class is None.
@@ -3856,9 +3940,9 @@ Library
 C API
 -----
 
-- Issue #1772673: The type of `char*` arguments now changed to `const char*`.
+- bpo-1772673: The type of `char*` arguments now changed to `const char*`.
 
-- Issue #16129: Added a `Py_SetStandardStreamEncoding` pre-initialization API
+- bpo-16129: Added a `Py_SetStandardStreamEncoding` pre-initialization API
   to allow embedding applications like Blender to force a particular
   encoding and error handler for the standard IO streams (initial patch by
   Bastien Montagne)
@@ -3866,415 +3950,415 @@ C API
 Tests
 -----
 
-- Issue #19275: Fix test_site on AMD64 Snow Leopard
+- bpo-19275: Fix test_site on AMD64 Snow Leopard
 
-- Issue #14407: Fix unittest test discovery in test_concurrent_futures.
+- bpo-14407: Fix unittest test discovery in test_concurrent_futures.
 
-- Issue #18919: Unified and extended tests for audio modules: aifc, sunau and
+- bpo-18919: Unified and extended tests for audio modules: aifc, sunau and
   wave.
 
-- Issue #18714: Added tests for ``pdb.find_function()``.
+- bpo-18714: Added tests for ``pdb.find_function()``.
 
 Documentation
 -------------
 
-- Issue #18758: Fixed and improved cross-references.
+- bpo-18758: Fixed and improved cross-references.
 
-- Issue #18972: Modernize email examples and use the argparse module in them.
+- bpo-18972: Modernize email examples and use the argparse module in them.
 
 Build
 -----
 
-- Issue #19130: Correct PCbuild/readme.txt, Python 3.3 and 3.4 require VS 2010.
+- bpo-19130: Correct PCbuild/readme.txt, Python 3.3 and 3.4 require VS 2010.
 
-- Issue #15663: Update OS X 10.6+ installer to use Tcl/Tk 8.5.15.
+- bpo-15663: Update OS X 10.6+ installer to use Tcl/Tk 8.5.15.
 
-- Issue #14499: Fix several problems with OS X universal build support:
-    1. ppc arch detection for extension module builds broke with Xcode 5
-    2. ppc arch detection in configure did not work on OS X 10.4
-    3. -sysroot and -arch flags were unnecessarily duplicated
-    4. there was no obvious way to configure an intel-32 only build.
+- bpo-14499: Fix several problems with OS X universal build support:   1.
+  ppc arch detection for extension module builds broke with Xcode 5   2. ppc
+  arch detection in configure did not work on OS X 10.4   3. -sysroot and
+  -arch flags were unnecessarily duplicated   4. there was no obvious way to
+  configure an intel-32 only build.
 
-- Issue #19019: Change the OS X installer build script to use CFLAGS instead
-  of OPT for special build options.  By setting OPT, some compiler-specific
+- bpo-19019: Change the OS X installer build script to use CFLAGS instead of
+  OPT for special build options.  By setting OPT, some compiler-specific
   options like -fwrapv were overridden and thus not used, which could result
   in broken interpreters when building with clang.
 
 
-What's New in Python 3.4.0 Alpha 3?
+What's New in Python 3.4.0 alpha 3?
 ===================================
 
-Release date: 2013-09-29
+*Release date: 2013-09-29*
 
 Core and Builtins
 -----------------
 
-- Issue #18818: The "encodingname" part of PYTHONIOENCODING is now optional.
+- bpo-18818: The "encodingname" part of PYTHONIOENCODING is now optional.
 
-- Issue #19098: Prevent overflow in the compiler when the recursion limit is set
-  absurdly high.
+- bpo-19098: Prevent overflow in the compiler when the recursion limit is
+  set absurdly high.
 
 Library
 -------
 
-- Issue #18929: `inspect.classify_class_attrs()` now correctly finds class
+- bpo-18929: `inspect.classify_class_attrs()` now correctly finds class
   attributes returned by `dir()` that are located in the metaclass.
 
-- Issue #18950: Fix miscellaneous bugs in the sunau module.
+- bpo-18950: Fix miscellaneous bugs in the sunau module.
   Au_read.readframes() now updates current file position and reads correct
   number of frames from multichannel stream.  Au_write.writeframesraw() now
-  correctly updates current file position.  Au_read.getnframes() now returns an
-  integer (as in Python 2).  Au_read and Au_write now correctly works with file
-  object if start file position is not a zero.
+  correctly updates current file position.  Au_read.getnframes() now returns
+  an integer (as in Python 2). Au_read and Au_write now correctly works with
+  file object if start file position is not a zero.
 
-- Issue #18594: The fast path for collections.Counter() was never taken
-  due to an over-restrictive type check.
+- bpo-18594: The fast path for collections.Counter() was never taken due to
+  an over- restrictive type check.
 
-- Issue #19053: ZipExtFile.read1() with non-zero argument no more returns empty
+- bpo-19053: ZipExtFile.read1() with non-zero argument no more returns empty
   bytes until end of data.
 
 - logging: added support for Unix domain sockets to SocketHandler and
   DatagramHandler.
 
-- Issue #18996: TestCase.assertEqual() now more cleverly shorten differing
+- bpo-18996: TestCase.assertEqual() now more cleverly shorten differing
   strings in error report.
 
-- Issue #19034: repr() for tkinter.Tcl_Obj now exposes string reperesentation.
+- bpo-19034: repr() for tkinter.Tcl_Obj now exposes string reperesentation.
 
-- Issue #18978: ``urllib.request.Request`` now allows the method to be
+- bpo-18978: ``urllib.request.Request`` now allows the method to be
   indicated on the class and no longer sets it to None in ``__init__``.
 
-- Issue #18626: the inspect module now offers a basic command line
+- bpo-18626: the inspect module now offers a basic command line
   introspection interface (Initial patch by Claudiu Popa)
 
-- Issue #3015: Fixed tkinter with wantobject=False.  Any Tcl command call
+- bpo-3015: Fixed tkinter with wantobject=False.  Any Tcl command call
   returned empty string.
 
-- Issue #19037: The mailbox module now makes all changes to maildir files
-  before moving them into place, to avoid race conditions with other programs
-  that may be accessing the maildir directory.
+- bpo-19037: The mailbox module now makes all changes to maildir files
+  before moving them into place, to avoid race conditions with other
+  programs that may be accessing the maildir directory.
 
-- Issue #14984: On POSIX systems, when netrc is called without a filename
+- bpo-14984: On POSIX systems, when netrc is called without a filename
   argument (and therefore is reading the user's $HOME/.netrc file), it now
-  enforces the same security rules as typical ftp clients: the .netrc file must
-  be owned by the user that owns the process and must not be readable by any
-  other user.
+  enforces the same security rules as typical ftp clients: the .netrc file
+  must be owned by the user that owns the process and must not be readable
+  by any other user.
 
-- Issue #18873: The tokenize module now detects Python source code encoding
+- bpo-18873: The tokenize module now detects Python source code encoding
   only in comment lines.
 
-- Issue #17764: Enable http.server to bind to a user specified network
+- bpo-17764: Enable http.server to bind to a user specified network
   interface.  Patch contributed by Malte Swart.
 
-- Issue #18937: Add an assertLogs() context manager to unittest.TestCase
-  to ensure that a block of code emits a message using the logging module.
+- bpo-18937: Add an assertLogs() context manager to unittest.TestCase to
+  ensure that a block of code emits a message using the logging module.
 
-- Issue #17324: Fix http.server's request handling case on trailing '/'. Patch
+- bpo-17324: Fix http.server's request handling case on trailing '/'. Patch
   contributed by Vajrasky Kok.
 
-- Issue #19018: The heapq.merge() function no longer suppresses IndexError
-  in the underlying iterables.
+- bpo-19018: The heapq.merge() function no longer suppresses IndexError in
+  the underlying iterables.
 
-- Issue #18784: The uuid module no longer attempts to load libc via ctypes.CDLL
-  if all the necessary functions have already been found in libuuid.  Patch by
-  Evgeny Sologubov.
+- bpo-18784: The uuid module no longer attempts to load libc via ctypes.CDLL
+  if all the necessary functions have already been found in libuuid.  Patch
+  by Evgeny Sologubov.
 
 - The :envvar:`PYTHONFAULTHANDLER` environment variable now only enables the
-  faulthandler module if the variable is non-empty. Same behaviour than other
-  variables like :envvar:`PYTHONDONTWRITEBYTECODE`.
+  faulthandler module if the variable is non-empty. Same behaviour than
+  other variables like :envvar:`PYTHONDONTWRITEBYTECODE`.
 
-- Issue #1565525: New function ``traceback.clear_frames`` will clear
-  the local variables of all the stack frames referenced by a traceback
-  object.
+- bpo-1565525: New function ``traceback.clear_frames`` will clear the local
+  variables of all the stack frames referenced by a traceback object.
 
 Tests
 -----
 
-- Issue #18952: Fix regression in support data downloads introduced when
+- bpo-18952: Fix regression in support data downloads introduced when
   test.support was converted to a package. Regression noticed by Zachary
   Ware.
 
 IDLE
 ----
 
-- Issue #18873: IDLE now detects Python source code encoding only in comment
+- bpo-18873: IDLE now detects Python source code encoding only in comment
   lines.
 
-- Issue #18988: The "Tab" key now works when a word is already autocompleted.
+- bpo-18988: The "Tab" key now works when a word is already autocompleted.
 
 Documentation
 -------------
 
-- Issue #17003: Unified the size argument names in the io module with common
+- bpo-17003: Unified the size argument names in the io module with common
   practice.
 
 Build
 -----
 
-- Issue #18596: Support the use of address sanity checking in recent versions
+- bpo-18596: Support the use of address sanity checking in recent versions
   of clang and GCC by appropriately marking known false alarms in the small
   object allocator. Patch contributed by Dhiru Kholia.
 
 Tools/Demos
 -----------
 
-- Issue #18873: 2to3 and the findnocoding.py script now detect Python source
+- bpo-18873: 2to3 and the findnocoding.py script now detect Python source
   code encoding only in comment lines.
 
 
-What's New in Python 3.4.0 Alpha 2?
+What's New in Python 3.4.0 alpha 2?
 ===================================
 
-Release date: 2013-09-09
+*Release date: 2013-09-09*
 
 Core and Builtins
 -----------------
 
-- Issue #18942: sys._debugmallocstats() output was damaged on Windows.
+- bpo-18942: sys._debugmallocstats() output was damaged on Windows.
 
-- Issue #18571: Implementation of the PEP 446: file descriptors and file
+- bpo-18571: Implementation of the PEP 446: file descriptors and file
   handles are now created non-inheritable; add functions
   os.get/set_inheritable(), os.get/set_handle_inheritable() and
   socket.socket.get/set_inheritable().
 
-- Issue #11619: The parser and the import machinery do not encode Unicode
+- bpo-11619: The parser and the import machinery do not encode Unicode
   filenames anymore on Windows.
 
-- Issue #18808: Non-daemon threads are now automatically joined when
-  a sub-interpreter is shutdown (it would previously dump a fatal error).
+- bpo-18808: Non-daemon threads are now automatically joined when a sub-
+  interpreter is shutdown (it would previously dump a fatal error).
 
 - Remove support for compiling on systems without getcwd().
 
-- Issue #18774: Remove last bits of GNU PTH thread code and thread_pth.h.
+- bpo-18774: Remove last bits of GNU PTH thread code and thread_pth.h.
 
-- Issue #18771: Add optimization to set object lookups to reduce the cost
-  of hash collisions.  The core idea is to inspect a second key/hash pair
-  for each cache line retrieved.
+- bpo-18771: Add optimization to set object lookups to reduce the cost of
+  hash collisions.  The core idea is to inspect a second key/hash pair for
+  each cache line retrieved.
 
-- Issue #16105: When a signal handler fails to write to the file descriptor
-  registered with ``signal.set_wakeup_fd()``, report an exception instead
-  of ignoring the error.
+- bpo-16105: When a signal handler fails to write to the file descriptor
+  registered with ``signal.set_wakeup_fd()``, report an exception instead of
+  ignoring the error.
 
-- Issue #18722: Remove uses of the "register" keyword in C code.
+- bpo-18722: Remove uses of the "register" keyword in C code.
 
-- Issue #18667: Add missing "HAVE_FCHOWNAT" symbol to posix._have_functions.
+- bpo-18667: Add missing "HAVE_FCHOWNAT" symbol to posix._have_functions.
 
-- Issue #16499: Add command line option for isolated mode.
+- bpo-16499: Add command line option for isolated mode.
 
-- Issue #15301: Parsing fd, uid, and gid parameters for builtins
-  in Modules/posixmodule.c is now far more robust.
+- bpo-15301: Parsing fd, uid, and gid parameters for builtins in
+  Modules/posixmodule.c is now far more robust.
 
-- Issue #18368: PyOS_StdioReadline() no longer leaks memory when realloc()
+- bpo-18368: PyOS_StdioReadline() no longer leaks memory when realloc()
   fail.
 
-- Issue #17934: Add a clear() method to frame objects, to help clean up
+- bpo-17934: Add a clear() method to frame objects, to help clean up
   expensive details (local variables) and break reference cycles.
 
-- Issue #18780: %-formatting codes %d, %i, and %u now treat int-subclasses
-  as int (displays value of int-subclass instead of str(int-subclass) ).
+- bpo-18780: %-formatting codes %d, %i, and %u now treat int-subclasses as
+  int (displays value of int-subclass instead of str(int-subclass) ).
 
 Library
 -------
 
-- Issue #18808: Thread.join() now waits for the underlying thread state to
-  be destroyed before returning.  This prevents unpredictable aborts in
+- bpo-18808: Thread.join() now waits for the underlying thread state to be
+  destroyed before returning.  This prevents unpredictable aborts in
   Py_EndInterpreter() when some non-daemon threads are still running.
 
-- Issue #18458: Prevent crashes with newer versions of libedit.  Its readline
+- bpo-18458: Prevent crashes with newer versions of libedit.  Its readline
   emulation has changed from 0-based indexing to 1-based like gnu readline.
 
-- Issue #18852: Handle case of ``readline.__doc__`` being ``None`` in the new
+- bpo-18852: Handle case of ``readline.__doc__`` being ``None`` in the new
   readline activation code in ``site.py``.
 
-- Issue #18672: Fixed format specifiers for Py_ssize_t in debugging output in
+- bpo-18672: Fixed format specifiers for Py_ssize_t in debugging output in
   the _sre module.
 
-- Issue #18830: inspect.getclasstree() no longer produces duplicate entries even
-  when input list contains duplicates.
+- bpo-18830: inspect.getclasstree() no longer produces duplicate entries
+  even when input list contains duplicates.
 
-- Issue #18878: sunau.open now supports the context management protocol.  Based on
-  patches by Claudiu Popa and R. David Murray.
+- bpo-18878: sunau.open now supports the context management protocol.  Based
+  on patches by Claudiu Popa and R. David Murray.
 
-- Issue #18909: Fix _tkinter.tkapp.interpaddr() on Windows 64-bit, don't cast
+- bpo-18909: Fix _tkinter.tkapp.interpaddr() on Windows 64-bit, don't cast
   64-bit pointer to long (32 bits).
 
-- Issue #18876: The FileIO.mode attribute now better reflects the actual mode
+- bpo-18876: The FileIO.mode attribute now better reflects the actual mode
   under which the file was opened.  Patch by Erik Bray.
 
-- Issue #16853: Add new selectors module.
+- bpo-16853: Add new selectors module.
 
-- Issue #18882: Add threading.main_thread() function.
+- bpo-18882: Add threading.main_thread() function.
 
-- Issue #18901: The sunau getparams method now returns a namedtuple rather than
+- bpo-18901: The sunau getparams method now returns a namedtuple rather than
   a plain tuple.  Patch by Claudiu Popa.
 
-- Issue #17487: The result of the wave getparams method now is pickleable again.
-  Patch by Claudiu Popa.
+- bpo-17487: The result of the wave getparams method now is pickleable
+  again. Patch by Claudiu Popa.
 
-- Issue #18756: os.urandom() now uses a lazily-opened persistent file
+- bpo-18756: os.urandom() now uses a lazily-opened persistent file
   descriptor, so as to avoid using many file descriptors when run in
   parallel from multiple threads.
 
-- Issue #18418: After fork(), reinit all threads states, not only active ones.
+- bpo-18418: After fork(), reinit all threads states, not only active ones.
   Patch by A. Jesse Jiryu Davis.
 
-- Issue #17974: Switch unittest from using getopt to using argparse.
+- bpo-17974: Switch unittest from using getopt to using argparse.
 
-- Issue #11798: TestSuite now drops references to own tests after execution.
+- bpo-11798: TestSuite now drops references to own tests after execution.
 
-- Issue #16611: http.cookie now correctly parses the 'secure' and 'httponly'
+- bpo-16611: http.cookie now correctly parses the 'secure' and 'httponly'
   cookie flags.
 
-- Issue #11973: Fix a problem in kevent. The flags and fflags fields are now
+- bpo-11973: Fix a problem in kevent. The flags and fflags fields are now
   properly handled as unsigned.
 
-- Issue #18807: ``pyvenv`` now takes a --copies argument allowing copies
+- bpo-18807: ``pyvenv`` now takes a --copies argument allowing copies
   instead of symlinks even where symlinks are available and the default.
 
-- Issue #18538: ``python -m dis`` now uses argparse for argument processing.
+- bpo-18538: ``python -m dis`` now uses argparse for argument processing.
   Patch by Michele Orrù.
 
-- Issue #18394: Close cgi.FieldStorage's optional file.
+- bpo-18394: Close cgi.FieldStorage's optional file.
 
-- Issue #17702: On error, os.environb now suppresses the exception context
-  when raising a new KeyError with the original key.
+- bpo-17702: On error, os.environb now suppresses the exception context when
+  raising a new KeyError with the original key.
 
-- Issue #16809: Fixed some tkinter incompabilities with Tcl/Tk 8.6.
+- bpo-16809: Fixed some tkinter incompabilities with Tcl/Tk 8.6.
 
-- Issue #16809: Tkinter's splitlist() and split() methods now accept Tcl_Obj
+- bpo-16809: Tkinter's splitlist() and split() methods now accept Tcl_Obj
   argument.
 
-- Issue #18324: set_payload now correctly handles binary input.  This also
+- bpo-18324: set_payload now correctly handles binary input.  This also
   supersedes the previous fixes for #14360, #1717, and #16564.
 
-- Issue #18794: Add a fileno() method and a closed attribute to select.devpoll
+- bpo-18794: Add a fileno() method and a closed attribute to select.devpoll
   objects.
 
-- Issue #17119: Fixed integer overflows when processing large strings and tuples
-  in the tkinter module.
+- bpo-17119: Fixed integer overflows when processing large strings and
+  tuples in the tkinter module.
 
-- Issue #18747: Re-seed OpenSSL's pseudo-random number generator after fork.
-  pthread_atfork() parent handler is used to seed the PRNG with pid, time
+- bpo-18747: Re-seed OpenSSL's pseudo-random number generator after fork. A
+  pthread_atfork() parent handler is used to seed the PRNG with pid, time
   and some stack data.
 
-- Issue #8865: Concurrent invocation of select.poll.poll() now raises a
+- bpo-8865: Concurrent invocation of select.poll.poll() now raises a
   RuntimeError exception.  Patch by Christian Schubert.
 
-- Issue #18777: The ssl module now uses the new CRYPTO_THREADID API of
-  OpenSSL 1.0.0+ instead of the deprecated CRYPTO id callback function.
+- bpo-18777: The ssl module now uses the new CRYPTO_THREADID API of OpenSSL
+  1.0.0+ instead of the deprecated CRYPTO id callback function.
 
-- Issue #18768: Correct doc string of RAND_edg(). Patch by Vajrasky Kok.
+- bpo-18768: Correct doc string of RAND_edg(). Patch by Vajrasky Kok.
 
-- Issue #18178: Fix ctypes on BSD. dlmalloc.c was compiled twice which broke
+- bpo-18178: Fix ctypes on BSD. dlmalloc.c was compiled twice which broke
   malloc weak symbols.
 
-- Issue #18709: Fix CVE-2013-4238. The SSL module now handles NULL bytes
-  inside subjectAltName correctly. Formerly the module has used OpenSSL's
+- bpo-18709: Fix CVE-2013-4238. The SSL module now handles NULL bytes inside
+  subjectAltName correctly. Formerly the module has used OpenSSL's
   GENERAL_NAME_print() function to get the string represention of ASN.1
   strings for ``rfc822Name`` (email), ``dNSName`` (DNS) and
   ``uniformResourceIdentifier`` (URI).
 
-- Issue #18701: Remove support of old CPython versions (<3.0) from C code.
+- bpo-18701: Remove support of old CPython versions (<3.0) from C code.
 
-- Issue #18756: Improve error reporting in os.urandom() when the failure
-  is due to something else than /dev/urandom not existing (for example,
-  exhausting the file descriptor limit).
+- bpo-18756: Improve error reporting in os.urandom() when the failure is due
+  to something else than /dev/urandom not existing (for example, exhausting
+  the file descriptor limit).
 
-- Issue #18673: Add O_TMPFILE to os module. O_TMPFILE requires Linux kernel
+- bpo-18673: Add O_TMPFILE to os module. O_TMPFILE requires Linux kernel
   3.11 or newer. It's only defined on system with 3.11 uapi headers, too.
 
-- Issue #18532: Change the builtin hash algorithms' names to lower case names
+- bpo-18532: Change the builtin hash algorithms' names to lower case names
   as promised by hashlib's documentation.
 
-- Issue #8713: add new spwan and forkserver start methods, and new functions
+- bpo-8713: add new spwan and forkserver start methods, and new functions
   get_all_start_methods, get_start_method, and set_start_method, to
   multiprocessing.
 
-- Issue #18405: Improve the entropy of crypt.mksalt().
+- bpo-18405: Improve the entropy of crypt.mksalt().
 
-- Issue #12015: The tempfile module now uses a suffix of 8 random characters
+- bpo-12015: The tempfile module now uses a suffix of 8 random characters
   instead of 6, to reduce the risk of filename collision. The entropy was
-  reduced when uppercase letters were removed from the charset used to generate
-  random characters.
+  reduced when uppercase letters were removed from the charset used to
+  generate random characters.
 
-- Issue #18585: Add :func:`textwrap.shorten` to collapse and truncate a
-  piece of text to a given length.
+- bpo-18585: Add :func:`textwrap.shorten` to collapse and truncate a piece
+  of text to a given length.
 
-- Issue #18598: Tweak exception message for importlib.import_module() to
+- bpo-18598: Tweak exception message for importlib.import_module() to
   include the module name when a key argument is missing.
 
-- Issue #19151: Fix docstring and use of _get_supported_file_loaders() to
+- bpo-19151: Fix docstring and use of _get_supported_file_loaders() to
   reflect 2-tuples.
 
-- Issue #19152: Add ExtensionFileLoader.get_filename().
+- bpo-19152: Add ExtensionFileLoader.get_filename().
 
-- Issue #18676: Change 'positive' to 'non-negative' in queue.py put and get
+- bpo-18676: Change 'positive' to 'non-negative' in queue.py put and get
   docstrings and ValueError messages. Patch by Zhongyue Luo
 
 - Fix refcounting issue with extension types in tkinter.
 
-- Issue #8112: xlmrpc.server's DocXMLRPCServer server no longer raises an error
+- bpo-8112: xlmrpc.server's DocXMLRPCServer server no longer raises an error
   if methods have annotations; it now correctly displays the annotations.
 
-- Issue #18600: Added policy argument to email.message.Message.as_string,
-  and as_bytes and __bytes__ methods to Message.
+- bpo-18600: Added policy argument to email.message.Message.as_string, and
+  as_bytes and __bytes__ methods to Message.
 
-- Issue #18671: Output more information when logging exceptions occur.
+- bpo-18671: Output more information when logging exceptions occur.
 
-- Issue #18621: Prevent the site module's patched builtins from keeping
-  too many references alive for too long.
+- bpo-18621: Prevent the site module's patched builtins from keeping too
+  many references alive for too long.
 
-- Issue #4885: Add weakref support to mmap objects.  Patch by Valerie Lambert.
+- bpo-4885: Add weakref support to mmap objects.  Patch by Valerie Lambert.
 
-- Issue #8860: Fixed rounding in timedelta constructor.
+- bpo-8860: Fixed rounding in timedelta constructor.
 
-- Issue #18849: Fixed a Windows-specific tempfile bug where collision with an
+- bpo-18849: Fixed a Windows-specific tempfile bug where collision with an
   existing directory caused mkstemp and related APIs to fail instead of
   retrying. Report and fix by Vlad Shcherbina.
 
-- Issue #18920: argparse's default destination for the version action (-v,
-  --version) has also been changed to stdout, to match the Python executable.
+- bpo-18920: argparse's default destination for the version action (-v,
+  --version) has also been changed to stdout, to match the Python
+  executable.
 
 Tests
 -----
 
-- Issue #18623: Factor out the _SuppressCoreFiles context manager into
+- bpo-18623: Factor out the _SuppressCoreFiles context manager into
   test.support.  Patch by Valerie Lambert.
 
-- Issue #12037: Fix test_email for desktop Windows.
+- bpo-12037: Fix test_email for desktop Windows.
 
-- Issue #15507: test_subprocess's test_send_signal could fail if the test
+- bpo-15507: test_subprocess's test_send_signal could fail if the test
   runner were run in an environment where the process inherited an ignore
-  setting for SIGINT.  Restore the SIGINT handler to the desired
+  setting for SIGINT. Restore the SIGINT handler to the desired
   KeyboardInterrupt raising one during that test.
 
-- Issue #16799: Switched from getopt to argparse style in regrtest's argument
-  parsing.  Added more tests for regrtest's argument parsing.
+- bpo-16799: Switched from getopt to argparse style in regrtest's argument
+  parsing. Added more tests for regrtest's argument parsing.
 
-- Issue #18792: Use "127.0.0.1" or "::1" instead of "localhost" as much as
+- bpo-18792: Use "127.0.0.1" or "::1" instead of "localhost" as much as
   possible, since "localhost" goes through a DNS lookup under recent Windows
   versions.
 
 IDLE
 ----
 
-- Issue #18489: Add tests for SearchEngine. Original patch by Phil Webster.
+- bpo-18489: Add tests for SearchEngine. Original patch by Phil Webster.
 
 Documentation
 -------------
 
-- Issue #18743: Fix references to non-existant "StringIO" module.
+- bpo-18743: Fix references to non-existant "StringIO" module.
 
-- Issue #18783: Removed existing mentions of Python long type in docstrings,
+- bpo-18783: Removed existing mentions of Python long type in docstrings,
   error messages and comments.
 
 Build
 -----
 
-- Issue #1584: Provide configure options to override default search paths for
+- bpo-1584: Provide configure options to override default search paths for
   Tcl and Tk when building _tkinter.
 
-- Issue #15663: Tcl/Tk 8.5.14 is now included with the OS X 10.6+ 64-/32-bit
+- bpo-15663: Tcl/Tk 8.5.14 is now included with the OS X 10.6+ 64-/32-bit
   installer.  It is no longer necessary to install a third-party version of
   Tcl/Tk 8.5 to work around the problems in the Apple-supplied Tcl/Tk 8.5
   shipped in OS X 10.6 and later releases.
@@ -4282,1378 +4366,1397 @@ Build
 Tools/Demos
 -----------
 
-- Issue #18922: Now The Lib/smtpd.py and Tools/i18n/msgfmt.py scripts write
+- bpo-18922: Now The Lib/smtpd.py and Tools/i18n/msgfmt.py scripts write
   their version strings to stdout, and not to sderr.
 
 
-What's New in Python 3.4.0 Alpha 1?
+What's New in Python 3.4.0 alpha 1?
 ===================================
 
-Release date: 2013-08-03
+*Release date: 2013-08-03*
 
 Core and Builtins
 -----------------
 
-- Issue #16741: Fix an error reporting in int().
+- bpo-16741: Fix an error reporting in int().
 
-- Issue #17899: Fix rare file descriptor leak in os.listdir().
+- bpo-17899: Fix rare file descriptor leak in os.listdir().
 
-- Issue #10241: Clear extension module dict copies at interpreter shutdown.
+- bpo-10241: Clear extension module dict copies at interpreter shutdown.
   Patch by Neil Schemenauer, minimally modified.
 
-- Issue #9035: ismount now recognises volumes mounted below a drive root
-  on Windows. Original patch by Atsuo Ishimoto.
+- bpo-9035: ismount now recognises volumes mounted below a drive root on
+  Windows. Original patch by Atsuo Ishimoto.
 
-- Issue #18214: Improve finalization of Python modules to avoid setting
-  their globals to None, in most cases.
+- bpo-18214: Improve finalization of Python modules to avoid setting their
+  globals to None, in most cases.
 
-- Issue #18112: PEP 442 implementation (safe object finalization).
+- bpo-18112: PEP 442 implementation (safe object finalization).
 
-- Issue #18552: Check return value of PyArena_AddPyObject() in
+- bpo-18552: Check return value of PyArena_AddPyObject() in
   obj2ast_object().
 
-- Issue #18560: Fix potential NULL pointer dereference in sum().
+- bpo-18560: Fix potential NULL pointer dereference in sum().
 
-- Issue #18520: Add a new PyStructSequence_InitType2() function, same than
-  PyStructSequence_InitType() except that it has a return value (0 on success,
-  -1 on error).
+- bpo-18520: Add a new PyStructSequence_InitType2() function, same than
+  PyStructSequence_InitType() except that it has a return value (0 on
+  success, -1 on error).
 
-- Issue #15905: Fix theoretical buffer overflow in handling of sys.argv[0],
+- bpo-15905: Fix theoretical buffer overflow in handling of sys.argv[0],
   prefix and exec_prefix if the operation system does not obey MAXPATHLEN.
 
-- Issue #18408: Fix many various bugs in code handling errors, especially
-  on memory allocation failure (MemoryError).
+- bpo-18408: Fix many various bugs in code handling errors, especially on
+  memory allocation failure (MemoryError).
 
-- Issue #18344: Fix potential ref-leaks in _bufferedreader_read_all().
+- bpo-18344: Fix potential ref-leaks in _bufferedreader_read_all().
 
-- Issue #18342: Use the repr of a module name when an import fails when using
+- bpo-18342: Use the repr of a module name when an import fails when using
   ``from ... import ...``.
 
-- Issue #17872: Fix a segfault in marshal.load() when input stream returns
-  more bytes than requested.
+- bpo-17872: Fix a segfault in marshal.load() when input stream returns more
+  bytes than requested.
 
-- Issue #18338: `python --version` now prints version string to stdout, and
-  not to stderr.  Patch by Berker Peksag and Michael Dickens.
+- bpo-18338: `python --version` now prints version string to stdout, and not
+  to stderr. Patch by Berker Peksag and Michael Dickens.
 
-- Issue #18426: Fix NULL pointer dereference in C extension import when
+- bpo-18426: Fix NULL pointer dereference in C extension import when
   PyModule_GetDef() returns an error.
 
-- Issue #17206: On Windows, increase the stack size from 2 MB to 4.2 MB to fix
+- bpo-17206: On Windows, increase the stack size from 2 MB to 4.2 MB to fix
   a stack overflow in the marshal module (fix a crash in test_marshal).
   Patch written by Jeremy Kloth.
 
-- Issue #3329: Implement the PEP 445: Add new APIs to customize Python memory
+- bpo-3329: Implement the PEP 445: Add new APIs to customize Python memory
   allocators.
 
-- Issue #18328: Reorder ops in PyThreadState_Delete*() functions. Now the
+- bpo-18328: Reorder ops in PyThreadState_Delete*() functions. Now the
   tstate is first removed from TLS and then deallocated.
 
-- Issue #13483: Use VirtualAlloc in obmalloc on Windows.
+- bpo-13483: Use VirtualAlloc in obmalloc on Windows.
 
-- Issue #18184: PyUnicode_FromFormat() and PyUnicode_FromFormatV() now raise
+- bpo-18184: PyUnicode_FromFormat() and PyUnicode_FromFormatV() now raise
   OverflowError when an argument of %c format is out of range.
 
-- Issue #18111: The min() and max() functions now support a default argument
-  to be returned instead of raising a ValueError on an empty sequence.
+- bpo-18111: The min() and max() functions now support a default argument to
+  be returned instead of raising a ValueError on an empty sequence.
   (Contributed by Julian Berman.)
 
-- Issue #18137: Detect integer overflow on precision in float.__format__()
-  and complex.__format__().
+- bpo-18137: Detect integer overflow on precision in float.__format__() and
+  complex.__format__().
 
-- Issue #18183: Fix various unicode operations on strings with large unicode
+- bpo-18183: Fix various unicode operations on strings with large unicode
   codepoints.
 
-- Issue #18180: Fix ref leak in _PyImport_GetDynLoadWindows().
+- bpo-18180: Fix ref leak in _PyImport_GetDynLoadWindows().
 
-- Issue #18038: SyntaxError raised during compilation sources with illegal
+- bpo-18038: SyntaxError raised during compilation sources with illegal
   encoding now always contains an encoding name.
 
-- Issue #17931: Resolve confusion on Windows between pids and process
-  handles.
+- bpo-17931: Resolve confusion on Windows between pids and process handles.
 
-- Tweak the exception message when the magic number or size value in a bytecode
-  file is truncated.
+- Tweak the exception message when the magic number or size value in a
+  bytecode file is truncated.
 
-- Issue #17932: Fix an integer overflow issue on Windows 64-bit in iterators:
+- bpo-17932: Fix an integer overflow issue on Windows 64-bit in iterators:
   change the C type of seqiterobject.it_index from long to Py_ssize_t.
 
-- Issue #18065: Don't set __path__ to the package name for frozen packages.
+- bpo-18065: Don't set __path__ to the package name for frozen packages.
 
-- Issue #18088: When reloading a module, unconditionally reset all relevant
-  attributes on the module (e.g. __name__, __loader__, __package__, __file__,
-  __cached__).
+- bpo-18088: When reloading a module, unconditionally reset all relevant
+  attributes on the module (e.g. __name__, __loader__, __package__,
+  __file__, __cached__).
 
-- Issue #17937: Try harder to collect cyclic garbage at shutdown.
+- bpo-17937: Try harder to collect cyclic garbage at shutdown.
 
-- Issue #12370: Prevent class bodies from interfering with the __class__
+- bpo-12370: Prevent class bodies from interfering with the __class__
   closure.
 
-- Issue #17644: Fix a crash in str.format when curly braces are used in square
+- bpo-17644: Fix a crash in str.format when curly braces are used in square
   brackets.
 
-- Issue #17237: Fix crash in the ASCII decoder on m68k.
+- bpo-17237: Fix crash in the ASCII decoder on m68k.
 
-- Issue #17927: Frame objects kept arguments alive if they had been
-  copied into a cell, even if the cell was cleared.
+- bpo-17927: Frame objects kept arguments alive if they had been copied into
+  a cell, even if the cell was cleared.
 
-- Issue #1545463: At shutdown, defer finalization of codec modules so
-  that stderr remains usable.
+- bpo-1545463: At shutdown, defer finalization of codec modules so that
+  stderr remains usable.
 
-- Issue #7330: Implement width and precision (ex: "%5.3s") for the format
-  string of PyUnicode_FromFormat() function, original patch written by Ysj Ray.
+- bpo-7330: Implement width and precision (ex: "%5.3s") for the format
+  string of PyUnicode_FromFormat() function, original patch written by Ysj
+  Ray.
 
-- Issue #1545463: Global variables caught in reference cycles are now
-  garbage-collected at shutdown.
+- bpo-1545463: Global variables caught in reference cycles are now garbage-
+  collected at shutdown.
 
-- Issue #17094: Clear stale thread states after fork().  Note that this
-  is a potentially disruptive change since it may release some system
-  resources which would otherwise remain perpetually alive (e.g. database
-  connections kept in thread-local storage).
+- bpo-17094: Clear stale thread states after fork().  Note that this is a
+  potentially disruptive change since it may release some system resources
+  which would otherwise remain perpetually alive (e.g. database connections
+  kept in thread-local storage).
 
-- Issue #17408: Avoid using an obsolete instance of the copyreg module when
-  the interpreter is shutdown and then started again.
+- bpo-17408: Avoid using an obsolete instance of the copyreg module when the
+  interpreter is shutdown and then started again.
 
-- Issue #5845: Enable tab-completion in the interactive interpreter by
-  default, thanks to a new sys.__interactivehook__.
+- bpo-5845: Enable tab-completion in the interactive interpreter by default,
+  thanks to a new sys.__interactivehook__.
 
-- Issue #17115,17116: Module initialization now includes setting __package__ and
-  __loader__ attributes to None.
+- bpo-17115: Module initialization now includes setting __package__ and
+  __loader__ attributes to None. (See also: bpo-17116)
 
-- Issue #17853: Ensure locals of a class that shadow free variables always win
+- bpo-17853: Ensure locals of a class that shadow free variables always win
   over the closures.
 
-- Issue #17863: In the interactive console, don't loop forever if the encoding
+- bpo-17863: In the interactive console, don't loop forever if the encoding
   can't be fetched from stdin.
 
-- Issue #17867: Raise an ImportError if __import__ is not found in __builtins__.
+- bpo-17867: Raise an ImportError if __import__ is not found in
+  __builtins__.
 
-- Issue #18698: Ensure importlib.reload() returns the module out of sys.modules.
+- bpo-18698: Ensure importlib.reload() returns the module out of
+  sys.modules.
 
-- Issue #17857: Prevent build failures with pre-3.5.0 versions of sqlite3,
-  such as was shipped with Centos 5 and Mac OS X 10.4.
+- bpo-17857: Prevent build failures with pre-3.5.0 versions of sqlite3, such
+  as was shipped with Centos 5 and Mac OS X 10.4.
 
-- Issue #17413: sys.settrace callbacks were being passed a string instead of an
-  exception instance for the 'value' element of the arg tuple if the exception
-  originated from C code; now an exception instance is always provided.
+- bpo-17413: sys.settrace callbacks were being passed a string instead of an
+  exception instance for the 'value' element of the arg tuple if the
+  exception originated from C code; now an exception instance is always
+  provided.
 
-- Issue #17782: Fix undefined behaviour on platforms where
-  ``struct timespec``'s "tv_nsec" member is not a C long.
+- bpo-17782: Fix undefined behaviour on platforms where ``struct
+  timespec``'s "tv_nsec" member is not a C long.
 
-- Issue #17722: When looking up __round__, resolve descriptors.
+- bpo-17722: When looking up __round__, resolve descriptors.
 
-- Issue #16061: Speed up str.replace() for replacing 1-character strings.
+- bpo-16061: Speed up str.replace() for replacing 1-character strings.
 
-- Issue #17715: Fix segmentation fault from raising an exception in a __trunc__
+- bpo-17715: Fix segmentation fault from raising an exception in a __trunc__
   method.
 
-- Issue #17643: Add __callback__ attribute to weakref.ref.
+- bpo-17643: Add __callback__ attribute to weakref.ref.
 
-- Issue #16447: Fixed potential segmentation fault when setting __name__ on a
+- bpo-16447: Fixed potential segmentation fault when setting __name__ on a
   class.
 
-- Issue #17669: Fix crash involving finalization of generators using yield from.
+- bpo-17669: Fix crash involving finalization of generators using yield
+  from.
 
-- Issue #14439: Python now prints the traceback on runpy failure at startup.
+- bpo-14439: Python now prints the traceback on runpy failure at startup.
 
-- Issue #17469: Fix _Py_GetAllocatedBlocks() and sys.getallocatedblocks()
-  when running on valgrind.
+- bpo-17469: Fix _Py_GetAllocatedBlocks() and sys.getallocatedblocks() when
+  running on valgrind.
 
-- Issue #17619: Make input() check for Ctrl-C correctly on Windows.
+- bpo-17619: Make input() check for Ctrl-C correctly on Windows.
 
-- Issue #17357: Add missing verbosity messages for -v/-vv that were lost during
+- bpo-17357: Add missing verbosity messages for -v/-vv that were lost during
   the importlib transition.
 
-- Issue #17610: Don't rely on non-standard behavior of the C qsort() function.
+- bpo-17610: Don't rely on non-standard behavior of the C qsort() function.
 
-- Issue #17323: The "[X refs, Y blocks]" printed by debug builds has been
-  disabled by default.  It can be re-enabled with the `-X showrefcount` option.
+- bpo-17323: The "[X refs, Y blocks]" printed by debug builds has been
+  disabled by default.  It can be re-enabled with the `-X showrefcount`
+  option.
 
-- Issue #17328: Fix possible refleak in dict.setdefault.
+- bpo-17328: Fix possible refleak in dict.setdefault.
 
-- Issue #17275: Corrected class name in init error messages of the C version of
+- bpo-17275: Corrected class name in init error messages of the C version of
   BufferedWriter and BufferedRandom.
 
-- Issue #7963: Fixed misleading error message that issued when object is
-  called without arguments.
+- bpo-7963: Fixed misleading error message that issued when object is called
+  without arguments.
 
-- Issue #8745: Small speed up zipimport on Windows. Patch by Catalin Iacob.
+- bpo-8745: Small speed up zipimport on Windows. Patch by Catalin Iacob.
 
-- Issue #5308: Raise ValueError when marshalling too large object (a sequence
+- bpo-5308: Raise ValueError when marshalling too large object (a sequence
   with size >= 2**31), instead of producing illegal marshal data.
 
-- Issue #12983: Bytes literals with invalid ``\x`` escape now raise a SyntaxError
-  and a full traceback including line number.
+- bpo-12983: Bytes literals with invalid ``\x`` escape now raise a
+  SyntaxError and a full traceback including line number.
 
-- Issue #16967: In function definition, evaluate positional defaults before
+- bpo-16967: In function definition, evaluate positional defaults before
   keyword-only defaults.
 
-- Issue #17173: Remove uses of locale-dependent C functions (isalpha() etc.)
-  in the interpreter.
+- bpo-17173: Remove uses of locale-dependent C functions (isalpha() etc.) in
+  the interpreter.
 
-- Issue #17137: When an Unicode string is resized, the internal wide character
+- bpo-17137: When an Unicode string is resized, the internal wide character
   string (wstr) format is now cleared.
 
-- Issue #17043: The unicode-internal decoder no longer read past the end of
+- bpo-17043: The unicode-internal decoder no longer read past the end of
   input buffer.
 
-- Issue #17098: All modules now have __loader__ set even if they pre-exist the
+- bpo-17098: All modules now have __loader__ set even if they pre-exist the
   bootstrapping of importlib.
 
-- Issue #16979: Fix error handling bugs in the unicode-escape-decode decoder.
+- bpo-16979: Fix error handling bugs in the unicode-escape-decode decoder.
 
-- Issue #16772: The base argument to the int constructor no longer accepts
-  floats, or other non-integer objects with an __int__ method.  Objects
-  with an __index__ method are now accepted.
+- bpo-16772: The base argument to the int constructor no longer accepts
+  floats, or other non-integer objects with an __int__ method.  Objects with
+  an __index__ method are now accepted.
 
-- Issue #10156: In the interpreter's initialization phase, unicode globals
-  are now initialized dynamically as needed.
+- bpo-10156: In the interpreter's initialization phase, unicode globals are
+  now initialized dynamically as needed.
 
-- Issue #16980: Fix processing of escaped non-ascii bytes in the
-  unicode-escape-decode decoder.
+- bpo-16980: Fix processing of escaped non-ascii bytes in the unicode-
+  escape-decode decoder.
 
-- Issue #16975: Fix error handling bug in the escape-decode bytes decoder.
+- bpo-16975: Fix error handling bug in the escape-decode bytes decoder.
 
-- Issue #14850: Now a charmap decoder treats U+FFFE as "undefined mapping"
-  in any mapping, not only in a string.
+- bpo-14850: Now a charmap decoder treats U+FFFE as "undefined mapping" in
+  any mapping, not only in a string.
 
-- Issue #16613: Add *m* argument to ``collections.Chainmap.new_child`` to
-  allow the new child map to be specified explicitly.
+- bpo-16613: Add *m* argument to ``collections.Chainmap.new_child`` to allow
+  the new child map to be specified explicitly.
 
-- Issue #16730: importlib.machinery.FileFinder now no longers raises an
-  exception when trying to populate its cache and it finds out the directory is
-  unreadable or has turned into a file. Reported and diagnosed by
-  David Pritchard.
+- bpo-16730: importlib.machinery.FileFinder now no longers raises an
+  exception when trying to populate its cache and it finds out the directory
+  is unreadable or has turned into a file. Reported and diagnosed by David
+  Pritchard.
 
-- Issue #16906: Fix a logic error that prevented most static strings from being
+- bpo-16906: Fix a logic error that prevented most static strings from being
   cleared.
 
-- Issue #11461: Fix the incremental UTF-16 decoder. Original patch by
-  Amaury Forgeot d'Arc.
+- bpo-11461: Fix the incremental UTF-16 decoder. Original patch by Amaury
+  Forgeot d'Arc.
 
-- Issue #16856: Fix a segmentation fault from calling repr() on a dict with
-  key whose repr raise an exception.
+- bpo-16856: Fix a segmentation fault from calling repr() on a dict with a
+  key whose repr raise an exception.
 
-- Issue #16367: Fix FileIO.readall() on Windows for files larger than 2 GB.
+- bpo-16367: Fix FileIO.readall() on Windows for files larger than 2 GB.
 
-- Issue #16761: Calling int() with base argument only now raises TypeError.
+- bpo-16761: Calling int() with base argument only now raises TypeError.
 
-- Issue #16759: Support the full DWORD (unsigned long) range in Reg2Py
-  when retrieving a REG_DWORD value. This corrects functions like
+- bpo-16759: Support the full DWORD (unsigned long) range in Reg2Py when
+  retrieving a REG_DWORD value. This corrects functions like
   winreg.QueryValueEx that may have been returning truncated values.
 
-- Issue #14420: Support the full DWORD (unsigned long) range in Py2Reg
-  when passed a REG_DWORD value. Fixes OverflowError in winreg.SetValueEx.
+- bpo-14420: Support the full DWORD (unsigned long) range in Py2Reg when
+  passed a REG_DWORD value. Fixes OverflowError in winreg.SetValueEx.
 
-- Issue #11939: Set the st_dev attribute of stat_result to allow Windows to
-  take advantage of the os.path.samefile/sameopenfile/samestat implementations
-  used by other platforms.
+- bpo-11939: Set the st_dev attribute of stat_result to allow Windows to
+  take advantage of the os.path.samefile/sameopenfile/samestat
+  implementations used by other platforms.
 
-- Issue #16772: The int() constructor's second argument (base) no longer
+- bpo-16772: The int() constructor's second argument (base) no longer
   accepts non integer values.  Consistent with the behavior in Python 2.
 
-- Issue #14470: Remove w9xpopen support per PEP 11.
+- bpo-14470: Remove w9xpopen support per PEP 11.
 
-- Issue #9856: Replace deprecation warning with raising TypeError
-  in object.__format__. Patch by Florent Xicluna.
+- bpo-9856: Replace deprecation warning with raising TypeError in
+  object.__format__. Patch by Florent Xicluna.
 
-- Issue #16597: In buffered and text IO, call close() on the underlying stream
+- bpo-16597: In buffered and text IO, call close() on the underlying stream
   if invoking flush() fails.
 
-- Issue #16722: In the bytes() constructor, try to call __bytes__ on the
+- bpo-16722: In the bytes() constructor, try to call __bytes__ on the
   argument before __index__.
 
-- Issue #16421: loading multiple modules from one shared object is now
-  handled correctly (previously, the first module loaded from that file
-  was silently returned). Patch by Václav Šmilauer.
+- bpo-16421: loading multiple modules from one shared object is now handled
+  correctly (previously, the first module loaded from that file was silently
+  returned). Patch by Václav Šmilauer.
 
-- Issue #16602: When a weakref's target was part of a long deallocation
-  chain, the object could remain reachable through its weakref even though
-  its refcount had dropped to zero.
+- bpo-16602: When a weakref's target was part of a long deallocation chain,
+  the object could remain reachable through its weakref even though its
+  refcount had dropped to zero.
 
-- Issue #16495: Remove extraneous NULL encoding check from bytes_decode().
+- bpo-16495: Remove extraneous NULL encoding check from bytes_decode().
 
-- Issue #16619: Create NameConstant AST class to represent None, True, and False
-  literals. As a result, these constants are never loaded at runtime from
-  builtins.
+- bpo-16619: Create NameConstant AST class to represent None, True, and
+  False literals. As a result, these constants are never loaded at runtime
+  from builtins.
 
-- Issue #16455: On FreeBSD and Solaris, if the locale is C, the
-  ASCII/surrogateescape codec is now used (instead of the locale encoding) to
-  decode the command line arguments. This change fixes inconsistencies with
-  os.fsencode() and os.fsdecode(), because these operating systems announce an
-  ASCII locale encoding, but actually use the ISO-8859-1 encoding in practice.
+- bpo-16455: On FreeBSD and Solaris, if the locale is C, the
+  ASCII/surrogateescape codec is now used (instead of the locale encoding)
+  to decode the command line arguments. This change fixes inconsistencies
+  with os.fsencode() and os.fsdecode(), because these operating systems
+  announce an ASCII locale encoding, but actually use the ISO-8859-1
+  encoding in practice.
 
-- Issue #16562: Optimize dict equality testing.  Patch by Serhiy Storchaka.
+- bpo-16562: Optimize dict equality testing.  Patch by Serhiy Storchaka.
 
-- Issue #16588: Silence unused-but-set warnings in Python/thread_pthread
+- bpo-16588: Silence unused-but-set warnings in Python/thread_pthread
 
-- Issue #16592: stringlib_bytes_join doesn't raise MemoryError on allocation
+- bpo-16592: stringlib_bytes_join doesn't raise MemoryError on allocation
   failure.
 
-- Issue #16546: Fix: ast.YieldFrom argument is now mandatory.
+- bpo-16546: Fix: ast.YieldFrom argument is now mandatory.
 
-- Issue #16514: Fix regression causing a traceback when sys.path[0] is None
+- bpo-16514: Fix regression causing a traceback when sys.path[0] is None
   (actually, any non-string or non-bytes type).
 
-- Issue #16306: Fix multiple error messages when unknown command line
+- bpo-16306: Fix multiple error messages when unknown command line
   parameters where passed to the interpreter.  Patch by Hieu Nguyen.
 
-- Issue #16215: Fix potential double memory free in str.replace().  Patch
-  by Serhiy Storchaka.
+- bpo-16215: Fix potential double memory free in str.replace().  Patch by
+  Serhiy Storchaka.
 
-- Issue #16290: A float return value from the __complex__ special method is no
+- bpo-16290: A float return value from the __complex__ special method is no
   longer accepted in the complex() constructor.
 
-- Issue #16416: On Mac OS X, operating system data are now always
-  encoded/decoded to/from UTF-8/surrogateescape, instead of the locale encoding
-  (which may be ASCII if no locale environment variable is set), to avoid
-  inconsistencies with os.fsencode() and os.fsdecode() functions which are
-  already using UTF-8/surrogateescape.
+- bpo-16416: On Mac OS X, operating system data are now always
+  encoded/decoded to/from UTF-8/surrogateescape, instead of the locale
+  encoding (which may be ASCII if no locale environment variable is set), to
+  avoid inconsistencies with os.fsencode() and os.fsdecode() functions which
+  are already using UTF-8/surrogateescape.
 
-- Issue #16453: Fix equality testing of dead weakref objects.
+- bpo-16453: Fix equality testing of dead weakref objects.
 
-- Issue #9535: Fix pending signals that have been received but not yet
-  handled by Python to not persist after os.fork() in the child process.
+- bpo-9535: Fix pending signals that have been received but not yet handled
+  by Python to not persist after os.fork() in the child process.
 
-- Issue #14794: Fix slice.indices to return correct results for huge values,
+- bpo-14794: Fix slice.indices to return correct results for huge values,
   rather than raising OverflowError.
 
-- Issue #15001: fix segfault on "del sys.modules['__main__']". Patch by Victor
+- bpo-15001: fix segfault on "del sys.modules['__main__']". Patch by Victor
   Stinner.
 
-- Issue #8271: the utf-8 decoder now outputs the correct number of U+FFFD
+- bpo-8271: the utf-8 decoder now outputs the correct number of U+FFFD
   characters when used with the 'replace' error handler on invalid utf-8
   sequences.  Patch by Serhiy Storchaka, tests by Ezio Melotti.
 
-- Issue #5765: Apply a hard recursion limit in the compiler instead of
-  blowing the stack and segfaulting. Initial patch by Andrea Griffini.
+- bpo-5765: Apply a hard recursion limit in the compiler instead of blowing
+  the stack and segfaulting. Initial patch by Andrea Griffini.
 
-- Issue #16402: When slicing a range, fix shadowing of exceptions from
+- bpo-16402: When slicing a range, fix shadowing of exceptions from
   __index__.
 
-- Issue #16336: fix input checking in the surrogatepass error handler.
-  Patch by Serhiy Storchaka.
+- bpo-16336: fix input checking in the surrogatepass error handler. Patch by
+  Serhiy Storchaka.
 
-- Issue #8401: assigning an int to a bytearray slice (e.g. b[3:4] = 5) now
+- bpo-8401: assigning an int to a bytearray slice (e.g. b[3:4] = 5) now
   raises an error.
 
-- Issue #7317: Display full tracebacks when an error occurs asynchronously.
+- bpo-7317: Display full tracebacks when an error occurs asynchronously.
   Patch by Alon Horev with update by Alexey Kachayev.
 
-- Issue #16309: Make PYTHONPATH="" behavior the same as if PYTHONPATH
-  not set at all.
+- bpo-16309: Make PYTHONPATH="" behavior the same as if PYTHONPATH not set
+  at all.
 
-- Issue #10189: Improve the error reporting of SyntaxErrors related to global
+- bpo-10189: Improve the error reporting of SyntaxErrors related to global
   and nonlocal statements.
 
 - Fix segfaults on setting __qualname__ on builtin types and attempting to
   delete it on any type.
 
-- Issue #14625: Rewrite the UTF-32 decoder. It is now 3x to 4x faster. Patch
+- bpo-14625: Rewrite the UTF-32 decoder. It is now 3x to 4x faster. Patch
   written by Serhiy Storchaka.
 
-- Issue #16345: Fix an infinite loop when ``fromkeys`` on a dict subclass
+- bpo-16345: Fix an infinite loop when ``fromkeys`` on a dict subclass
   received a nonempty dict from the constructor.
 
-- Issue #16271: Fix strange bugs that resulted from __qualname__ appearing in a
+- bpo-16271: Fix strange bugs that resulted from __qualname__ appearing in a
   class's __dict__ and on type.
 
-- Issue #12805: Make bytes.join and bytearray.join faster when the separator
-  is empty.  Patch by Serhiy Storchaka.
+- bpo-12805: Make bytes.join and bytearray.join faster when the separator is
+  empty. Patch by Serhiy Storchaka.
 
-- Issue #6074: Ensure cached bytecode files can always be updated by the
-  user that created them, even when the source file is read-only.
+- bpo-6074: Ensure cached bytecode files can always be updated by the user
+  that created them, even when the source file is read-only.
 
-- Issue #15958: bytes.join and bytearray.join now accept arbitrary buffer
+- bpo-15958: bytes.join and bytearray.join now accept arbitrary buffer
   objects.
 
-- Issue #14783: Improve int() docstring and switch docstrings for str(),
+- bpo-14783: Improve int() docstring and switch docstrings for str(),
   range(), and slice() to use multi-line signatures.
 
-- Issue #16160: Subclass support now works for types.SimpleNamespace.
+- bpo-16160: Subclass support now works for types.SimpleNamespace.
 
-- Issue #16148: Implement PEP 424, adding operator.length_hint and
+- bpo-16148: Implement PEP 424, adding operator.length_hint and
   PyObject_LengthHint.
 
 - Upgrade Unicode data (UCD) to version 6.2.
 
-- Issue #15379: Fix passing of non-BMP characters as integers for the charmap
+- bpo-15379: Fix passing of non-BMP characters as integers for the charmap
   decoder (already working as unicode strings).  Patch by Serhiy Storchaka.
 
-- Issue #15144: Fix possible integer overflow when handling pointers as integer
+- bpo-15144: Fix possible integer overflow when handling pointers as integer
   values, by using `Py_uintptr_t` instead of `size_t`.  Patch by Serhiy
   Storchaka.
 
-- Issue #15965: Explicitly cast `AT_FDCWD` as (int).  Required on Solaris 10
+- bpo-15965: Explicitly cast `AT_FDCWD` as (int).  Required on Solaris 10
   (which defines `AT_FDCWD` as ``0xffd19553``), harmless on other platforms.
 
-- Issue #15839: Convert SystemErrors in `super()` to RuntimeErrors.
+- bpo-15839: Convert SystemErrors in `super()` to RuntimeErrors.
 
-- Issue #15448: Buffered IO now frees the buffer when closed, instead
-  of when deallocating.
+- bpo-15448: Buffered IO now frees the buffer when closed, instead of when
+  deallocating.
 
-- Issue #15846: Fix SystemError which happened when using `ast.parse()` in an
+- bpo-15846: Fix SystemError which happened when using `ast.parse()` in an
   exception handler on code with syntax errors.
 
-- Issue #15897: zipimport.c doesn't check return value of fseek().
-  Patch by Felipe Cruz.
+- bpo-15897: zipimport.c doesn't check return value of fseek(). Patch by
+  Felipe Cruz.
 
-- Issue #15801: Make sure mappings passed to '%' formatting are actually
+- bpo-15801: Make sure mappings passed to '%' formatting are actually
   subscriptable.
 
-- Issue #15111: __import__ should propagate ImportError when raised as a
-  side-effect of a module triggered from using fromlist.
+- bpo-15111: __import__ should propagate ImportError when raised as a side-
+  effect of a module triggered from using fromlist.
 
-- Issue #15022: Add pickle and comparison support to types.SimpleNamespace.
+- bpo-15022: Add pickle and comparison support to types.SimpleNamespace.
 
 Library
 -------
 
-- Issue #4331: Added functools.partialmethod (Initial patch by Alon Horev)
+- bpo-4331: Added functools.partialmethod (Initial patch by Alon Horev)
 
-- Issue #13461: Fix a crash in the TextIOWrapper.tell method on 64-bit
+- bpo-13461: Fix a crash in the TextIOWrapper.tell method on 64-bit
   platforms.  Patch by Yogesh Chaudhari.
 
-- Issue #18681: Fix a NameError in importlib.reload() (noticed by Weizhao Li).
+- bpo-18681: Fix a NameError in importlib.reload() (noticed by Weizhao Li).
 
-- Issue #14323: Expanded the number of digits in the coefficients for the
-  RGB -- YIQ conversions so that they match the FCC NTSC versions.
+- bpo-14323: Expanded the number of digits in the coefficients for the RGB
+  -- YIQ conversions so that they match the FCC NTSC versions.
 
-- Issue #17998: Fix an internal error in regular expression engine.
+- bpo-17998: Fix an internal error in regular expression engine.
 
-- Issue #17557: Fix os.getgroups() to work with the modified behavior of
+- bpo-17557: Fix os.getgroups() to work with the modified behavior of
   getgroups(2) on OS X 10.8.  Original patch by Mateusz Lenik.
 
-- Issue #18608: Avoid keeping a strong reference to the locale module
-  inside the _io module.
+- bpo-18608: Avoid keeping a strong reference to the locale module inside
+  the _io module.
 
-- Issue #18619: Fix atexit leaking callbacks registered from sub-interpreters,
+- bpo-18619: Fix atexit leaking callbacks registered from sub-interpreters,
   and make it GC-aware.
 
-- Issue #15699: The readline module now uses PEP 3121-style module
-  initialization, so as to reclaim allocated resources (Python callbacks)
-  at shutdown.  Original patch by Robin Schreiber.
+- bpo-15699: The readline module now uses PEP 3121-style module
+  initialization, so as to reclaim allocated resources (Python callbacks) at
+  shutdown.  Original patch by Robin Schreiber.
 
-- Issue #17616: wave.open now supports the context management protocol.
+- bpo-17616: wave.open now supports the context management protocol.
 
-- Issue #18599: Fix name attribute of _sha1.sha1() object. It now returns
+- bpo-18599: Fix name attribute of _sha1.sha1() object. It now returns
   'SHA1' instead of 'SHA'.
 
-- Issue #13266: Added inspect.unwrap to easily unravel __wrapped__ chains
+- bpo-13266: Added inspect.unwrap to easily unravel __wrapped__ chains
   (initial patch by Daniel Urban and Aaron Iles)
 
-- Issue #18561: Skip name in ctypes' _build_callargs() if name is NULL.
+- bpo-18561: Skip name in ctypes' _build_callargs() if name is NULL.
 
-- Issue #18559: Fix NULL pointer dereference error in _pickle module
+- bpo-18559: Fix NULL pointer dereference error in _pickle module
 
-- Issue #18556: Check the return type of PyUnicode_AsWideChar() in ctype's
+- bpo-18556: Check the return type of PyUnicode_AsWideChar() in ctype's
   U_set().
 
-- Issue #17818: aifc.getparams now returns a namedtuple.
+- bpo-17818: aifc.getparams now returns a namedtuple.
 
-- Issue #18549: Eliminate dead code in socket_ntohl()
+- bpo-18549: Eliminate dead code in socket_ntohl()
 
-- Issue #18530: Remove additional stat call from posixpath.ismount.
-  Patch by Alex Gaynor.
+- bpo-18530: Remove additional stat call from posixpath.ismount. Patch by
+  Alex Gaynor.
 
-- Issue #18514: Fix unreachable Py_DECREF() call in PyCData_FromBaseObj()
+- bpo-18514: Fix unreachable Py_DECREF() call in PyCData_FromBaseObj()
 
-- Issue #9177: Calling read() or write() now raises ValueError, not
+- bpo-9177: Calling read() or write() now raises ValueError, not
   AttributeError, on a closed SSL socket.  Patch by Senko Rasic.
 
-- Issue #18513: Fix behaviour of cmath.rect w.r.t. signed zeros on OS X 10.8 +
+- bpo-18513: Fix behaviour of cmath.rect w.r.t. signed zeros on OS X 10.8 +
   gcc.
 
-- Issue #18479: Changed venv Activate.ps1 to make deactivate a function, and
+- bpo-18479: Changed venv Activate.ps1 to make deactivate a function, and
   removed Deactivate.ps1.
 
-- Issue #18480: Add missing call to PyType_Ready to the _elementtree extension.
+- bpo-18480: Add missing call to PyType_Ready to the _elementtree extension.
 
-- Issue #17778: Fix test discovery for test_multiprocessing. (Patch by
-  Zachary Ware.)
+- bpo-17778: Fix test discovery for test_multiprocessing. (Patch by Zachary
+  Ware.)
 
-- Issue #18393: The private module _gestalt and private functions
-  platform._mac_ver_gestalt, platform._mac_ver_lookup and
-  platform._bcd2str have been removed. This does not affect the public
-  interface of the platform module.
+- bpo-18393: The private module _gestalt and private functions
+  platform._mac_ver_gestalt, platform._mac_ver_lookup and platform._bcd2str
+  have been removed. This does not affect the public interface of the
+  platform module.
 
-- Issue #17482: functools.update_wrapper (and functools.wraps) now set the
+- bpo-17482: functools.update_wrapper (and functools.wraps) now set the
   __wrapped__ attribute correctly even if the underlying function has a
   __wrapped__ attribute set.
 
-- Issue #18431: The new email header parser now decodes RFC2047 encoded words
+- bpo-18431: The new email header parser now decodes RFC2047 encoded words
   in structured headers.
 
-- Issue #18432: The sched module's queue method was incorrectly returning
-  an iterator instead of a list.
+- bpo-18432: The sched module's queue method was incorrectly returning an
+  iterator instead of a list.
 
-- Issue #18044: The new email header parser was mis-parsing encoded words where
+- bpo-18044: The new email header parser was mis-parsing encoded words where
   an encoded character immediately followed the '?' that follows the CTE
-  character, resulting in a decoding failure.  They are now decoded correctly.
+  character, resulting in a decoding failure.  They are now decoded
+  correctly.
 
-- Issue #18101: Tcl.split() now process strings nested in a tuple as it
-  do with byte strings.
+- bpo-18101: Tcl.split() now process strings nested in a tuple as it do with
+  byte strings.
 
-- Issue #18116: getpass was always getting an error when testing /dev/tty,
-  and thus was always falling back to stdin, and would then raise an exception
-  if stdin could not be used (such as /dev/null).  It also leaked an open file.
-  All of these issues are now fixed.
+- bpo-18116: getpass was always getting an error when testing /dev/tty, and
+  thus was always falling back to stdin, and would then raise an exception
+  if stdin could not be used (such as /dev/null).  It also leaked an open
+  file. All of these issues are now fixed.
 
-- Issue #17198: Fix a NameError in the dbm module.  Patch by Valentina
+- bpo-17198: Fix a NameError in the dbm module.  Patch by Valentina
   Mukhamedzhanova.
 
-- Issue #18013: Fix cgi.FieldStorage to parse the W3C sample form.
+- bpo-18013: Fix cgi.FieldStorage to parse the W3C sample form.
 
-- Issue #18020: improve html.escape speed by an order of magnitude.
-  Patch by Matt Bryant.
+- bpo-18020: improve html.escape speed by an order of magnitude. Patch by
+  Matt Bryant.
 
-- Issue #18347: ElementTree's html serializer now preserves the case of
-  closing tags.
+- bpo-18347: ElementTree's html serializer now preserves the case of closing
+  tags.
 
-- Issue #17261: Ensure multiprocessing's proxies use proper address.
+- bpo-17261: Ensure multiprocessing's proxies use proper address.
 
-- Issue #18343: faulthandler.register() now keeps the previous signal handler
+- bpo-18343: faulthandler.register() now keeps the previous signal handler
   when the function is called twice, so faulthandler.unregister() restores
   correctly the original signal handler.
 
-- Issue #17097: Make multiprocessing ignore EINTR.
+- bpo-17097: Make multiprocessing ignore EINTR.
 
-- Issue #18339: Negative ints keys in unpickler.memo dict no longer cause a
+- bpo-18339: Negative ints keys in unpickler.memo dict no longer cause a
   segfault inside the _pickle C extension.
 
-- Issue #18240: The HMAC module is no longer restricted to bytes and accepts
+- bpo-18240: The HMAC module is no longer restricted to bytes and accepts
   any bytes-like object, e.g. memoryview. Original patch by Jonas Borgström.
 
-- Issue #18224: Removed pydoc script from created venv, as it causes problems
+- bpo-18224: Removed pydoc script from created venv, as it causes problems
   on Windows and adds no value over and above python -m pydoc ...
 
-- Issue #18155: The csv module now correctly handles csv files that use
-  delimter character that has a special meaning in regexes, instead of
+- bpo-18155: The csv module now correctly handles csv files that use a
+  delimter character that has a special meaning in regexes, instead of
   throwing an exception.
 
-- Issue #14360: encode_quopri can now be successfully used as an encoder
-  when constructing a MIMEApplication object.
+- bpo-14360: encode_quopri can now be successfully used as an encoder when
+  constructing a MIMEApplication object.
 
-- Issue #11390: Add -o and -f command line options to the doctest CLI to
+- bpo-11390: Add -o and -f command line options to the doctest CLI to
   specify doctest options (and convert it to using argparse).
 
-- Issue #18135: ssl.SSLSocket.write() now raises an OverflowError if the input
+- bpo-18135: ssl.SSLSocket.write() now raises an OverflowError if the input
   string in longer than 2 gigabytes, and ssl.SSLContext.load_cert_chain()
   raises a ValueError if the password is longer than 2 gigabytes. The ssl
   module does not support partial write.
 
-- Issue #11016: Add C implementation of the stat module as _stat.
+- bpo-11016: Add C implementation of the stat module as _stat.
 
-- Issue #18248: Fix libffi build on AIX.
+- bpo-18248: Fix libffi build on AIX.
 
-- Issue #18259: Declare sethostname in socketmodule.c for AIX
+- bpo-18259: Declare sethostname in socketmodule.c for AIX
 
-- Issue #18147: Add diagnostic functions to ssl.SSLContext(). get_ca_list()
+- bpo-18147: Add diagnostic functions to ssl.SSLContext(). get_ca_list()
   lists all loaded CA certificates and cert_store_stats() returns amount of
   loaded X.509 certs, X.509 CA certs and CRLs.
 
-- Issue #18167: cgi.FieldStorage no longer fails to handle multipart/form-data
+- bpo-18167: cgi.FieldStorage no longer fails to handle multipart/form-data
   when ``\r\n`` appears at end of 65535 bytes without other newlines.
 
-- Issue #18076: Introduce importlib.util.decode_source().
+- bpo-18076: Introduce importlib.util.decode_source().
 
-- Issue #18357: add tests for dictview set difference.
-  Patch by Fraser Tweedale.
+- bpo-18357: add tests for dictview set difference. Patch by Fraser
+  Tweedale.
 
 - importlib.abc.SourceLoader.get_source() no longer changes SyntaxError or
   UnicodeDecodeError into ImportError.
 
-- Issue #18058, 18057: Make the namespace package loader meet the
-  importlib.abc.InspectLoader ABC, allowing for namespace packages to work with
-  runpy.
+- bpo-18058: Make the namespace package loader meet the
+  importlib.abc.InspectLoader ABC, allowing for namespace packages to work
+  with runpy. (See also: bpo-18057)
 
-- Issue #17177: The imp module is pending deprecation.
+- bpo-17177: The imp module is pending deprecation.
 
 - subprocess: Prevent a possible double close of parent pipe fds when the
   subprocess exec runs into an error.  Prevent a regular multi-close of the
   /dev/null fd when any of stdin, stdout and stderr was set to DEVNULL.
 
-- Issue #18194: Introduce importlib.util.cache_from_source() and
+- bpo-18194: Introduce importlib.util.cache_from_source() and
   source_from_cache() while documenting the equivalent functions in imp as
   deprecated.
 
-- Issue #17907: Document imp.new_module() as deprecated in favour of
+- bpo-17907: Document imp.new_module() as deprecated in favour of
   types.ModuleType.
 
-- Issue #18192: Introduce importlib.util.MAGIC_NUMBER and document as deprecated
-  imp.get_magic().
+- bpo-18192: Introduce importlib.util.MAGIC_NUMBER and document as
+  deprecated imp.get_magic().
 
-- Issue #18149: Add filecmp.clear_cache() to manually clear the filecmp cache.
+- bpo-18149: Add filecmp.clear_cache() to manually clear the filecmp cache.
   Patch by Mark Levitt
 
-- Issue #18193: Add importlib.reload().
+- bpo-18193: Add importlib.reload().
 
-- Issue #18157: Stop using imp.load_module() in pydoc.
+- bpo-18157: Stop using imp.load_module() in pydoc.
 
-- Issue #16102: Make uuid._netbios_getnode() work again on Python 3.
+- bpo-16102: Make uuid._netbios_getnode() work again on Python 3.
 
-- Issue #17134: Add ssl.enum_cert_store() as interface to Windows' cert store.
+- bpo-17134: Add ssl.enum_cert_store() as interface to Windows' cert store.
 
-- Issue #18143: Implement ssl.get_default_verify_paths() in order to debug
-  the default locations for cafile and capath.
+- bpo-18143: Implement ssl.get_default_verify_paths() in order to debug the
+  default locations for cafile and capath.
 
-- Issue #17314: Move multiprocessing.forking over to importlib.
+- bpo-17314: Move multiprocessing.forking over to importlib.
 
-- Issue #11959: SMTPServer and SMTPChannel now take an optional map, use of
+- bpo-11959: SMTPServer and SMTPChannel now take an optional map, use of
   which avoids affecting global state.
 
-- Issue #18109: os.uname() now decodes fields from the locale encoding, and
+- bpo-18109: os.uname() now decodes fields from the locale encoding, and
   socket.gethostname() now decodes the hostname from the locale encoding,
   instead of using the UTF-8 encoding in strict mode.
 
-- Issue #18089: Implement importlib.abc.InspectLoader.load_module.
+- bpo-18089: Implement importlib.abc.InspectLoader.load_module.
 
-- Issue #18088: Introduce importlib.abc.Loader.init_module_attrs for setting
+- bpo-18088: Introduce importlib.abc.Loader.init_module_attrs for setting
   module attributes. Leads to the pending deprecation of
   importlib.util.module_for_loader.
 
-- Issue #17403: urllib.parse.robotparser normalizes the urls before adding to
-  ruleline. This helps in handling certain types invalid urls in a conservative
-  manner. Patch contributed by Mher Movsisyan.
+- bpo-17403: urllib.parse.robotparser normalizes the urls before adding to
+  ruleline. This helps in handling certain types invalid urls in a
+  conservative manner. Patch contributed by Mher Movsisyan.
 
-- Issue #18070: Have importlib.util.module_for_loader() set attributes
+- bpo-18070: Have importlib.util.module_for_loader() set attributes
   unconditionally in order to properly support reloading.
 
-- Added importlib.util.module_to_load to return a context manager to provide the
-  proper module object to load.
+- Added importlib.util.module_to_load to return a context manager to provide
+  the proper module object to load.
 
-- Issue #18025: Fixed a segfault in io.BufferedIOBase.readinto() when raw
+- bpo-18025: Fixed a segfault in io.BufferedIOBase.readinto() when raw
   stream's read() returns more bytes than requested.
 
-- Issue #18011: As was originally intended, base64.b32decode() now raises a
-  binascii.Error if there are non-b32-alphabet characters present in the input
-  string, instead of a TypeError.
+- bpo-18011: As was originally intended, base64.b32decode() now raises a
+  binascii.Error if there are non-b32-alphabet characters present in the
+  input string, instead of a TypeError.
 
-- Issue #18072: Implement importlib.abc.InspectLoader.get_code() and
+- bpo-18072: Implement importlib.abc.InspectLoader.get_code() and
   importlib.abc.ExecutionLoader.get_code().
 
-- Issue #8240: Set the SSL_MODE_ACCEPT_MOVING_WRITE_BUFFER flag on SSL
-  sockets.
+- bpo-8240: Set the SSL_MODE_ACCEPT_MOVING_WRITE_BUFFER flag on SSL sockets.
 
-- Issue #17269: Workaround for socket.getaddrinfo crash on MacOS X
-  with port None or "0" and flags AI_NUMERICSERV.
+- bpo-17269: Workaround for socket.getaddrinfo crash on MacOS X with port
+  None or "0" and flags AI_NUMERICSERV.
 
-- Issue #16986: ElementTree now correctly works with string input when the
+- bpo-16986: ElementTree now correctly works with string input when the
   internal XML encoding is not UTF-8 or US-ASCII.
 
-- Issue #17996: socket module now exposes AF_LINK constant on BSD and OSX.
+- bpo-17996: socket module now exposes AF_LINK constant on BSD and OSX.
 
-- Issue #17900: Allowed pickling of recursive OrderedDicts.  Decreased pickled
+- bpo-17900: Allowed pickling of recursive OrderedDicts.  Decreased pickled
   size and pickling time.
 
-- Issue #17914: Add os.cpu_count(). Patch by Yogesh Chaudhari, based on an
+- bpo-17914: Add os.cpu_count(). Patch by Yogesh Chaudhari, based on an
   initial patch by Trent Nelson.
 
-- Issue #17812: Fixed quadratic complexity of base64.b32encode().
-  Optimize base64.b32encode() and base64.b32decode() (speed up to 3x).
+- bpo-17812: Fixed quadratic complexity of base64.b32encode(). Optimize
+  base64.b32encode() and base64.b32decode() (speed up to 3x).
 
-- Issue #17980: Fix possible abuse of ssl.match_hostname() for denial of
+- bpo-17980: Fix possible abuse of ssl.match_hostname() for denial of
   service using certificates with many wildcards (CVE-2013-2099).
 
-- Issue #15758: Fix FileIO.readall() so it no longer has O(n**2) complexity.
+- bpo-15758: Fix FileIO.readall() so it no longer has O(n**2) complexity.
 
-- Issue #14596: The struct.Struct() objects now use a more compact
+- bpo-14596: The struct.Struct() objects now use a more compact
   implementation.
 
-- Issue #17981: logging's SysLogHandler now closes the socket when it catches
+- bpo-17981: logging's SysLogHandler now closes the socket when it catches
   socket OSErrors.
 
-- Issue #17964: Fix os.sysconf(): the return type of the C sysconf() function
+- bpo-17964: Fix os.sysconf(): the return type of the C sysconf() function
   is long, not int.
 
 - Fix typos in the multiprocessing module.
 
-- Issue #17754: Make ctypes.util.find_library() independent of the locale.
+- bpo-17754: Make ctypes.util.find_library() independent of the locale.
 
-- Issue #17968: Fix memory leak in os.listxattr().
+- bpo-17968: Fix memory leak in os.listxattr().
 
-- Issue #17606: Fixed support of encoded byte strings in the XMLGenerator
-  characters() and ignorableWhitespace() methods.  Original patch by Sebastian
-  Ortiz Vasquez.
+- bpo-17606: Fixed support of encoded byte strings in the XMLGenerator
+  characters() and ignorableWhitespace() methods.  Original patch by
+  Sebastian Ortiz Vasquez.
 
-- Issue #17732: Ignore distutils.cfg options pertaining to install paths if a
+- bpo-17732: Ignore distutils.cfg options pertaining to install paths if a
   virtual environment is active.
 
-- Issue #17915: Fix interoperability of xml.sax with file objects returned by
+- bpo-17915: Fix interoperability of xml.sax with file objects returned by
   codecs.open().
 
-- Issue #16601: Restarting iteration over tarfile really restarts rather
-  than continuing from where it left off.  Patch by Michael Birtwell.
+- bpo-16601: Restarting iteration over tarfile really restarts rather than
+  continuing from where it left off.  Patch by Michael Birtwell.
 
-- Issue #17289: The readline module now plays nicer with external modules
-  or applications changing the rl_completer_word_break_characters global
+- bpo-17289: The readline module now plays nicer with external modules or
+  applications changing the rl_completer_word_break_characters global
   variable.  Initial patch by Bradley Froehle.
 
-- Issue #12181: select module: Fix struct kevent definition on OpenBSD 64-bit
+- bpo-12181: select module: Fix struct kevent definition on OpenBSD 64-bit
   platforms. Patch by Federico Schwindt.
 
-- Issue #11816: multiple improvements to the dis module: get_instructions
+- bpo-11816: multiple improvements to the dis module: get_instructions
   generator, ability to redirect output to a file, Bytecode and Instruction
   abstractions. Patch by Nick Coghlan, Ryan Kelly and Thomas Kluyver.
 
-- Issue #13831: Embed stringification of remote traceback in local
-  traceback raised when pool task raises an exception.
+- bpo-13831: Embed stringification of remote traceback in local traceback
+  raised when pool task raises an exception.
 
-- Issue #15528: Add weakref.finalize to support finalization using
-  weakref callbacks.
+- bpo-15528: Add weakref.finalize to support finalization using weakref
+  callbacks.
 
-- Issue #14173: Avoid crashing when reading a signal handler during
-  interpreter shutdown.
+- bpo-14173: Avoid crashing when reading a signal handler during interpreter
+  shutdown.
 
-- Issue #15902: Fix imp.load_module() accepting None as a file when loading an
+- bpo-15902: Fix imp.load_module() accepting None as a file when loading an
   extension module.
 
-- Issue #13721: SSLSocket.getpeercert() and SSLSocket.do_handshake() now
-  raise an OSError with ENOTCONN, instead of an AttributeError, when the
-  SSLSocket is not connected.
+- bpo-13721: SSLSocket.getpeercert() and SSLSocket.do_handshake() now raise
+  an OSError with ENOTCONN, instead of an AttributeError, when the SSLSocket
+  is not connected.
 
-- Issue #14679: add an __all__ (that contains only HTMLParser) to html.parser.
+- bpo-14679: add an __all__ (that contains only HTMLParser) to html.parser.
 
-- Issue #17802: Fix an UnboundLocalError in html.parser.  Initial tests by
+- bpo-17802: Fix an UnboundLocalError in html.parser.  Initial tests by
   Thomas Barlow.
 
-- Issue #17358: Modules loaded by imp.load_source() and load_compiled() (and by
-  extention load_module()) now have a better chance of working when reloaded.
+- bpo-17358: Modules loaded by imp.load_source() and load_compiled() (and by
+  extention load_module()) now have a better chance of working when
+  reloaded.
 
-- Issue #17804: New function ``struct.iter_unpack`` allows for streaming
-  struct unpacking.
+- bpo-17804: New function ``struct.iter_unpack`` allows for streaming struct
+  unpacking.
 
-- Issue #17830: When keyword.py is used to update a keyword file, it now
+- bpo-17830: When keyword.py is used to update a keyword file, it now
   preserves the line endings of the original file.
 
-- Issue #17272: Making the urllib.request's Request.full_url a descriptor.
+- bpo-17272: Making the urllib.request's Request.full_url a descriptor.
   Fixes bugs with assignment to full_url. Patch by Demian Brecht.
 
-- Issue #17353: Plistlib emitted empty data tags with deeply nested datastructures
+- bpo-17353: Plistlib emitted empty data tags with deeply nested
+  datastructures
 
-- Issue #11714: Use 'with' statements to assure a Semaphore releases a
-  condition variable.  Original patch by Thomas Rachel.
+- bpo-11714: Use 'with' statements to assure a Semaphore releases a
+  condition variable. Original patch by Thomas Rachel.
 
-- Issue #16624: `subprocess.check_output` now accepts an `input` argument,
-  allowing the subprocess's stdin to be provided as a (byte) string.
-  Patch by Zack Weinberg.
+- bpo-16624: `subprocess.check_output` now accepts an `input` argument,
+  allowing the subprocess's stdin to be provided as a (byte) string. Patch
+  by Zack Weinberg.
 
-- Issue #17795: Reverted backwards-incompatible change in SysLogHandler with
+- bpo-17795: Reverted backwards-incompatible change in SysLogHandler with
   Unix domain sockets.
 
-- Issue #16694: Add a pure Python implementation of the operator module.
-  Patch by Zachary Ware.
+- bpo-16694: Add a pure Python implementation of the operator module. Patch
+  by Zachary Ware.
 
-- Issue #11182: remove the unused and undocumented pydoc.Scanner class.
-  Patch by Martin Morrison.
+- bpo-11182: remove the unused and undocumented pydoc.Scanner class. Patch
+  by Martin Morrison.
 
-- Issue #17741: Add ElementTree.XMLPullParser, an event-driven parser for
-  non-blocking applications.
+- bpo-17741: Add ElementTree.XMLPullParser, an event-driven parser for non-
+  blocking applications.
 
-- Issue #17555: Fix ForkAwareThreadLock so that size of after fork
-  registry does not grow exponentially with generation of process.
+- bpo-17555: Fix ForkAwareThreadLock so that size of after fork registry
+  does not grow exponentially with generation of process.
 
-- Issue #17707: fix regression in multiprocessing.Queue's get() method where
-  it did not block for short timeouts.
+- bpo-17707: fix regression in multiprocessing.Queue's get() method where it
+  did not block for short timeouts.
 
-- Issue #17720: Fix the Python implementation of pickle.Unpickler to correctly
+- bpo-17720: Fix the Python implementation of pickle.Unpickler to correctly
   process the APPENDS opcode when it is used on non-list objects.
 
-- Issue #17012: shutil.which() no longer falls back to the PATH environment
-  variable if an empty path argument is specified.  Patch by Serhiy Storchaka.
+- bpo-17012: shutil.which() no longer falls back to the PATH environment
+  variable if an empty path argument is specified.  Patch by Serhiy
+  Storchaka.
 
-- Issue #17710: Fix pickle raising a SystemError on bogus input.
+- bpo-17710: Fix pickle raising a SystemError on bogus input.
 
-- Issue #17341: Include the invalid name in the error messages from re about
+- bpo-17341: Include the invalid name in the error messages from re about
   invalid group names.
 
-- Issue #17702: os.environ now raises KeyError with the original environment
+- bpo-17702: os.environ now raises KeyError with the original environment
   variable name (str on UNIX), instead of using the encoded name (bytes on
   UNIX).
 
-- Issue #16163: Make the importlib based version of pkgutil.iter_importers
-  work for submodules. Initial patch by Berker Peksag.
+- bpo-16163: Make the importlib based version of pkgutil.iter_importers work
+  for submodules. Initial patch by Berker Peksag.
 
-- Issue #16804: Fix a bug in the 'site' module that caused running
-  'python -S -m site' to incorrectly throw an exception.
+- bpo-16804: Fix a bug in the 'site' module that caused running 'python -S
+  -m site' to incorrectly throw an exception.
 
-- Issue #15480: Remove the deprecated and unused TYPE_INT64 code from marshal.
+- bpo-15480: Remove the deprecated and unused TYPE_INT64 code from marshal.
   Initial patch by Daniel Riti.
 
-- Issue #2118: SMTPException is now a subclass of OSError.
+- bpo-2118: SMTPException is now a subclass of OSError.
 
-- Issue #17016: Get rid of possible pointer wraparounds and integer overflows
+- bpo-17016: Get rid of possible pointer wraparounds and integer overflows
   in the re module.  Patch by Nickolai Zeldovich.
 
-- Issue #16658: add missing return to HTTPConnection.send().
-  Patch by Jeff Knupp.
+- bpo-16658: add missing return to HTTPConnection.send(). Patch by Jeff
+  Knupp.
 
-- Issue #9556: the logging package now allows specifying a time-of-day for a
+- bpo-9556: the logging package now allows specifying a time-of-day for a
   TimedRotatingFileHandler to rotate.
 
-- Issue #14971: unittest test discovery no longer gets confused when a function
+- bpo-14971: unittest test discovery no longer gets confused when a function
   has a different __name__ than its name in the TestCase class dictionary.
 
-- Issue #17487: The wave getparams method now returns a namedtuple rather than
+- bpo-17487: The wave getparams method now returns a namedtuple rather than
   a plain tuple.
 
-- Issue #17675: socket repr() provides local and remote addresses (if any).
+- bpo-17675: socket repr() provides local and remote addresses (if any).
   Patch by Giampaolo Rodola'
 
-- Issue #17093: Make the ABCs in importlib.abc provide default values or raise
-  reasonable exceptions for their methods to make them more amenable to super()
-  calls.
+- bpo-17093: Make the ABCs in importlib.abc provide default values or raise
+  reasonable exceptions for their methods to make them more amenable to
+  super() calls.
 
-- Issue #17566: Make importlib.abc.Loader.module_repr() optional instead of an
-  abstractmethod; now it raises NotImplementedError so as to be ignored by default.
+- bpo-17566: Make importlib.abc.Loader.module_repr() optional instead of an
+  abstractmethod; now it raises NotImplementedError so as to be ignored by
+  default.
 
-- Issue #17678: Remove the use of deprecated method in http/cookiejar.py by
+- bpo-17678: Remove the use of deprecated method in http/cookiejar.py by
   changing the call to get_origin_req_host() to origin_req_host.
 
-- Issue #17666: Fix reading gzip files with an extra field.
+- bpo-17666: Fix reading gzip files with an extra field.
 
-- Issue #16475: Support object instancing, recursion and interned strings
-  in marshal
+- bpo-16475: Support object instancing, recursion and interned strings in
+  marshal
 
-- Issue #17502: Process DEFAULT values in mock side_effect that returns iterator.
+- bpo-17502: Process DEFAULT values in mock side_effect that returns
+  iterator.
 
-- Issue #16795: On the ast.arguments object, unify vararg with varargannotation
-  and kwarg and kwargannotation. Change the column offset of ast.Attribute to be
-  at the attribute name.
+- bpo-16795: On the ast.arguments object, unify vararg with varargannotation
+  and kwarg and kwargannotation. Change the column offset of ast.Attribute
+  to be at the attribute name.
 
-- Issue #17434: Properly raise a SyntaxError when a string occurs between future
-  imports.
+- bpo-17434: Properly raise a SyntaxError when a string occurs between
+  future imports.
 
-- Issue #17117: Import and @importlib.util.set_loader now set __loader__ when
+- bpo-17117: Import and @importlib.util.set_loader now set __loader__ when
   it has a value of None or the attribute doesn't exist.
 
-- Issue #17032: The "global" in the "NameError: global name 'x' is not defined"
+- bpo-17032: The "global" in the "NameError: global name 'x' is not defined"
   error message has been removed.  Patch by Ram Rachum.
 
-- Issue #18080: When building a C extension module on OS X, if the compiler
-  is overriden with the CC environment variable, use the new compiler as
-  the default for linking if LDSHARED is not also overriden.  This restores
+- bpo-18080: When building a C extension module on OS X, if the compiler is
+  overriden with the CC environment variable, use the new compiler as the
+  default for linking if LDSHARED is not also overriden.  This restores
   Distutils behavior introduced in 3.2.3 and inadvertently dropped in 3.3.0.
 
-- Issue #18113: Fixed a refcount leak in the curses.panel module's
-  set_userptr() method.  Reported by Atsuo Ishimoto.
+- bpo-18113: Fixed a refcount leak in the curses.panel module's
+  set_userptr() method. Reported by Atsuo Ishimoto.
 
 - Implement PEP 443 "Single-dispatch generic functions".
 
 - Implement PEP 435 "Adding an Enum type to the Python standard library".
 
-- Issue #15596: Faster pickling of unicode strings.
+- bpo-15596: Faster pickling of unicode strings.
 
-- Issue #17572: Avoid chained exceptions when passing bad directives to
-  time.strptime().  Initial patch by Claudiu Popa.
+- bpo-17572: Avoid chained exceptions when passing bad directives to
+  time.strptime(). Initial patch by Claudiu Popa.
 
-- Issue #17435: threading.Timer's __init__ method no longer uses mutable
+- bpo-17435: threading.Timer's __init__ method no longer uses mutable
   default values for the args and kwargs parameters.
 
-- Issue #17526: fix an IndexError raised while passing code without filename to
+- bpo-17526: fix an IndexError raised while passing code without filename to
   inspect.findsource().  Initial patch by Tyler Doyle.
 
-- Issue #17540: Added style parameter to logging formatter configuration by dict.
+- bpo-17540: Added style parameter to logging formatter configuration by
+  dict.
 
-- Issue #16692: The ssl module now supports TLS 1.1 and TLS 1.2.  Initial
-  patch by Michele Orrù.
+- bpo-16692: The ssl module now supports TLS 1.1 and TLS 1.2.  Initial patch
+  by Michele Orrù.
 
-- Issue #17025: multiprocessing: Reduce Queue and SimpleQueue contention.
+- bpo-17025: multiprocessing: Reduce Queue and SimpleQueue contention.
 
-- Issue #17536: Add to webbrowser's browser list: www-browser, x-www-browser,
+- bpo-17536: Add to webbrowser's browser list: www-browser, x-www-browser,
   iceweasel, iceape.
 
-- Issue #17150: pprint now uses line continuations to wrap long string
+- bpo-17150: pprint now uses line continuations to wrap long string
   literals.
 
-- Issue #17488: Change the subprocess.Popen bufsize parameter default value
+- bpo-17488: Change the subprocess.Popen bufsize parameter default value
   from unbuffered (0) to buffering (-1) to match the behavior existing code
-  expects and match the behavior of the subprocess module in Python 2 to avoid
-  introducing hard to track down bugs.
+  expects and match the behavior of the subprocess module in Python 2 to
+  avoid introducing hard to track down bugs.
 
-- Issue #17521: Corrected non-enabling of logger following two calls to
+- bpo-17521: Corrected non-enabling of logger following two calls to
   fileConfig().
 
-- Issue #17508: Corrected logging MemoryHandler configuration in dictConfig()
+- bpo-17508: Corrected logging MemoryHandler configuration in dictConfig()
   where the target handler wasn't configured first.
 
-- Issue #17209: curses.window.get_wch() now correctly handles KeyboardInterrupt
+- bpo-17209: curses.window.get_wch() now correctly handles KeyboardInterrupt
   (CTRL+c).
 
-- Issue #5713: smtplib now handles 421 (closing connection) error codes when
-  sending mail by closing the socket and reporting the 421 error code via the
-  exception appropriate to the command that received the error response.
+- bpo-5713: smtplib now handles 421 (closing connection) error codes when
+  sending mail by closing the socket and reporting the 421 error code via
+  the exception appropriate to the command that received the error response.
 
-- Issue #16997: unittest.TestCase now provides a subTest() context manager
-  to procedurally generate, in an easy way, small test instances.
+- bpo-16997: unittest.TestCase now provides a subTest() context manager to
+  procedurally generate, in an easy way, small test instances.
 
-- Issue #17485: Also delete the Request Content-Length header if the data
+- bpo-17485: Also delete the Request Content-Length header if the data
   attribute is deleted.  (Follow on to issue Issue #16464).
 
-- Issue #15927: CVS now correctly parses escaped newlines and carriage
-  when parsing with quoting turned off.
+- bpo-15927: CVS now correctly parses escaped newlines and carriage when
+  parsing with quoting turned off.
 
-- Issue #17467: add readline and readlines support to mock_open in
+- bpo-17467: add readline and readlines support to mock_open in
   unittest.mock.
 
-- Issue #13248: removed deprecated and undocumented difflib.isbjunk,
+- bpo-13248: removed deprecated and undocumented difflib.isbjunk,
   isbpopular.
 
-- Issue #17192: Update the ctypes module's libffi to v3.0.13.  This
+- bpo-17192: Update the ctypes module's libffi to v3.0.13.  This
   specifically addresses a stack misalignment issue on x86 and issues on
   some more recent platforms.
 
-- Issue #8862: Fixed curses cleanup when getkey is interrputed by a signal.
+- bpo-8862: Fixed curses cleanup when getkey is interrputed by a signal.
 
-- Issue #17443: imaplib.IMAP4_stream was using the default unbuffered IO
-  in subprocess, but the imap code assumes buffered IO.  In Python2 this
-  worked by accident.  IMAP4_stream now explicitly uses buffered IO.
+- bpo-17443: imaplib.IMAP4_stream was using the default unbuffered IO in
+  subprocess, but the imap code assumes buffered IO.  In Python2 this worked
+  by accident. IMAP4_stream now explicitly uses buffered IO.
 
-- Issue #17476: Fixed regression relative to Python2 in undocumented pydoc
+- bpo-17476: Fixed regression relative to Python2 in undocumented pydoc
   'allmethods'; it was missing unbound methods on the class.
 
-- Issue #17474: Remove the deprecated methods of Request class.
+- bpo-17474: Remove the deprecated methods of Request class.
 
-- Issue #16709: unittest discover order is no-longer filesystem specific. Patch
+- bpo-16709: unittest discover order is no-longer filesystem specific. Patch
   by Jeff Ramnani.
 
-- Use the HTTPS PyPI url for upload, overriding any plain HTTP URL in pypirc.
+- Use the HTTPS PyPI url for upload, overriding any plain HTTP URL in
+  pypirc.
 
-- Issue #5024: sndhdr.whichhdr now returns the frame count for WAV files
-  rather than -1.
+- bpo-5024: sndhdr.whichhdr now returns the frame count for WAV files rather
+  than -1.
 
-- Issue #17460: Remove the strict argument of HTTPConnection and removing the
+- bpo-17460: Remove the strict argument of HTTPConnection and removing the
   DeprecationWarning being issued from 3.2 onwards.
 
-- Issue #16880: Do not assume _imp.load_dynamic() is defined in the imp module.
+- bpo-16880: Do not assume _imp.load_dynamic() is defined in the imp module.
 
-- Issue #16389: Fixed a performance regression relative to Python 3.1 in the
+- bpo-16389: Fixed a performance regression relative to Python 3.1 in the
   caching of compiled regular expressions.
 
 - Added missing FeedParser and BytesFeedParser to email.parser.__all__.
 
-- Issue #17431: Fix missing import of BytesFeedParser in email.parser.
+- bpo-17431: Fix missing import of BytesFeedParser in email.parser.
 
-- Issue #12921: http.server's send_error takes an explain argument to send more
+- bpo-12921: http.server's send_error takes an explain argument to send more
   information in response. Patch contributed by Karl.
 
-- Issue #17414: Add timeit, repeat, and default_timer to timeit.__all__.
+- bpo-17414: Add timeit, repeat, and default_timer to timeit.__all__.
 
-- Issue #1285086: Get rid of the refcounting hack and speed up
+- bpo-1285086: Get rid of the refcounting hack and speed up
   urllib.parse.unquote() and urllib.parse.unquote_to_bytes().
 
-- Issue #17099: Have importlib.find_loader() raise ValueError when __loader__
-  is not set, harmonizing with what happens when the attribute is set to None.
+- bpo-17099: Have importlib.find_loader() raise ValueError when __loader__
+  is not set, harmonizing with what happens when the attribute is set to
+  None.
 
 - Expose the O_PATH constant in the os module if it is available.
 
-- Issue #17368: Fix an off-by-one error in the Python JSON decoder that caused
+- bpo-17368: Fix an off-by-one error in the Python JSON decoder that caused
   a failure while decoding empty object literals when object_pairs_hook was
   specified.
 
-- Issue #17385: Fix quadratic behavior in threading.Condition.  The FIFO
-  queue now uses a deque instead of a list.
+- bpo-17385: Fix quadratic behavior in threading.Condition.  The FIFO queue
+  now uses a deque instead of a list.
 
-- Issue #15806: Add contextlib.ignore().  This creates a context manager to
-  ignore specified exceptions, replacing the "except SomeException: pass" idiom.
+- bpo-15806: Add contextlib.ignore().  This creates a context manager to
+  ignore specified exceptions, replacing the "except SomeException: pass"
+  idiom.
 
-- Issue #14645: The email generator classes now produce output using the
-  specified linesep throughout.  Previously if the prolog, epilog, or
-  body were stored with a different linesep, that linesep was used.  This
-  fix corrects an RFC non-compliance issue with smtplib.send_message.
+- bpo-14645: The email generator classes now produce output using the
+  specified linesep throughout.  Previously if the prolog, epilog, or body
+  were stored with a different linesep, that linesep was used.  This fix
+  corrects an RFC non- compliance issue with smtplib.send_message.
 
-- Issue #17278: Fix a crash in heapq.heappush() and heapq.heappop() when
-  the list is being resized concurrently.
+- bpo-17278: Fix a crash in heapq.heappush() and heapq.heappop() when the
+  list is being resized concurrently.
 
-- Issue #16962: Use getdents64 instead of the obsolete getdents syscall
-  in the subprocess module on Linux.
+- bpo-16962: Use getdents64 instead of the obsolete getdents syscall in the
+  subprocess module on Linux.
 
-- Issue #16935: unittest now counts the module as skipped if it raises SkipTest,
-  instead of counting it as an error.  Patch by Zachary Ware.
+- bpo-16935: unittest now counts the module as skipped if it raises
+  SkipTest, instead of counting it as an error.  Patch by Zachary Ware.
 
-- Issue #17018: Make Process.join() retry if os.waitpid() fails with EINTR.
+- bpo-17018: Make Process.join() retry if os.waitpid() fails with EINTR.
 
-- Issue #17223: array module: Fix a crasher when converting an array containing
+- bpo-17223: array module: Fix a crasher when converting an array containing
   invalid characters (outside range [U+0000; U+10ffff]) to Unicode:
-  repr(array), str(array) and array.tounicode(). Patch written by Manuel Jacob.
+  repr(array), str(array) and array.tounicode(). Patch written by Manuel
+  Jacob.
 
-- Issue #17197: profile/cProfile modules refactored so that code of run() and
+- bpo-17197: profile/cProfile modules refactored so that code of run() and
   runctx() utility functions is not duplicated in both modules.
 
-- Issue #14720: sqlite3: Convert datetime microseconds correctly.
-  Patch by Lowe Thiderman.
+- bpo-14720: sqlite3: Convert datetime microseconds correctly. Patch by Lowe
+  Thiderman.
 
-- Issue #15132: Allow a list for the defaultTest argument of
+- bpo-15132: Allow a list for the defaultTest argument of
   unittest.TestProgram. Patch by Jyrki Pulliainen.
 
-- Issue #17225: JSON decoder now counts columns in the first line starting
-  with 1, as in other lines.
+- bpo-17225: JSON decoder now counts columns in the first line starting with
+  1, as in other lines.
 
-- Issue #6623: Added explicit DeprecationWarning for ftplib.netrc, which has
+- bpo-6623: Added explicit DeprecationWarning for ftplib.netrc, which has
   been deprecated and undocumented for a long time.
 
-- Issue #13700: Fix byte/string handling in imaplib authentication when an
+- bpo-13700: Fix byte/string handling in imaplib authentication when an
   authobject is specified.
 
-- Issue #13153: Tkinter functions now raise TclError instead of ValueError when
+- bpo-13153: Tkinter functions now raise TclError instead of ValueError when
   a string argument contains non-BMP character.
 
-- Issue #9669: Protect re against infinite loops on zero-width matching in
-  non-greedy repeat.  Patch by Matthew Barnett.
+- bpo-9669: Protect re against infinite loops on zero-width matching in non-
+  greedy repeat.  Patch by Matthew Barnett.
 
-- Issue #13169: The maximal repetition number in a regular expression has been
+- bpo-13169: The maximal repetition number in a regular expression has been
   increased from 65534 to 2147483647 (on 32-bit platform) or 4294967294 (on
   64-bit).
 
-- Issue #17143: Fix a missing import in the trace module.  Initial patch by
+- bpo-17143: Fix a missing import in the trace module.  Initial patch by
   Berker Peksag.
 
-- Issue #15220: email.feedparser's line splitting algorithm is now simpler and
+- bpo-15220: email.feedparser's line splitting algorithm is now simpler and
   faster.
 
-- Issue #16743: Fix mmap overflow check on 32 bit Windows.
+- bpo-16743: Fix mmap overflow check on 32 bit Windows.
 
-- Issue #16996: webbrowser module now uses shutil.which() to find a
-  web-browser on the executable search path.
+- bpo-16996: webbrowser module now uses shutil.which() to find a web-browser
+  on the executable search path.
 
-- Issue #16800: tempfile.gettempdir() no longer left temporary files when
-  the disk is full.  Original patch by Amir Szekely.
+- bpo-16800: tempfile.gettempdir() no longer left temporary files when the
+  disk is full. Original patch by Amir Szekely.
 
-- Issue #17192: Import libffi-3.0.12.
+- bpo-17192: Import libffi-3.0.12.
 
-- Issue #16564: Fixed regression relative to Python2 in the operation of
+- bpo-16564: Fixed regression relative to Python2 in the operation of
   email.encoders.encode_7or8bit when used with binary data.
 
-- Issue #17052: unittest discovery should use self.testLoader.
+- bpo-17052: unittest discovery should use self.testLoader.
 
-- Issue #4591: Uid and gid values larger than 2**31 are supported now.
+- bpo-4591: Uid and gid values larger than 2**31 are supported now.
 
-- Issue #17141: random.vonmisesvariate() no longer hangs for large kappas.
+- bpo-17141: random.vonmisesvariate() no longer hangs for large kappas.
 
-- Issue #17149: Fix random.vonmisesvariate to always return results in
-  [0, 2*math.pi].
+- bpo-17149: Fix random.vonmisesvariate to always return results in [0,
+  2*math.pi].
 
-- Issue #1470548: XMLGenerator now works with binary output streams.
+- bpo-1470548: XMLGenerator now works with binary output streams.
 
-- Issue #6975: os.path.realpath() now correctly resolves multiple nested
+- bpo-6975: os.path.realpath() now correctly resolves multiple nested
   symlinks on POSIX platforms.
 
-- Issue #13773: sqlite3.connect() gets a new `uri` parameter to pass the
+- bpo-13773: sqlite3.connect() gets a new `uri` parameter to pass the
   filename as a URI, allowing to pass custom options.
 
-- Issue #16564: Fixed regression relative to Python2 in the operation of
+- bpo-16564: Fixed regression relative to Python2 in the operation of
   email.encoders.encode_noop when used with binary data.
 
-- Issue #10355: The mode, name, encoding and newlines properties now work on
+- bpo-10355: The mode, name, encoding and newlines properties now work on
   SpooledTemporaryFile objects even when they have not yet rolled over.
   Obsolete method xreadline (which has never worked in Python 3) has been
   removed.
 
-- Issue #16686: Fixed a lot of bugs in audioop module.  Fixed crashes in
-  avgpp(), maxpp() and ratecv().  Fixed an integer overflow in add(), bias(),
-  and ratecv().  reverse(), lin2lin() and ratecv() no more lose precision for
-  32-bit samples.  max() and rms() no more returns a negative result and
-  various other functions now work correctly with 32-bit sample -0x80000000.
+- bpo-16686: Fixed a lot of bugs in audioop module.  Fixed crashes in
+  avgpp(), maxpp() and ratecv().  Fixed an integer overflow in add(),
+  bias(), and ratecv(). reverse(), lin2lin() and ratecv() no more lose
+  precision for 32-bit samples. max() and rms() no more returns a negative
+  result and various other functions now work correctly with 32-bit sample
+  -0x80000000.
 
-- Issue #17073: Fix some integer overflows in sqlite3 module.
+- bpo-17073: Fix some integer overflows in sqlite3 module.
 
-- Issue #16723: httplib.HTTPResponse no longer marked closed when the connection
-  is automatically closed.
+- bpo-16723: httplib.HTTPResponse no longer marked closed when the
+  connection is automatically closed.
 
-- Issue #15359: Add CAN_BCM protocol support to the socket module. Patch by
+- bpo-15359: Add CAN_BCM protocol support to the socket module. Patch by
   Brian Thorne.
 
-- Issue #16948: Fix quoted printable body encoding for non-latin1 character
+- bpo-16948: Fix quoted printable body encoding for non-latin1 character
   sets in the email package.
 
-- Issue #16811: Fix folding of headers with no value in the provisional email
+- bpo-16811: Fix folding of headers with no value in the provisional email
   policies.
 
-- Issue #17132: Update symbol for "yield from" grammar changes.
+- bpo-17132: Update symbol for "yield from" grammar changes.
 
-- Issue #17076: Make copying of xattrs more tolerant of missing FS support.
+- bpo-17076: Make copying of xattrs more tolerant of missing FS support.
   Patch by Thomas Wouters.
 
-- Issue #17089: Expat parser now correctly works with string input when the
+- bpo-17089: Expat parser now correctly works with string input when the
   internal XML encoding is not UTF-8 or US-ASCII.  It also now accepts bytes
   and strings larger than 2 GiB.
 
-- Issue #6083: Fix multiple segmentation faults occured when PyArg_ParseTuple
+- bpo-6083: Fix multiple segmentation faults occured when PyArg_ParseTuple
   parses nested mutating sequence.
 
-- Issue #5289: Fix ctypes.util.find_library on Solaris.
+- bpo-5289: Fix ctypes.util.find_library on Solaris.
 
-- Issue #17106: Fix a segmentation fault in io.TextIOWrapper when an underlying
+- bpo-17106: Fix a segmentation fault in io.TextIOWrapper when an underlying
   stream or a decoder produces data of an unexpected type (i.e. when
-  io.TextIOWrapper initialized with text stream or use bytes-to-bytes codec).
+  io.TextIOWrapper initialized with text stream or use bytes-to-bytes
+  codec).
 
-- Issue #17015: When it has a spec, a Mock object now inspects its signature
-  when matching calls, so that arguments can be matched positionally or
-  by name.
+- bpo-17015: When it has a spec, a Mock object now inspects its signature
+  when matching calls, so that arguments can be matched positionally or by
+  name.
 
-- Issue #15633: httplib.HTTPResponse is now mark closed when the server
-  sends less than the advertised Content-Length.
+- bpo-15633: httplib.HTTPResponse is now mark closed when the server sends
+  less than the advertised Content-Length.
 
-- Issue #12268: The io module file object write methods no longer abort early
+- bpo-12268: The io module file object write methods no longer abort early
   when one of its write system calls is interrupted (EINTR).
 
-- Issue #6972: The zipfile module no longer overwrites files outside of
-  its destination path when extracting malicious zip files.
+- bpo-6972: The zipfile module no longer overwrites files outside of its
+  destination path when extracting malicious zip files.
 
-- Issue #4844: ZipFile now raises BadZipFile when opens a ZIP file with an
+- bpo-4844: ZipFile now raises BadZipFile when opens a ZIP file with an
   incomplete "End of Central Directory" record.  Original patch by Guilherme
   Polo and Alan McIntyre.
 
-- Issue #17071: Signature.bind() now works when one of the keyword arguments
-  is named ``self``.
+- bpo-17071: Signature.bind() now works when one of the keyword arguments is
+  named ``self``.
 
-- Issue #12004: Fix an internal error in PyZipFile when writing an invalid
-  Python file.  Patch by Ben Morgan.
+- bpo-12004: Fix an internal error in PyZipFile when writing an invalid
+  Python file. Patch by Ben Morgan.
 
-- Have py_compile use importlib as much as possible to avoid code duplication.
-  Code now raises FileExistsError if the file path to be used for the
-  byte-compiled file is a symlink or non-regular file as a warning that import
-  will not keep the file path type if it writes to that path.
+- Have py_compile use importlib as much as possible to avoid code
+  duplication. Code now raises FileExistsError if the file path to be used
+  for the byte- compiled file is a symlink or non-regular file as a warning
+  that import will not keep the file path type if it writes to that path.
 
-- Issue #16972: Have site.addpackage() consider already known paths even when
+- bpo-16972: Have site.addpackage() consider already known paths even when
   none are explicitly passed in. Bug report and fix by Kirill.
 
-- Issue #1602133: on Mac OS X a shared library build (``--enable-shared``)
-  now fills the ``os.environ`` variable correctly.
+- bpo-1602133: on Mac OS X a shared library build (``--enable-shared``) now
+  fills the ``os.environ`` variable correctly.
 
-- Issue #15505: `unittest.installHandler` no longer assumes SIGINT handler is
+- bpo-15505: `unittest.installHandler` no longer assumes SIGINT handler is
   set to a callable object.
 
-- Issue #13454: Fix a crash when deleting an iterator created by itertools.tee()
-  if all other iterators were very advanced before.
+- bpo-13454: Fix a crash when deleting an iterator created by
+  itertools.tee() if all other iterators were very advanced before.
 
-- Issue #12411: Fix to cgi.parse_multipart to correctly use bytes boundaries
+- bpo-12411: Fix to cgi.parse_multipart to correctly use bytes boundaries
   and bytes data. Patch by Jonas Wagner.
 
-- Issue #16957: shutil.which() no longer searches a bare file name in the
+- bpo-16957: shutil.which() no longer searches a bare file name in the
   current directory on Unix and no longer searches a relative file path with
   a directory part in PATH directories.  Patch by Thomas Kluyver.
 
-- Issue #1159051: GzipFile now raises EOFError when reading a corrupted file
+- bpo-1159051: GzipFile now raises EOFError when reading a corrupted file
   with truncated header or footer.
 
-- Issue #16993: shutil.which() now preserves the case of the path and extension
+- bpo-16993: shutil.which() now preserves the case of the path and extension
   on Windows.
 
-- Issue #16992: On Windows in signal.set_wakeup_fd, validate the file
+- bpo-16992: On Windows in signal.set_wakeup_fd, validate the file
   descriptor argument.
 
-- Issue #16422: For compatibility with the Python version, the C version of
+- bpo-16422: For compatibility with the Python version, the C version of
   decimal now uses strings instead of integers for rounding mode constants.
 
-- Issue #15861: tkinter now correctly works with lists and tuples containing
+- bpo-15861: tkinter now correctly works with lists and tuples containing
   strings with whitespaces, backslashes or unbalanced braces.
 
-- Issue #9720: zipfile now writes correct local headers for files larger than
-  GiB.
+- bpo-9720: zipfile now writes correct local headers for files larger than 4
+  GiB.
 
-- Issue #16955: Fix the poll() method for multiprocessing's socket
-  connections on Windows.
+- bpo-16955: Fix the poll() method for multiprocessing's socket connections
+  on Windows.
 
 - SSLContext.load_dh_params() now properly closes the input file.
 
-- Issue #15031: Refactor some .pyc management code to cut down on code
-  duplication. Thanks to Ronan Lamy for the report and taking an initial stab
-  at the problem.
+- bpo-15031: Refactor some .pyc management code to cut down on code
+  duplication. Thanks to Ronan Lamy for the report and taking an initial
+  stab at the problem.
 
-- Issue #16398: Optimize deque.rotate() so that it only moves pointers
-  and doesn't touch the underlying data with increfs and decrefs.
+- bpo-16398: Optimize deque.rotate() so that it only moves pointers and
+  doesn't touch the underlying data with increfs and decrefs.
 
-- Issue #16900: Issue a ResourceWarning when an ssl socket is left unclosed.
+- bpo-16900: Issue a ResourceWarning when an ssl socket is left unclosed.
 
-- Issue #13899: ``\A``, ``\Z``, and ``\B`` now correctly match the A, Z,
-  and B literals when used inside character classes (e.g. ``'[\A]'``).
-  Patch by Matthew Barnett.
+- bpo-13899: ``\A``, ``\Z``, and ``\B`` now correctly match the A, Z, and B
+  literals when used inside character classes (e.g. ``'[\A]'``). Patch by
+  Matthew Barnett.
 
-- Issue #15545: Fix regression in sqlite3's iterdump method where it was
+- bpo-15545: Fix regression in sqlite3's iterdump method where it was
   failing if the connection used a row factory (such as sqlite3.Row) that
   produced unsortable objects. (Regression was introduced by fix for 9750).
 
 - fcntl: add F_DUPFD_CLOEXEC constant, available on Linux 2.6.24+.
 
-- Issue #15972: Fix error messages when os functions expecting a file name or
+- bpo-15972: Fix error messages when os functions expecting a file name or
   file descriptor receive the incorrect type.
 
-- Issue #8109: The ssl module now has support for server-side SNI, thanks
-  to a :meth:`SSLContext.set_servername_callback` method.  Patch by Daniel
-  Black.
+- bpo-8109: The ssl module now has support for server-side SNI, thanks to a
+  :meth:`SSLContext.set_servername_callback` method.  Patch by Daniel Black.
 
-- Issue #16860: In tempfile, use O_CLOEXEC when available to set the
-  close-on-exec flag atomically.
+- bpo-16860: In tempfile, use O_CLOEXEC when available to set the close-on-
+  exec flag atomically.
 
-- Issue #16674: random.getrandbits() is now 20-40% faster for small integers.
+- bpo-16674: random.getrandbits() is now 20-40% faster for small integers.
 
-- Issue #16009: JSON error messages now provide more information.
+- bpo-16009: JSON error messages now provide more information.
 
-- Issue #16828: Fix error incorrectly raised by bz2.compress(b'') and
+- bpo-16828: Fix error incorrectly raised by bz2.compress(b'') and
   bz2.BZ2Compressor.compress(b''). Initial patch by Martin Packman.
 
-- Issue #16833: In http.client.HTTPConnection, do not concatenate the request
+- bpo-16833: In http.client.HTTPConnection, do not concatenate the request
   headers and body when the payload exceeds 16 KB, since it can consume more
   memory for no benefit.  Patch by Benno Leslie.
 
-- Issue #16541: tk_setPalette() now works with keyword arguments.
+- bpo-16541: tk_setPalette() now works with keyword arguments.
 
-- Issue #16820: In configparser, `parser.popitem()` no longer raises ValueError.
-  This makes `parser.clean()` work correctly.
+- bpo-16820: In configparser, `parser.popitem()` no longer raises
+  ValueError. This makes `parser.clean()` work correctly.
 
-- Issue #16820: In configparser, ``parser['section'] = {}`` now preserves
-  section order within the parser. This makes `parser.update()` preserve section
-  order as well.
+- bpo-16820: In configparser, ``parser['section'] = {}`` now preserves
+  section order within the parser. This makes `parser.update()` preserve
+  section order as well.
 
-- Issue #16820: In configparser, ``parser['DEFAULT'] = {}`` now correctly
+- bpo-16820: In configparser, ``parser['DEFAULT'] = {}`` now correctly
   clears previous values stored in the default section. Same goes for
   ``parser.update({'DEFAULT': {}})``.
 
-- Issue #9586: Redefine SEM_FAILED on MacOSX to keep compiler happy.
+- bpo-9586: Redefine SEM_FAILED on MacOSX to keep compiler happy.
 
-- Issue #16787: Increase asyncore and asynchat default output buffers size, to
+- bpo-16787: Increase asyncore and asynchat default output buffers size, to
   decrease CPU usage and increase throughput.
 
-- Issue #10527: make multiprocessing use poll() instead of select() if available.
+- bpo-10527: make multiprocessing use poll() instead of select() if
+  available.
 
-- Issue #16688: Now regexes contained backreferences correctly work with
-  non-ASCII strings.  Patch by Matthew Barnett.
+- bpo-16688: Now regexes contained backreferences correctly work with non-
+  ASCII strings. Patch by Matthew Barnett.
 
-- Issue #16486: Make aifc files act as context managers.
+- bpo-16486: Make aifc files act as context managers.
 
-- Issue #16485: Now file descriptors are closed if file header patching failed
+- bpo-16485: Now file descriptors are closed if file header patching failed
   on closing an aifc file.
 
-- Issue #16640: Run less code under a lock in sched module.
+- bpo-16640: Run less code under a lock in sched module.
 
-- Issue #16165: sched.scheduler.run() no longer blocks a scheduler for other
+- bpo-16165: sched.scheduler.run() no longer blocks a scheduler for other
   threads.
 
-- Issue #16641: Default values of sched.scheduler.enter() are no longer
+- bpo-16641: Default values of sched.scheduler.enter() are no longer
   modifiable.
 
-- Issue #16618: Make glob.glob match consistently across strings and bytes
+- bpo-16618: Make glob.glob match consistently across strings and bytes
   regarding leading dots.  Patch by Serhiy Storchaka.
 
-- Issue #16788: Add samestat to Lib/ntpath.py
+- bpo-16788: Add samestat to Lib/ntpath.py
 
-- Issue #16713: Parsing of 'tel' urls using urlparse separates params from
+- bpo-16713: Parsing of 'tel' urls using urlparse separates params from
   path.
 
-- Issue #16443: Add docstrings to regular expression match objects.
-  Patch by Anton Kasyanov.
+- bpo-16443: Add docstrings to regular expression match objects. Patch by
+  Anton Kasyanov.
 
-- Issue #15701: Fix HTTPError info method call to return the headers information.
+- bpo-15701: Fix HTTPError info method call to return the headers
+  information.
 
-- Issue #16752: Add a missing import to modulefinder. Patch by Berker Peksag.
+- bpo-16752: Add a missing import to modulefinder. Patch by Berker Peksag.
 
-- Issue #16646: ftplib.FTP.makeport() might lose socket error details.
-  (patch by Serhiy Storchaka)
+- bpo-16646: ftplib.FTP.makeport() might lose socket error details. (patch
+  by Serhiy Storchaka)
 
-- Issue #16626: Fix infinite recursion in glob.glob() on Windows when the
+- bpo-16626: Fix infinite recursion in glob.glob() on Windows when the
   pattern contains a wildcard in the drive or UNC path.  Patch by Serhiy
   Storchaka.
 
-- Issue #15783: Except for the number methods, the C version of decimal now
+- bpo-15783: Except for the number methods, the C version of decimal now
   supports all None default values present in decimal.py. These values were
   largely undocumented.
 
-- Issue #11175: argparse.FileType now accepts encoding and errors
-  arguments. Patch by Lucas Maystre.
+- bpo-11175: argparse.FileType now accepts encoding and errors arguments.
+  Patch by Lucas Maystre.
 
-- Issue #16488: epoll() objects now support the `with` statement.  Patch
-  by Serhiy Storchaka.
+- bpo-16488: epoll() objects now support the `with` statement.  Patch by
+  Serhiy Storchaka.
 
-- Issue #16298: In HTTPResponse.read(), close the socket when there is no
+- bpo-16298: In HTTPResponse.read(), close the socket when there is no
   Content-Length and the incoming stream is finished.  Patch by Eran
   Rundstein.
 
-- Issue #16049: Add abc.ABC class to enable the use of inheritance to create
+- bpo-16049: Add abc.ABC class to enable the use of inheritance to create
   ABCs, rather than the more cumbersome metaclass=ABCMeta. Patch by Bruno
   Dupuis.
 
 - Expose the TCP_FASTOPEN and MSG_FASTOPEN flags in socket when they're
   available.
 
-- Issue #15701: Add a .headers attribute to urllib.error.HTTPError. Patch
+- bpo-15701: Add a .headers attribute to urllib.error.HTTPError. Patch
   contributed by Berker Peksag.
 
-- Issue #15872: Fix 3.3 regression introduced by the new fd-based shutil.rmtree
+- bpo-15872: Fix 3.3 regression introduced by the new fd-based shutil.rmtree
   that caused it to not ignore certain errors when ignore_errors was set.
   Patch by Alessandro Moura and Serhiy Storchaka.
 
-- Issue #16248: Disable code execution from the user's home directory by
+- bpo-16248: Disable code execution from the user's home directory by
   tkinter when the -E flag is passed to Python.  Patch by Zachary Ware.
 
-- Issue #13390: New function :func:`sys.getallocatedblocks()` returns the
+- bpo-13390: New function :func:`sys.getallocatedblocks()` returns the
   number of memory blocks currently allocated.
 
-- Issue #16628: Fix a memory leak in ctypes.resize().
+- bpo-16628: Fix a memory leak in ctypes.resize().
 
-- Issue #13614: Fix setup.py register failure with invalid rst in description.
+- bpo-13614: Fix setup.py register failure with invalid rst in description.
   Patch by Julien Courteau and Pierre Paul Lefebvre.
 
-- Issue #13512: Create ~/.pypirc securely (CVE-2011-4944).  Initial patch by
+- bpo-13512: Create ~/.pypirc securely (CVE-2011-4944).  Initial patch by
   Philip Jenvey, tested by Mageia and Debian.
 
-- Issue #7719: Make distutils ignore ``.nfs*`` files instead of choking later
+- bpo-7719: Make distutils ignore ``.nfs*`` files instead of choking later
   on.  Initial patch by SilentGhost and Jeff Ramnani.
 
-- Issue #13120: Allow to call pdb.set_trace() from thread.
-  Patch by Ilya Sandler.
+- bpo-13120: Allow to call pdb.set_trace() from thread. Patch by Ilya
+  Sandler.
 
-- Issue #16585: Make CJK encoders support error handlers that return bytes per
+- bpo-16585: Make CJK encoders support error handlers that return bytes per
   PEP 383.
 
-- Issue #10182: The re module doesn't truncate indices to 32 bits anymore.
+- bpo-10182: The re module doesn't truncate indices to 32 bits anymore.
   Patch by Serhiy Storchaka.
 
-- Issue #16333: use (",", ": ") as default separator in json when indent is
+- bpo-16333: use (",", ": ") as default separator in json when indent is
   specified, to avoid trailing whitespace.  Patch by Serhiy Storchaka.
 
-- Issue #16573: In 2to3, treat enumerate() like a consuming call, so superfluous
-  list() calls aren't added to filter(), map(), and zip() which are directly
-  passed enumerate().
+- bpo-16573: In 2to3, treat enumerate() like a consuming call, so
+  superfluous list() calls aren't added to filter(), map(), and zip() which
+  are directly passed enumerate().
 
-- Issue #16464: Reset the Content-Length header when a urllib Request is reused
+- bpo-16464: Reset the Content-Length header when a urllib Request is reused
   with new data.
 
-- Issue #12848: The pure Python pickle implementation now treats object
-  lengths as unsigned 32-bit integers, like the C implementation does.
-  Patch by Serhiy Storchaka.
+- bpo-12848: The pure Python pickle implementation now treats object lengths
+  as unsigned 32-bit integers, like the C implementation does. Patch by
+  Serhiy Storchaka.
 
-- Issue #16423: urllib.request now has support for ``data:`` URLs.  Patch by
+- bpo-16423: urllib.request now has support for ``data:`` URLs.  Patch by
   Mathias Panzenböck.
 
-- Issue #4473: Add a POP3.stls() to switch a clear-text POP3 session into
-  an encrypted POP3 session, on supported servers.  Patch by Lorenzo Catucci.
+- bpo-4473: Add a POP3.stls() to switch a clear-text POP3 session into an
+  encrypted POP3 session, on supported servers.  Patch by Lorenzo Catucci.
 
-- Issue #4473: Add a POP3.capa() method to query the capabilities advertised
-  by the POP3 server.  Patch by Lorenzo Catucci.
+- bpo-4473: Add a POP3.capa() method to query the capabilities advertised by
+  the POP3 server.  Patch by Lorenzo Catucci.
 
-- Issue #4473: Ensure the socket is shutdown cleanly in POP3.close().
-  Patch by Lorenzo Catucci.
+- bpo-4473: Ensure the socket is shutdown cleanly in POP3.close(). Patch by
+  Lorenzo Catucci.
 
-- Issue #16522: added FAIL_FAST flag to doctest.
+- bpo-16522: added FAIL_FAST flag to doctest.
 
-- Issue #15627: Add the importlib.abc.InspectLoader.source_to_code() method.
+- bpo-15627: Add the importlib.abc.InspectLoader.source_to_code() method.
 
-- Issue #16408: Fix file descriptors not being closed in error conditions
-  in the zipfile module.  Patch by Serhiy Storchaka.
+- bpo-16408: Fix file descriptors not being closed in error conditions in
+  the zipfile module.  Patch by Serhiy Storchaka.
 
-- Issue #14631: Add a new :class:`weakref.WeakMethod` to simulate weak
+- bpo-14631: Add a new :class:`weakref.WeakMethod` to simulate weak
   references to bound methods.
 
-- Issue #16469: Fix exceptions from float -> Fraction and Decimal -> Fraction
-  conversions for special values to be consistent with those for float -> int
-  and Decimal -> int.  Patch by Alexey Kachayev.
+- bpo-16469: Fix exceptions from float -> Fraction and Decimal -> Fraction
+  conversions for special values to be consistent with those for float ->
+  int and Decimal -> int.  Patch by Alexey Kachayev.
 
-- Issue #16481: multiprocessing no longer leaks process handles on Windows.
+- bpo-16481: multiprocessing no longer leaks process handles on Windows.
 
-- Issue #12428: Add a pure Python implementation of functools.partial().
-  Patch by Brian Thorne.
+- bpo-12428: Add a pure Python implementation of functools.partial(). Patch
+  by Brian Thorne.
 
-- Issue #16140: The subprocess module no longer double closes its child
+- bpo-16140: The subprocess module no longer double closes its child
   subprocess.PIPE parent file descriptors on child error prior to exec().
 
 - Remove a bare print to stdout from the subprocess module that could have
@@ -5662,194 +5765,199 @@ Library
 - The subprocess module now raises its own SubprocessError instead of a
   RuntimeError in various error situations which should not normally happen.
 
-- Issue #16327: The subprocess module no longer leaks file descriptors
-  used for stdin/stdout/stderr pipes to the child when fork() fails.
+- bpo-16327: The subprocess module no longer leaks file descriptors used for
+  stdin/stdout/stderr pipes to the child when fork() fails.
 
-- Issue #14396: Handle the odd rare case of waitpid returning 0 when not
+- bpo-14396: Handle the odd rare case of waitpid returning 0 when not
   expected in subprocess.Popen.wait().
 
-- Issue #16411: Fix a bug where zlib.decompressobj().flush() might try to access
-  previously-freed memory. Patch by Serhiy Storchaka.
+- bpo-16411: Fix a bug where zlib.decompressobj().flush() might try to
+  access previously- freed memory. Patch by Serhiy Storchaka.
 
-- Issue #16357: fix calling accept() on a SSLSocket created through
+- bpo-16357: fix calling accept() on a SSLSocket created through
   SSLContext.wrap_socket().  Original patch by Jeff McNeil.
 
-- Issue #16409: The reporthook callback made by the legacy
+- bpo-16409: The reporthook callback made by the legacy
   urllib.request.urlretrieve API now properly supplies a constant non-zero
   block_size as it did in Python 3.2 and 2.7.  This matches the behavior of
   urllib.request.URLopener.retrieve.
 
-- Issue #16431: Use the type information when constructing a Decimal subtype
+- bpo-16431: Use the type information when constructing a Decimal subtype
   from a Decimal argument.
 
-- Issue #15641: Clean up deprecated classes from importlib.
-  Patch by Taras Lyapun.
+- bpo-15641: Clean up deprecated classes from importlib. Patch by Taras
+  Lyapun.
 
-- Issue #16350: zlib.decompressobj().decompress() now accumulates data from
-  successive calls after EOF in unused_data, instead of only saving the argument
-  to the last call. decompressobj().flush() now correctly sets unused_data and
-  unconsumed_tail. A bug in the handling of MemoryError when setting the
-  unconsumed_tail attribute has also been fixed. Patch by Serhiy Storchaka.
+- bpo-16350: zlib.decompressobj().decompress() now accumulates data from
+  successive calls after EOF in unused_data, instead of only saving the
+  argument to the last call. decompressobj().flush() now correctly sets
+  unused_data and unconsumed_tail. A bug in the handling of MemoryError when
+  setting the unconsumed_tail attribute has also been fixed. Patch by Serhiy
+  Storchaka.
 
-- Issue #12759: sre_parse now raises a proper error when the name of the group
-  is missing.  Initial patch by Serhiy Storchaka.
+- bpo-12759: sre_parse now raises a proper error when the name of the group
+  is missing. Initial patch by Serhiy Storchaka.
 
-- Issue #16152: fix tokenize to ignore whitespace at the end of the code when
+- bpo-16152: fix tokenize to ignore whitespace at the end of the code when
   no newline is found.  Patch by Ned Batchelder.
 
-- Issue #16284: Prevent keeping unnecessary references to worker functions
-  in concurrent.futures ThreadPoolExecutor.
+- bpo-16284: Prevent keeping unnecessary references to worker functions in
+  concurrent.futures ThreadPoolExecutor.
 
-- Issue #16230: Fix a crash in select.select() when one the lists changes
-  size while iterated on.  Patch by Serhiy Storchaka.
+- bpo-16230: Fix a crash in select.select() when one the lists changes size
+  while iterated on.  Patch by Serhiy Storchaka.
 
-- Issue #16228: Fix a crash in the json module where a list changes size
-  while it is being encoded.  Patch by Serhiy Storchaka.
+- bpo-16228: Fix a crash in the json module where a list changes size while
+  it is being encoded.  Patch by Serhiy Storchaka.
 
-- Issue #16351: New function gc.get_stats() returns per-generation collection
+- bpo-16351: New function gc.get_stats() returns per-generation collection
   statistics.
 
-- Issue #14897: Enhance error messages of struct.pack and
-  struct.pack_into. Patch by Matti Mäki.
+- bpo-14897: Enhance error messages of struct.pack and struct.pack_into.
+  Patch by Matti Mäki.
 
-- Issue #16316: mimetypes now recognizes the .xz and .txz (.tar.xz) extensions.
+- bpo-16316: mimetypes now recognizes the .xz and .txz (.tar.xz) extensions.
   Patch by Serhiy Storchaka.
 
-- Issue #12890: cgitb no longer prints spurious <p> tags in text
-  mode when the logdir option is specified.
+- bpo-12890: cgitb no longer prints spurious <p> tags in text mode when the
+  logdir option is specified.
 
-- Issue #16307: Fix multiprocessing.Pool.map_async not calling its callbacks.
+- bpo-16307: Fix multiprocessing.Pool.map_async not calling its callbacks.
   Patch by Janne Karila.
 
-- Issue #16305: Fix a segmentation fault occurring when interrupting
+- bpo-16305: Fix a segmentation fault occurring when interrupting
   math.factorial.
 
-- Issue #16116: Fix include and library paths to be correct when building C
+- bpo-16116: Fix include and library paths to be correct when building C
   extensions in venvs.
 
-- Issue #16245: Fix the value of a few entities in html.entities.html5.
+- bpo-16245: Fix the value of a few entities in html.entities.html5.
 
-- Issue #16301: Fix the localhost verification in urllib/request.py for file://
+- bpo-16301: Fix the localhost verification in urllib/request.py for file://
   urls.
 
-- Issue #16250: Fix the invocations of URLError which had misplaced filename
+- bpo-16250: Fix the invocations of URLError which had misplaced filename
   attribute for exception.
 
-- Issue #10836: Fix exception raised when file not found in urlretrieve
-  Initial patch by Ezio Melotti.
+- bpo-10836: Fix exception raised when file not found in urlretrieve Initial
+  patch by Ezio Melotti.
 
-- Issue #14398: Fix size truncation and overflow bugs in the bz2 module.
+- bpo-14398: Fix size truncation and overflow bugs in the bz2 module.
 
-- Issue #12692: Fix resource leak in urllib.request when talking to an HTTP
-  server that does not include a ``Connection: close`` header in its responses.
+- bpo-12692: Fix resource leak in urllib.request when talking to an HTTP
+  server that does not include a ``Connection: close`` header in its
+  responses.
 
-- Issue #12034: Fix bogus caching of result in check_GetFinalPathNameByHandle.
+- bpo-12034: Fix bogus caching of result in check_GetFinalPathNameByHandle.
   Patch by Atsuo Ishimoto.
 
 - Improve performance of `lzma.LZMAFile` (see also issue #16034).
 
-- Issue #16220: wsgiref now always calls close() on an iterable response.
-  Patch by Brent Tubbs.
+- bpo-16220: wsgiref now always calls close() on an iterable response. Patch
+  by Brent Tubbs.
 
-- Issue #16270: urllib may hang when used for retrieving files via FTP by using
+- bpo-16270: urllib may hang when used for retrieving files via FTP by using
   a context manager.  Patch by Giampaolo Rodola'.
 
-- Issue #16461: Wave library should be able to deal with 4GB wav files,
-  and sample rate of 44100 Hz.
+- bpo-16461: Wave library should be able to deal with 4GB wav files, and
+  sample rate of 44100 Hz.
 
-- Issue #16176: Properly identify Windows 8 via platform.platform()
+- bpo-16176: Properly identify Windows 8 via platform.platform()
 
-- Issue #16088: BaseHTTPRequestHandler's send_error method includes a
-  Content-Length header in it's response now. Patch by Antoine Pitrou.
+- bpo-16088: BaseHTTPRequestHandler's send_error method includes a Content-
+  Length header in it's response now. Patch by Antoine Pitrou.
 
-- Issue #16114: The subprocess module no longer provides a misleading error
-  message stating that args[0] did not exist when either the cwd or executable
-  keyword arguments specified a path that did not exist.
+- bpo-16114: The subprocess module no longer provides a misleading error
+  message stating that args[0] did not exist when either the cwd or
+  executable keyword arguments specified a path that did not exist.
 
-- Issue #16169: Fix ctypes.WinError()'s confusion between errno and winerror.
+- bpo-16169: Fix ctypes.WinError()'s confusion between errno and winerror.
 
-- Issue #16110: logging.fileConfig now accepts a pre-initialised ConfigParser
+- bpo-16110: logging.fileConfig now accepts a pre-initialised ConfigParser
   instance.
 
-- Issue #1492704: shutil.copyfile() raises a distinct SameFileError now if
+- bpo-1492704: shutil.copyfile() raises a distinct SameFileError now if
   source and destination are the same file. Patch by Atsuo Ishimoto.
 
-- Issue #13896: Make shelf instances work with 'with' as context managers.
+- bpo-13896: Make shelf instances work with 'with' as context managers.
   Original patch by Filip Gruszczyński.
 
-- Issue #15417: Add support for csh and fish in venv activation scripts.
+- bpo-15417: Add support for csh and fish in venv activation scripts.
 
-- Issue #14377: ElementTree.write and some of the module-level functions have
-  new parameter - *short_empty_elements*. It controls how elements with no
+- bpo-14377: ElementTree.write and some of the module-level functions have a
+  new parameter - *short_empty_elements*. It controls how elements with no
   contents are emitted.
 
-- Issue #16089: Allow ElementTree.TreeBuilder to work again with a non-Element
+- bpo-16089: Allow ElementTree.TreeBuilder to work again with a non-Element
   element_factory (fixes a regression in SimpleTAL).
 
-- Issue #9650: List commonly used format codes in time.strftime and
+- bpo-9650: List commonly used format codes in time.strftime and
   time.strptime docsttings.  Original patch by Mike Hoy.
 
-- Issue #15452: logging configuration socket listener now has a verify option
+- bpo-15452: logging configuration socket listener now has a verify option
   that allows an application to apply a verification function to the
   received configuration data before it is acted upon.
 
-- Issue #16034: Fix performance regressions in the new `bz2.BZ2File`
-  implementation.  Initial patch by Serhiy Storchaka.
+- bpo-16034: Fix performance regressions in the new `bz2.BZ2File`
+  implementation. Initial patch by Serhiy Storchaka.
 
-- `pty.spawn()` now returns the child process status returned by `os.waitpid()`.
+- `pty.spawn()` now returns the child process status returned by
+  `os.waitpid()`.
 
-- Issue #15756: `subprocess.poll()` now properly handles `errno.ECHILD` to
-  return a returncode of 0 when the child has already exited or cannot be waited
-  on.
+- bpo-15756: `subprocess.poll()` now properly handles `errno.ECHILD` to
+  return a returncode of 0 when the child has already exited or cannot be
+  waited on.
 
-- Issue #15323: Improve failure message of `Mock.assert_called_once_with()`.
+- bpo-15323: Improve failure message of `Mock.assert_called_once_with()`.
 
-- Issue #16064: ``unittest -m`` claims executable is "python", not "python3".
+- bpo-16064: ``unittest -m`` claims executable is "python", not "python3".
 
-- Issue #12376: Pass on parameters in `TextTestResult.__init__()` super call.
+- bpo-12376: Pass on parameters in `TextTestResult.__init__()` super call.
 
-- Issue #15222: Insert blank line after each message in mbox mailboxes.
+- bpo-15222: Insert blank line after each message in mbox mailboxes.
 
-- Issue #16013: Fix `csv.Reader` parsing issue with ending quote characters.
+- bpo-16013: Fix `csv.Reader` parsing issue with ending quote characters.
   Patch by Serhiy Storchaka.
 
-- Issue #15421: Fix an OverflowError in `Calendar.itermonthdates()` after
+- bpo-15421: Fix an OverflowError in `Calendar.itermonthdates()` after
   `datetime.MAXYEAR`.  Patch by Cédric Krier.
 
-- Issue #16112: platform.architecture does not correctly escape argument to
-  /usr/bin/file.  Patch by David Benjamin.
+- bpo-16112: platform.architecture does not correctly escape argument to
+  /usr/bin/file. Patch by David Benjamin.
 
-- Issue #15970: `xml.etree.ElementTree` now serializes correctly the empty HTML
+- bpo-15970: `xml.etree.ElementTree` now serializes correctly the empty HTML
   elements 'meta' and 'param'.
 
-- Issue #15842: The `SocketIO.{readable,writable,seekable}` methods now raise
-  ValueError when the file-like object is closed.  Patch by Alessandro Moura.
+- bpo-15842: The `SocketIO.{readable,writable,seekable}` methods now raise
+  ValueError when the file-like object is closed.  Patch by Alessandro
+  Moura.
 
-- Issue #15876: Fix a refleak in the `curses` module: window.encoding.
+- bpo-15876: Fix a refleak in the `curses` module: window.encoding.
 
-- Issue #15881: Fix `atexit` hook in `multiprocessing`.  Original patch by Chris
-  McDonough.
+- bpo-15881: Fix `atexit` hook in `multiprocessing`.  Original patch by
+  Chris McDonough.
 
-- Issue #15841: The readable(), writable() and seekable() methods of
-  `io.BytesIO` and `io.StringIO` objects now raise ValueError when the object
-  has been closed.  Patch by Alessandro Moura.
+- bpo-15841: The readable(), writable() and seekable() methods of
+  `io.BytesIO` and `io.StringIO` objects now raise ValueError when the
+  object has been closed. Patch by Alessandro Moura.
 
-- Issue #15447: Use `subprocess.DEVNULL` in webbrowser, instead of opening
+- bpo-15447: Use `subprocess.DEVNULL` in webbrowser, instead of opening
   `os.devnull` explicitly and leaving it open.
 
-- Issue #15509: `webbrowser.UnixBrowser` no longer passes empty arguments to
+- bpo-15509: `webbrowser.UnixBrowser` no longer passes empty arguments to
   Popen when ``%action`` substitutions produce empty strings.
 
-- Issue #12776, issue #11839: Call `argparse` type function (specified by
-  add_argument) only once. Before, the type function was called twice in the
-  case where the default was specified and the argument was given as well.  This
-  was especially problematic for the FileType type, as a default file would
-  always be opened, even if a file argument was specified on the command line.
+- bpo-12776: Call `argparse` type function (specified by add_argument) only
+  once. Before, the type function was called twice in the case where the
+  default was specified and the argument was given as well.  This was
+  especially problematic for the FileType type, as a default file would
+  always be opened, even if a file argument was specified on the command
+  line. (See also: bpo-11839)
 
-- Issue #15906: Fix a regression in argparse caused by the preceding change,
+- bpo-15906: Fix a regression in argparse caused by the preceding change,
   when ``action='append'``, ``type='str'`` and ``default=[]``.
 
-- Issue #16113: Added sha3 module based on the Keccak reference implementation
+- bpo-16113: Added sha3 module based on the Keccak reference implementation
   3.2. The `hashlib` module has four additional hash algorithms: `sha3_224`,
   `sha3_256`, `sha3_384` and `sha3_512`. As part of the patch some common
   code was moved from _hashopenssl.c to hashlib.h.
@@ -5857,640 +5965,642 @@ Library
 - ctypes.call_commethod was removed, since its only usage was in the defunct
   samples directory.
 
-- Issue #16692: Added TLSv1.1 and TLSv1.2 support for the ssl modules.
+- bpo-16692: Added TLSv1.1 and TLSv1.2 support for the ssl modules.
 
-- Issue #16832: add abc.get_cache_token() to expose cache validity checking
+- bpo-16832: add abc.get_cache_token() to expose cache validity checking
   support in ABCMeta.
 
 IDLE
 ----
 
-- Issue #18429: Format / Format Paragraph, now works when comment blocks
-  are selected. As with text blocks, this works best when the selection
-  only includes complete lines.
+- bpo-18429: Format / Format Paragraph, now works when comment blocks are
+  selected. As with text blocks, this works best when the selection only
+  includes complete lines.
 
-- Issue #18226: Add docstrings and unittests for FormatParagraph.py.
-  Original patches by Todd Rovito and Phil Webster.
+- bpo-18226: Add docstrings and unittests for FormatParagraph.py. Original
+  patches by Todd Rovito and Phil Webster.
 
-- Issue #18279: Format - Strip trailing whitespace no longer marks a file as
+- bpo-18279: Format - Strip trailing whitespace no longer marks a file as
   changed when it has not been changed. This fix followed the addition of a
   test file originally written by Phil Webster (the issue's main goal).
 
-- Issue #7136: In the Idle File menu, "New Window" is renamed "New File".
-  Patch by Tal Einat, Roget Serwy, and Todd Rovito.
+- bpo-7136: In the Idle File menu, "New Window" is renamed "New File". Patch
+  by Tal Einat, Roget Serwy, and Todd Rovito.
 
 - Remove dead imports of imp.
 
-- Issue #18196: Avoid displaying spurious SystemExit tracebacks.
+- bpo-18196: Avoid displaying spurious SystemExit tracebacks.
 
-- Issue #5492: Avoid traceback when exiting IDLE caused by a race condition.
+- bpo-5492: Avoid traceback when exiting IDLE caused by a race condition.
 
-- Issue #17511: Keep IDLE find dialog open after clicking "Find Next".
-  Original patch by Sarah K.
+- bpo-17511: Keep IDLE find dialog open after clicking "Find Next". Original
+  patch by Sarah K.
 
-- Issue #18055: Move IDLE off of imp and on to importlib.
+- bpo-18055: Move IDLE off of imp and on to importlib.
 
-- Issue #15392: Create a unittest framework for IDLE.
-  Initial patch by Rajagopalasarma Jayakrishnan.
-  See Lib/idlelib/idle_test/README.txt for how to run Idle tests.
+- bpo-15392: Create a unittest framework for IDLE. Initial patch by
+  Rajagopalasarma Jayakrishnan. See Lib/idlelib/idle_test/README.txt for how
+  to run Idle tests.
 
-- Issue #14146: Highlight source line while debugging on Windows.
+- bpo-14146: Highlight source line while debugging on Windows.
 
-- Issue #17838: Allow sys.stdin to be reassigned.
+- bpo-17838: Allow sys.stdin to be reassigned.
 
-- Issue #13495: Avoid loading the color delegator twice in IDLE.
+- bpo-13495: Avoid loading the color delegator twice in IDLE.
 
-- Issue #17798: Allow IDLE to edit new files when specified on command line.
+- bpo-17798: Allow IDLE to edit new files when specified on command line.
 
-- Issue #14735: Update IDLE docs to omit "Control-z on Windows".
+- bpo-14735: Update IDLE docs to omit "Control-z on Windows".
 
-- Issue #17532: Always include Options menu for IDLE on OS X.
-  Patch by Guilherme Simões.
+- bpo-17532: Always include Options menu for IDLE on OS X. Patch by
+  Guilherme Simões.
 
-- Issue #17585: Fixed IDLE regression. Now closes when using exit() or quit().
+- bpo-17585: Fixed IDLE regression. Now closes when using exit() or quit().
 
-- Issue #17657: Show full Tk version in IDLE's about dialog.
-  Patch by Todd Rovito.
+- bpo-17657: Show full Tk version in IDLE's about dialog. Patch by Todd
+  Rovito.
 
-- Issue #17613: Prevent traceback when removing syntax colorizer in IDLE.
+- bpo-17613: Prevent traceback when removing syntax colorizer in IDLE.
 
-- Issue #1207589: Backwards-compatibility patch for right-click menu in IDLE.
+- bpo-1207589: Backwards-compatibility patch for right-click menu in IDLE.
 
-- Issue #16887: IDLE now accepts Cancel in tabify/untabify dialog box.
+- bpo-16887: IDLE now accepts Cancel in tabify/untabify dialog box.
 
-- Issue #17625: In IDLE, close the replace dialog after it is used.
+- bpo-17625: In IDLE, close the replace dialog after it is used.
 
-- Issue #14254: IDLE now handles readline correctly across shell restarts.
+- bpo-14254: IDLE now handles readline correctly across shell restarts.
 
-- Issue #17614: IDLE no longer raises exception when quickly closing a file.
+- bpo-17614: IDLE no longer raises exception when quickly closing a file.
 
-- Issue #6698: IDLE now opens just an editor window when configured to do so.
+- bpo-6698: IDLE now opens just an editor window when configured to do so.
 
-- Issue #8900: Using keyboard shortcuts in IDLE to open a file no longer
-  raises an exception.
+- bpo-8900: Using keyboard shortcuts in IDLE to open a file no longer raises
+  an exception.
 
-- Issue #6649: Fixed missing exit status in IDLE. Patch by Guilherme Polo.
+- bpo-6649: Fixed missing exit status in IDLE. Patch by Guilherme Polo.
 
-- Issue #17114: IDLE now uses non-strict config parser.
+- bpo-17114: IDLE now uses non-strict config parser.
 
-- Issue #9290: In IDLE the sys.std* streams now implement io.TextIOBase
+- bpo-9290: In IDLE the sys.std* streams now implement io.TextIOBase
   interface and support all mandatory methods and properties.
 
-- Issue #5066: Update IDLE docs. Patch by Todd Rovito.
+- bpo-5066: Update IDLE docs. Patch by Todd Rovito.
 
-- Issue #16829: IDLE printing no longer fails if there are spaces or other
+- bpo-16829: IDLE printing no longer fails if there are spaces or other
   special characters in the file path.
 
-- Issue #16491: IDLE now prints chained exception tracebacks.
+- bpo-16491: IDLE now prints chained exception tracebacks.
 
-- Issue #16819: IDLE method completion now correctly works for bytes literals.
+- bpo-16819: IDLE method completion now correctly works for bytes literals.
 
-- Issue #16504: IDLE now catches SyntaxErrors raised by tokenizer. Patch by
+- bpo-16504: IDLE now catches SyntaxErrors raised by tokenizer. Patch by
   Roger Serwy.
 
-- Issue #16511: Use default IDLE width and height if config param is not valid.
+- bpo-16511: Use default IDLE width and height if config param is not valid.
   Patch Serhiy Storchaka.
 
-- Issue #1207589: Add Cut/Copy/Paste items to IDLE right click Context Menu.
+- bpo-1207589: Add Cut/Copy/Paste items to IDLE right click Context Menu.
   Patch by Todd Rovito.
 
-- Issue #16123: IDLE - deprecate running without a subprocess.
-  Patch by Roger Serwy.
+- bpo-16123: IDLE - deprecate running without a subprocess. Patch by Roger
+  Serwy.
 
 Tests
 -----
 
-- Issue #1666318: Add a test that shutil.copytree() retains directory
+- bpo-1666318: Add a test that shutil.copytree() retains directory
   permissions.  Patch by Catherine Devlin.
 
-- Issue #18273: move the tests in Lib/test/json_tests to Lib/test/test_json
-  and make them discoverable by unittest.  Patch by Zachary Ware.
+- bpo-18273: move the tests in Lib/test/json_tests to Lib/test/test_json and
+  make them discoverable by unittest.  Patch by Zachary Ware.
 
 - Fix a fcntl test case on KFreeBSD, Debian #708653 (Petr Salinger).
 
-- Issue #18396: Fix spurious test failure in test_signal on Windows when
+- bpo-18396: Fix spurious test failure in test_signal on Windows when
   faulthandler is enabled (Patch by Jeremy Kloth)
 
-- Issue #17046: Fix broken test_executable_without_cwd in test_subprocess.
+- bpo-17046: Fix broken test_executable_without_cwd in test_subprocess.
 
-- Issue #15415: Add new temp_dir() and change_cwd() context managers to
-  test.support, and refactor temp_cwd() to use them.  Patch by Chris Jerdonek.
+- bpo-15415: Add new temp_dir() and change_cwd() context managers to
+  test.support, and refactor temp_cwd() to use them.  Patch by Chris
+  Jerdonek.
 
-- Issue #15494: test.support is now a package rather than a module (Initial
+- bpo-15494: test.support is now a package rather than a module (Initial
   patch by Indra Talip)
 
-- Issue #17944: test_zipfile now discoverable and uses subclassing to
-  generate tests for different compression types.  Fixed a bug with skipping
-  some tests due to use of exhausted iterators.
+- bpo-17944: test_zipfile now discoverable and uses subclassing to generate
+  tests for different compression types.  Fixed a bug with skipping some
+  tests due to use of exhausted iterators.
 
-- Issue #18266: test_largefile now works with unittest test discovery and
+- bpo-18266: test_largefile now works with unittest test discovery and
   supports running only selected tests.  Patch by Zachary Ware.
 
-- Issue #17767: test_locale now works with unittest test discovery.
-  Original patch by Zachary Ware.
+- bpo-17767: test_locale now works with unittest test discovery. Original
+  patch by Zachary Ware.
 
-- Issue #18375: Assume --randomize when --randseed is used for running the
+- bpo-18375: Assume --randomize when --randseed is used for running the
   testsuite.
 
-- Issue #11185: Fix test_wait4 under AIX.  Patch by Sébastien Sablé.
+- bpo-11185: Fix test_wait4 under AIX.  Patch by Sébastien Sablé.
 
-- Issue #18207: Fix test_ssl for some versions of OpenSSL that ignore seconds
+- bpo-18207: Fix test_ssl for some versions of OpenSSL that ignore seconds
   in ASN1_TIME fields.
 
-- Issue #18094: test_uuid no longer reports skipped tests as passed.
+- bpo-18094: test_uuid no longer reports skipped tests as passed.
 
-- Issue #17992: Add timeouts to asyncore and asynchat tests so that they won't
+- bpo-17992: Add timeouts to asyncore and asynchat tests so that they won't
   accidentally hang.
 
-- Issue #17833: Fix test_gdb failures seen on machines where debug symbols
-  for glibc are available (seen on PPC64 Linux).
+- bpo-17833: Fix test_gdb failures seen on machines where debug symbols for
+  glibc are available (seen on PPC64 Linux).
 
-- Issue #7855: Add tests for ctypes/winreg for issues found in IronPython.
+- bpo-7855: Add tests for ctypes/winreg for issues found in IronPython.
   Initial patch by Dino Viehland.
 
-- Issue #11078: test___all__ now checks for duplicates in __all__.
-  Initial patch by R. David Murray.
+- bpo-11078: test___all__ now checks for duplicates in __all__. Initial
+  patch by R. David Murray.
 
-- Issue #17712: Fix test_gdb failures on Ubuntu 13.04.
+- bpo-17712: Fix test_gdb failures on Ubuntu 13.04.
 
-- Issue #17835: Fix test_io when the default OS pipe buffer size is larger
-  than one million bytes.
+- bpo-17835: Fix test_io when the default OS pipe buffer size is larger than
+  one million bytes.
 
-- Issue #17065: Use process-unique key for winreg tests to avoid failures if
+- bpo-17065: Use process-unique key for winreg tests to avoid failures if
   test is run multiple times in parallel (eg: on a buildbot host).
 
-- Issue #12820: add tests for the xml.dom.minicompat module.
-  Patch by John Chandler and Phil Connell.
+- bpo-12820: add tests for the xml.dom.minicompat module. Patch by John
+  Chandler and Phil Connell.
 
-- Issue #17691: test_univnewlines now works with unittest test discovery.
-  Patch by Zachary Ware.
+- bpo-17691: test_univnewlines now works with unittest test discovery. Patch
+  by Zachary Ware.
 
-- Issue #17790: test_set now works with unittest test discovery.
-  Patch by Zachary Ware.
+- bpo-17790: test_set now works with unittest test discovery. Patch by
+  Zachary Ware.
 
-- Issue #17789: test_random now works with unittest test discovery.
-  Patch by Zachary Ware.
+- bpo-17789: test_random now works with unittest test discovery. Patch by
+  Zachary Ware.
 
-- Issue #17779: test_osx_env now works with unittest test discovery.
-  Patch by Zachary Ware.
+- bpo-17779: test_osx_env now works with unittest test discovery. Patch by
+  Zachary Ware.
 
-- Issue #17766: test_iterlen now works with unittest test discovery.
-  Patch by Zachary Ware.
+- bpo-17766: test_iterlen now works with unittest test discovery. Patch by
+  Zachary Ware.
 
-- Issue #17690: test_time now works with unittest test discovery.
-  Patch by Zachary Ware.
+- bpo-17690: test_time now works with unittest test discovery. Patch by
+  Zachary Ware.
 
-- Issue #17692: test_sqlite now works with unittest test discovery.
-  Patch by Zachary Ware.
+- bpo-17692: test_sqlite now works with unittest test discovery. Patch by
+  Zachary Ware.
 
-- Issue #11995: test_pydoc doesn't import all sys.path modules anymore.
+- bpo-11995: test_pydoc doesn't import all sys.path modules anymore.
 
-- Issue #17448: test_sax now skips if there are no xml parsers available
+- bpo-17448: test_sax now skips if there are no xml parsers available
   instead of raising an ImportError.
 
-- Issue #11420: make test suite pass with -B/DONTWRITEBYTECODE set.
-  Initial patch by Thomas Wouters.
+- bpo-11420: make test suite pass with -B/DONTWRITEBYTECODE set. Initial
+  patch by Thomas Wouters.
 
-- Issue #10652: make tcl/tk tests run after __all__ test, patch by
-  Zachary Ware.
+- bpo-10652: make tcl/tk tests run after __all__ test, patch by Zachary
+  Ware.
 
-- Issue #11963: remove human verification from test_parser and test_subprocess.
+- bpo-11963: remove human verification from test_parser and test_subprocess.
 
-- Issue #11732: add a new suppress_crash_popup() context manager to test.support
-  that disables crash popups on Windows and use it in test_faulthandler and
-  test_capi.
+- bpo-11732: add a new suppress_crash_popup() context manager to
+  test.support that disables crash popups on Windows and use it in
+  test_faulthandler and test_capi.
 
-- Issue #13898: test_ssl no longer prints a spurious stack trace on Ubuntu.
+- bpo-13898: test_ssl no longer prints a spurious stack trace on Ubuntu.
 
-- Issue #17283: Share code between `__main__.py` and `regrtest.py` in
+- bpo-17283: Share code between `__main__.py` and `regrtest.py` in
   `Lib/test`.
 
-- Issue #17249: convert a test in test_capi to use unittest and reap threads.
+- bpo-17249: convert a test in test_capi to use unittest and reap threads.
 
-- Issue #17107: Test client-side SNI support in urllib.request thanks to
-  the new server-side SNI support in the ssl module.  Initial patch by
-  Daniel Black.
+- bpo-17107: Test client-side SNI support in urllib.request thanks to the
+  new server-side SNI support in the ssl module.  Initial patch by Daniel
+  Black.
 
-- Issue #17041: Fix testing when Python is configured with the
-  --without-doc-strings.
+- bpo-17041: Fix testing when Python is configured with the --without-doc-
+  strings.
 
-- Issue #16923: Fix ResourceWarnings in test_ssl.
+- bpo-16923: Fix ResourceWarnings in test_ssl.
 
-- Issue #15539: Added regression tests for Tools/scripts/pindent.py.
+- bpo-15539: Added regression tests for Tools/scripts/pindent.py.
 
-- Issue #17479: test_io now works with unittest test discovery.
-  Patch by Zachary Ware.
+- bpo-17479: test_io now works with unittest test discovery. Patch by
+  Zachary Ware.
 
-- Issue #17066: test_robotparser now works with unittest test discovery.
-  Patch by Zachary Ware.
+- bpo-17066: test_robotparser now works with unittest test discovery. Patch
+  by Zachary Ware.
 
-- Issue #17334: test_index now works with unittest test discovery.
-  Patch by Zachary Ware.
+- bpo-17334: test_index now works with unittest test discovery. Patch by
+  Zachary Ware.
 
-- Issue #17333: test_imaplib now works with unittest test discovery.
-  Patch by Zachary Ware.
+- bpo-17333: test_imaplib now works with unittest test discovery. Patch by
+  Zachary Ware.
 
-- Issue #17082: test_dbm* now work with unittest test discovery.
-  Patch by Zachary Ware.
+- bpo-17082: test_dbm* now work with unittest test discovery. Patch by
+  Zachary Ware.
 
-- Issue #17079: test_ctypes now works with unittest test discovery.
-  Patch by Zachary Ware.
+- bpo-17079: test_ctypes now works with unittest test discovery. Patch by
+  Zachary Ware.
 
-- Issue #17304: test_hash now works with unittest test discovery.
-  Patch by Zachary Ware.
+- bpo-17304: test_hash now works with unittest test discovery. Patch by
+  Zachary Ware.
 
-- Issue #17303: test_future* now work with unittest test discovery.
-  Patch by Zachary Ware.
+- bpo-17303: test_future* now work with unittest test discovery. Patch by
+  Zachary Ware.
 
-- Issue #17163: test_file now works with unittest test discovery.
-  Patch by Zachary Ware.
+- bpo-17163: test_file now works with unittest test discovery. Patch by
+  Zachary Ware.
 
-- Issue #16925: test_configparser now works with unittest test discovery.
-  Patch by Zachary Ware.
+- bpo-16925: test_configparser now works with unittest test discovery. Patch
+  by Zachary Ware.
 
-- Issue #16918: test_codecs now works with unittest test discovery.
-  Patch by Zachary Ware.
+- bpo-16918: test_codecs now works with unittest test discovery. Patch by
+  Zachary Ware.
 
-- Issue #16919: test_crypt now works with unittest test discovery.
-  Patch by Zachary Ware.
+- bpo-16919: test_crypt now works with unittest test discovery. Patch by
+  Zachary Ware.
 
-- Issue #16910: test_bytes, test_unicode, and test_userstring now work with
+- bpo-16910: test_bytes, test_unicode, and test_userstring now work with
   unittest test discovery.  Patch by Zachary Ware.
 
-- Issue #16905: test_warnings now works with unittest test discovery.
-  Initial patch by Berker Peksag.
+- bpo-16905: test_warnings now works with unittest test discovery. Initial
+  patch by Berker Peksag.
 
-- Issue #16898: test_bufio now works with unittest test discovery.
-  Patch by Zachary Ware.
+- bpo-16898: test_bufio now works with unittest test discovery. Patch by
+  Zachary Ware.
 
-- Issue #16888: test_array now works with unittest test discovery.
-  Patch by Zachary Ware.
+- bpo-16888: test_array now works with unittest test discovery. Patch by
+  Zachary Ware.
 
-- Issue #16896: test_asyncore now works with unittest test discovery.
-  Patch by Zachary Ware.
+- bpo-16896: test_asyncore now works with unittest test discovery. Patch by
+  Zachary Ware.
 
-- Issue #16897: test_bisect now works with unittest test discovery.
-  Initial patch by Zachary Ware.
+- bpo-16897: test_bisect now works with unittest test discovery. Initial
+  patch by Zachary Ware.
 
-- Issue #16852: test_genericpath, test_posixpath, test_ntpath, and test_macpath
+- bpo-16852: test_genericpath, test_posixpath, test_ntpath, and test_macpath
   now work with unittest test discovery.  Patch by Zachary Ware.
 
-- Issue #16748: test_heapq now works with unittest test discovery.
+- bpo-16748: test_heapq now works with unittest test discovery.
 
-- Issue #10646: Tests rearranged for os.samefile/samestat to check for not
-  just symlinks but also hard links.
+- bpo-10646: Tests rearranged for os.samefile/samestat to check for not just
+  symlinks but also hard links.
 
-- Issue #15302: Switch regrtest from using getopt to using argparse.
+- bpo-15302: Switch regrtest from using getopt to using argparse.
 
-- Issue #15324: Fix regrtest parsing of --fromfile, --match, and --randomize
+- bpo-15324: Fix regrtest parsing of --fromfile, --match, and --randomize
   options.
 
-- Issue #16702: test_urllib2_localnet tests now correctly ignores proxies for
+- bpo-16702: test_urllib2_localnet tests now correctly ignores proxies for
   localhost tests.
 
-- Issue #16664: Add regression tests for glob's behaviour concerning entries
+- bpo-16664: Add regression tests for glob's behaviour concerning entries
   starting with a ".".  Patch by Sebastian Kreft.
 
-- Issue #13390: The ``-R`` option to regrtest now also checks for memory
+- bpo-13390: The ``-R`` option to regrtest now also checks for memory
   allocation leaks, using :func:`sys.getallocatedblocks()`.
 
-- Issue #16559: Add more tests for the json module, including some from the
+- bpo-16559: Add more tests for the json module, including some from the
   official test suite at json.org.  Patch by Serhiy Storchaka.
 
-- Issue #16661: Fix the `os.getgrouplist()` test by not assuming that it gives
+- bpo-16661: Fix the `os.getgrouplist()` test by not assuming that it gives
   the same output as :command:`id -G`.
 
-- Issue #16115: Add some tests for the executable argument to
+- bpo-16115: Add some tests for the executable argument to
   subprocess.Popen().  Initial patch by Kushal Das.
 
-- Issue #16126: PyErr_Format format mismatch in _testcapimodule.c.
-  Patch by Serhiy Storchaka.
+- bpo-16126: PyErr_Format format mismatch in _testcapimodule.c. Patch by
+  Serhiy Storchaka.
 
-- Issue #15304: Fix warning message when `os.chdir()` fails inside
+- bpo-15304: Fix warning message when `os.chdir()` fails inside
   `test.support.temp_cwd()`.  Patch by Chris Jerdonek.
 
-- Issue #15802: Fix test logic in `TestMaildir.test_create_tmp()`. Patch by
+- bpo-15802: Fix test logic in `TestMaildir.test_create_tmp()`. Patch by
   Serhiy Storchaka.
 
-- Issue #15557: Added a test suite for the webbrowser module, thanks to Anton
+- bpo-15557: Added a test suite for the webbrowser module, thanks to Anton
   Barkovsky.
 
-- Issue #16698: Skip posix test_getgroups when built with OS X
-  deployment target prior to 10.6.
+- bpo-16698: Skip posix test_getgroups when built with OS X deployment
+  target prior to 10.6.
 
 Build
 -----
 
-- Issue #16067: Add description into MSI file to replace installer's
-  temporary name.
+- bpo-16067: Add description into MSI file to replace installer's temporary
+  name.
 
-- Issue #18257: Fix readlink usage in python-config.  Install the python
+- bpo-18257: Fix readlink usage in python-config.  Install the python
   version again on Darwin.
 
-- Issue #18481: Add C coverage reporting with gcov and lcov. A new make target
-  "coverage-report" creates an instrumented Python build, runs unit tests
+- bpo-18481: Add C coverage reporting with gcov and lcov. A new make target
+  "coverage- report" creates an instrumented Python build, runs unit tests
   and creates a HTML. The report can be updated with "make coverage-lcov".
 
-- Issue #17845: Clarified the message printed when some module are not built.
+- bpo-17845: Clarified the message printed when some module are not built.
 
-- Issue #18256: Compilation fix for recent AIX releases.  Patch by
-  David Edelsohn.
+- bpo-18256: Compilation fix for recent AIX releases.  Patch by David
+  Edelsohn.
 
-- Issue #17547: In configure, explicitly pass -Wformat for the benefit for GCC
+- bpo-17547: In configure, explicitly pass -Wformat for the benefit for GCC
   4.8.
 
-- Issue #15172: Document NASM 2.10+ as requirement for building OpenSSL 1.0.1
+- bpo-15172: Document NASM 2.10+ as requirement for building OpenSSL 1.0.1
   on Windows.
 
-- Issue #17591: Use lowercase filenames when including Windows header files.
+- bpo-17591: Use lowercase filenames when including Windows header files.
   Patch by Roumen Petrov.
 
-- Issue #17550: Fix the --enable-profiling configure switch.
+- bpo-17550: Fix the --enable-profiling configure switch.
 
-- Issue #17425: Build with openssl 1.0.1d on Windows.
+- bpo-17425: Build with openssl 1.0.1d on Windows.
 
-- Issue #16754: Fix the incorrect shared library extension on linux. Introduce
+- bpo-16754: Fix the incorrect shared library extension on linux. Introduce
   two makefile macros SHLIB_SUFFIX and EXT_SUFFIX. SO now has the value of
   SHLIB_SUFFIX again (as in 2.x and 3.1). The SO macro is removed in 3.4.
 
-- Issue #5033: Fix building of the sqlite3 extension module when the
-  SQLite library version has "beta" in it. Patch by Andreas Pelme.
+- bpo-5033: Fix building of the sqlite3 extension module when the SQLite
+  library version has "beta" in it. Patch by Andreas Pelme.
 
-- Issue #17228: Fix building without pymalloc.
+- bpo-17228: Fix building without pymalloc.
 
-- Issue #3718: Use AC_ARG_VAR to set MACHDEP in configure.ac.
+- bpo-3718: Use AC_ARG_VAR to set MACHDEP in configure.ac.
 
-- Issue #16235: Implement python-config as a shell script.
+- bpo-16235: Implement python-config as a shell script.
 
-- Issue #16769: Remove outdated Visual Studio projects.
+- bpo-16769: Remove outdated Visual Studio projects.
 
-- Issue #17031: Fix running regen in cross builds.
+- bpo-17031: Fix running regen in cross builds.
 
-- Issue #3754: fix typo in pthread AC_CACHE_VAL.
+- bpo-3754: fix typo in pthread AC_CACHE_VAL.
 
-- Issue #15484: Fix _PYTHON_PROJECT_BASE for srcdir != builddir builds;
-  use _PYTHON_PROJECT_BASE in distutils/sysconfig.py.
+- bpo-15484: Fix _PYTHON_PROJECT_BASE for srcdir != builddir builds; use
+  _PYTHON_PROJECT_BASE in distutils/sysconfig.py.
 
 - Drop support for Windows 2000 (changeset e52df05b496a).
 
-- Issue #17029: Let h2py search the multiarch system include directory.
+- bpo-17029: Let h2py search the multiarch system include directory.
 
-- Issue #16953: Fix socket module compilation on platforms with
+- bpo-16953: Fix socket module compilation on platforms with
   HAVE_BROKEN_POLL. Patch by Jeffrey Armstrong.
 
-- Issue #16320: Remove redundant Makefile dependencies for strings and bytes.
+- bpo-16320: Remove redundant Makefile dependencies for strings and bytes.
 
-- Cross compiling needs host and build settings. configure no longer
-  creates a broken PYTHON_FOR_BUILD variable when --build is missing.
+- Cross compiling needs host and build settings. configure no longer creates
+  a broken PYTHON_FOR_BUILD variable when --build is missing.
 
-- Fix cross compiling issue in setup.py, ensure that lib_dirs and inc_dirs are
-  defined in cross compiling mode, too.
+- Fix cross compiling issue in setup.py, ensure that lib_dirs and inc_dirs
+  are defined in cross compiling mode, too.
 
-- Issue #16836: Enable IPv6 support even if IPv6 is disabled on the build host.
+- bpo-16836: Enable IPv6 support even if IPv6 is disabled on the build host.
 
-- Issue #16593: Have BSD 'make -s' do the right thing, thanks to Daniel Shahaf
+- bpo-16593: Have BSD 'make -s' do the right thing, thanks to Daniel Shahaf
 
-- Issue #16262: fix out-of-src-tree builds, if mercurial is not installed.
+- bpo-16262: fix out-of-src-tree builds, if mercurial is not installed.
 
-- Issue #15298: ensure _sysconfigdata is generated in build directory, not
+- bpo-15298: ensure _sysconfigdata is generated in build directory, not
   source directory.
 
-- Issue #15833: Fix a regression in 3.3 that resulted in exceptions being
+- bpo-15833: Fix a regression in 3.3 that resulted in exceptions being
   raised if importlib failed to write byte-compiled files.  This affected
   attempts to build Python out-of-tree from a read-only source directory.
 
-- Issue #15923: Fix a mistake in ``asdl_c.py`` that resulted in a TypeError
+- bpo-15923: Fix a mistake in ``asdl_c.py`` that resulted in a TypeError
   after 2801bf875a24 (see #15801).
 
-- Issue #16135: Remove OS/2 support.
+- bpo-16135: Remove OS/2 support.
 
-- Issue #15819: Make sure we can build Python out-of-tree from a read-only
-  source directory.  (Somewhat related to issue #9860.)
+- bpo-15819: Make sure we can build Python out-of-tree from a read-only
+  source directory. (Somewhat related to issue #9860.)
 
-- Issue #15587: Enable Tk high-resolution text rendering on Macs with
-  Retina displays.  Applies to Tkinter apps, such as IDLE, on OS X
-  framework builds linked with Cocoa Tk 8.5.
+- bpo-15587: Enable Tk high-resolution text rendering on Macs with Retina
+  displays. Applies to Tkinter apps, such as IDLE, on OS X framework builds
+  linked with Cocoa Tk 8.5.
 
-- Issue #17161: make install now also installs a python3 man page.
+- bpo-17161: make install now also installs a python3 man page.
 
-C-API
+C API
 -----
 
-- Issue #18351: Fix various issues in a function in importlib provided to help
+- bpo-18351: Fix various issues in a function in importlib provided to help
   PyImport_ExecCodeModuleWithPathnames() (and thus by extension
   PyImport_ExecCodeModule() and PyImport_ExecCodeModuleEx()).
 
-- Issue #9369: The types of `char*` arguments of PyObject_CallFunction() and
+- bpo-9369: The types of `char*` arguments of PyObject_CallFunction() and
   PyObject_CallMethod() now changed to `const char*`.  Based on patches by
   Jörg Müller and Lars Buitinck.
 
-- Issue #17206: Py_CLEAR(), Py_DECREF(), Py_XINCREF() and Py_XDECREF() now
-  expand their arguments once instead of multiple times.  Patch written by Illia
-  Polosukhin.
+- bpo-17206: Py_CLEAR(), Py_DECREF(), Py_XINCREF() and Py_XDECREF() now
+  expand their arguments once instead of multiple times.  Patch written by
+  Illia Polosukhin.
 
-- Issue #17522: Add the PyGILState_Check() API.
+- bpo-17522: Add the PyGILState_Check() API.
 
-- Issue #17327: Add PyDict_SetDefault.
+- bpo-17327: Add PyDict_SetDefault.
 
-- Issue #16881: Fix Py_ARRAY_LENGTH macro for GCC < 3.1.
+- bpo-16881: Fix Py_ARRAY_LENGTH macro for GCC < 3.1.
 
-- Issue #16505: Remove unused Py_TPFLAGS_INT_SUBCLASS.
+- bpo-16505: Remove unused Py_TPFLAGS_INT_SUBCLASS.
 
-- Issue #16086: PyTypeObject.tp_flags and PyType_Spec.flags are now unsigned
+- bpo-16086: PyTypeObject.tp_flags and PyType_Spec.flags are now unsigned
   (unsigned long and unsigned int) to avoid an undefined behaviour with
-  Py_TPFLAGS_TYPE_SUBCLASS ((1 << 31). PyType_GetFlags() result type is
-  now unsigned too (unsigned long, instead of long).
+  Py_TPFLAGS_TYPE_SUBCLASS ((1 << 31). PyType_GetFlags() result type is now
+  unsigned too (unsigned long, instead of long).
 
-- Issue #16166: Add PY_LITTLE_ENDIAN and PY_BIG_ENDIAN macros and unified
+- bpo-16166: Add PY_LITTLE_ENDIAN and PY_BIG_ENDIAN macros and unified
   endianness detection and handling.
 
 Documentation
 -------------
 
-- Issue #17701: Improving strftime documentation.
+- bpo-17701: Improving strftime documentation.
 
-- Issue #18440: Clarify that `hash()` can truncate the value returned from an
+- bpo-18440: Clarify that `hash()` can truncate the value returned from an
   object's custom `__hash__()` method.
 
-- Issue #17844: Add links to encoders and decoders for bytes-to-bytes codecs.
+- bpo-17844: Add links to encoders and decoders for bytes-to-bytes codecs.
 
-- Issue #14097: improve the "introduction" page of the tutorial.
+- bpo-14097: improve the "introduction" page of the tutorial.
 
-- Issue #17977: The documentation for the cadefault argument's default value
-  in urllib.request.urlopen() is fixed to match the code.
+- bpo-17977: The documentation for the cadefault argument's default value in
+  urllib.request.urlopen() is fixed to match the code.
 
-- Issue #6696: add documentation for the Profile objects, and improve
+- bpo-6696: add documentation for the Profile objects, and improve
   profile/cProfile docs.  Patch by Tom Pinckney.
 
-- Issue #15940: Specify effect of locale on time functions.
+- bpo-15940: Specify effect of locale on time functions.
 
-- Issue #17538: Document XML vulnerabilties
+- bpo-17538: Document XML vulnerabilties
 
-- Issue #16642: sched.scheduler timefunc initial default is time.monotonic.
+- bpo-16642: sched.scheduler timefunc initial default is time.monotonic.
   Patch by Ramchandra Apte
 
-- Issue #17047: remove doubled words in docs and docstrings
-  reported by Serhiy Storchaka and Matthew Barnett.
+- bpo-17047: remove doubled words in docs and docstrings reported by Serhiy
+  Storchaka and Matthew Barnett.
 
-- Issue #15465: Document the versioning macros in the C API docs rather than
+- bpo-15465: Document the versioning macros in the C API docs rather than
   the standard library docs. Patch by Kushal Das.
 
-- Issue #16406: Combine the pages for uploading and registering to PyPI.
+- bpo-16406: Combine the pages for uploading and registering to PyPI.
 
-- Issue #16403: Document how distutils uses the maintainer field in
-  PKG-INFO. Patch by Jyrki Pulliainen.
+- bpo-16403: Document how distutils uses the maintainer field in PKG-INFO.
+  Patch by Jyrki Pulliainen.
 
-- Issue #16695: Document how glob handles filenames starting with a
-  dot. Initial patch by Jyrki Pulliainen.
+- bpo-16695: Document how glob handles filenames starting with a dot.
+  Initial patch by Jyrki Pulliainen.
 
-- Issue #8890: Stop advertising an insecure practice by replacing uses
-  of the /tmp directory with better alternatives in the documentation.
-  Patch by Geoff Wilson.
+- bpo-8890: Stop advertising an insecure practice by replacing uses of the
+  /tmp directory with better alternatives in the documentation. Patch by
+  Geoff Wilson.
 
-- Issue #17203: add long option names to unittest discovery docs.
+- bpo-17203: add long option names to unittest discovery docs.
 
-- Issue #13094: add "Why do lambdas defined in a loop with different values
-  all return the same result?" programming FAQ.
+- bpo-13094: add "Why do lambdas defined in a loop with different values all
+  return the same result?" programming FAQ.
 
-- Issue #14901: Update portions of the Windows FAQ.
-  Patch by Ashish Nitin Patil.
+- bpo-14901: Update portions of the Windows FAQ. Patch by Ashish Nitin
+  Patil.
 
-- Issue #16267: Better document the 3.3+ approach to combining
-  @abstractmethod with @staticmethod, @classmethod and @property
+- bpo-16267: Better document the 3.3+ approach to combining @abstractmethod
+  with @staticmethod, @classmethod and @property
 
-- Issue #15209: Clarify exception chaining description in exceptions module
+- bpo-15209: Clarify exception chaining description in exceptions module
   documentation
 
-- Issue #15990: Improve argument/parameter documentation.
+- bpo-15990: Improve argument/parameter documentation.
 
-- Issue #16209: Move the documentation for the str built-in function to a new
+- bpo-16209: Move the documentation for the str built-in function to a new
   str class entry in the "Text Sequence Type" section.
 
-- Issue #13538: Improve str() and object.__str__() documentation.
+- bpo-13538: Improve str() and object.__str__() documentation.
 
-- Issue #16489: Make it clearer that importlib.find_loader() needs parent
+- bpo-16489: Make it clearer that importlib.find_loader() needs parent
   packages to be explicitly imported.
 
-- Issue #16400: Update the description of which versions of a given package
+- bpo-16400: Update the description of which versions of a given package
   PyPI displays.
 
-- Issue #15677: Document that zlib and gzip accept a compression level of 0 to
+- bpo-15677: Document that zlib and gzip accept a compression level of 0 to
   mean 'no compression'. Patch by Brian Brazil.
 
-- Issue #16197: Update winreg docstrings and documentation to match code.
-  Patch by Zachary Ware.
+- bpo-16197: Update winreg docstrings and documentation to match code. Patch
+  by Zachary Ware.
 
-- Issue #8040: added a version switcher to the documentation.  Patch by
-  Yury Selivanov.
+- bpo-8040: added a version switcher to the documentation.  Patch by Yury
+  Selivanov.
 
-- Issue #16241: Document -X faulthandler command line option.
-  Patch by Marek Šuppa.
+- bpo-16241: Document -X faulthandler command line option. Patch by Marek
+  Šuppa.
 
 - Additional comments and some style changes in the concurrent.futures URL
   retrieval example
 
-- Issue #16115: Improve subprocess.Popen() documentation around args, shell,
+- bpo-16115: Improve subprocess.Popen() documentation around args, shell,
   and executable arguments.
 
-- Issue #13498: Clarify docs of os.makedirs()'s exist_ok argument.  Done with
-  great native-speaker help from R. David Murray.
+- bpo-13498: Clarify docs of os.makedirs()'s exist_ok argument.  Done with
+  great native- speaker help from R. David Murray.
 
-- Issue #15533: Clarify docs and add tests for `subprocess.Popen()`'s cwd
+- bpo-15533: Clarify docs and add tests for `subprocess.Popen()`'s cwd
   argument.
 
-- Issue #15979: Improve timeit documentation.
+- bpo-15979: Improve timeit documentation.
 
-- Issue #16036: Improve documentation of built-in `int()`'s signature and
+- bpo-16036: Improve documentation of built-in `int()`'s signature and
   arguments.
 
-- Issue #15935: Clarification of `argparse` docs, re: add_argument() type and
+- bpo-15935: Clarification of `argparse` docs, re: add_argument() type and
   default arguments.  Patch contributed by Chris Jerdonek.
 
-- Issue #11964: Document a change in v3.2 to the behavior of the indent
+- bpo-11964: Document a change in v3.2 to the behavior of the indent
   parameter of json encoding operations.
 
-- Issue #15116: Remove references to appscript as it is no longer being
+- bpo-15116: Remove references to appscript as it is no longer being
   supported.
 
 Tools/Demos
 -----------
 
-- Issue #18817: Fix a resource warning in Lib/aifc.py demo.  Patch by
-  Vajrasky Kok.
+- bpo-18817: Fix a resource warning in Lib/aifc.py demo.  Patch by Vajrasky
+  Kok.
 
-- Issue #18439: Make patchcheck work on Windows for ACKS, NEWS.
+- bpo-18439: Make patchcheck work on Windows for ACKS, NEWS.
 
-- Issue #18448: Fix a typo in Tools/demo/eiffel.py.
+- bpo-18448: Fix a typo in Tools/demo/eiffel.py.
 
-- Issue #18457: Fixed saving of formulas and complex numbers in
+- bpo-18457: Fixed saving of formulas and complex numbers in
   Tools/demo/ss1.py.
 
-- Issue #18449: Make Tools/demo/ss1.py work again on Python 3.  Patch by
-  Févry Thibault.
+- bpo-18449: Make Tools/demo/ss1.py work again on Python 3.  Patch by Févry
+  Thibault.
 
-- Issue #12990: The "Python Launcher" on OSX could not launch python scripts
+- bpo-12990: The "Python Launcher" on OSX could not launch python scripts
   that have paths that include wide characters.
 
-- Issue #15239: Make mkstringprep.py work again on Python 3.
+- bpo-15239: Make mkstringprep.py work again on Python 3.
 
-- Issue #17028: Allowed Python arguments to be supplied to the Windows
+- bpo-17028: Allowed Python arguments to be supplied to the Windows
   launcher.
 
-- Issue #17156: pygettext.py now detects the encoding of source files and
+- bpo-17156: pygettext.py now detects the encoding of source files and
   correctly writes and escapes non-ascii characters.
 
-- Issue #15539: Fix a number of bugs in Tools/scripts/pindent.py.  Now
+- bpo-15539: Fix a number of bugs in Tools/scripts/pindent.py.  Now
   pindent.py works with a "with" statement.  pindent.py no longer produces
-  improper indentation.  pindent.py now works with continued lines broken after
-  "class" or "def" keywords and with continuations at the start of line.
+  improper indentation. pindent.py now works with continued lines broken
+  after "class" or "def" keywords and with continuations at the start of
+  line.
 
-- Issue #11797: Add a 2to3 fixer that maps reload() to imp.reload().
+- bpo-11797: Add a 2to3 fixer that maps reload() to imp.reload().
 
-- Issue #10966: Remove the concept of unexpected skipped tests.
+- bpo-10966: Remove the concept of unexpected skipped tests.
 
-- Issue #9893: Removed the Misc/Vim directory.
+- bpo-9893: Removed the Misc/Vim directory.
 
 - Removed the Misc/TextMate directory.
 
-- Issue #16245: Add the Tools/scripts/parse_html5_entities.py script to parse
+- bpo-16245: Add the Tools/scripts/parse_html5_entities.py script to parse
   the list of HTML5 entities and update the html.entities.html5 dictionary.
 
-- Issue #15378: Fix Tools/unicode/comparecodecs.py.  Patch by Serhiy Storchaka.
+- bpo-15378: Fix Tools/unicode/comparecodecs.py.  Patch by Serhiy Storchaka.
 
-- Issue #16549: Make json.tool work again on Python 3 and add tests.
-  Initial patch by Berker Peksag and Serhiy Storchaka.
+- bpo-16549: Make json.tool work again on Python 3 and add tests. Initial
+  patch by Berker Peksag and Serhiy Storchaka.
 
-- Issue #13301: use ast.literal_eval() instead of eval() in Tools/i18n/msgfmt.py.
-  Patch by Serhiy Storchaka.
+- bpo-13301: use ast.literal_eval() instead of eval() in
+  Tools/i18n/msgfmt.py. Patch by Serhiy Storchaka.
 
 Windows
 -------
 
-- Issue #18569: The installer now adds .py to the PATHEXT variable when extensions
-  are registered. Patch by Paul Moore.
+- bpo-18569: The installer now adds .py to the PATHEXT variable when
+  extensions are registered. Patch by Paul Moore.
 
 
-What's New in Python 3.3.0?
-===========================
+What's New in Python 3.3.0 final?
+=================================
 
 *Release date: 29-Sep-2012*
 
 Core and Builtins
 -----------------
 
-- Issue #16046: Fix loading sourceless legacy .pyo files.
+- bpo-16046: Fix loading sourceless legacy .pyo files.
 
-- Issue #16060: Fix refcounting bug when `__trunc__()` returns an object whose
+- bpo-16060: Fix refcounting bug when `__trunc__()` returns an object whose
   `__int__()` gives a non-integer.  Patch by Serhiy Storchaka.
 
-Extension Modules
------------------
+Library
+-------
 
-- Issue #16012: Fix a regression in pyexpat. The parser's `UseForeignDTD()`
+- bpo-16012: Fix a regression in pyexpat. The parser's `UseForeignDTD()`
   method doesn't require an argument again.
 
 
-What's New in Python 3.3.0 Release Candidate 3?
+What's New in Python 3.3.0 release candidate 3?
 ===============================================
 
 *Release date: 23-Sep-2012*
@@ -6498,45 +6608,43 @@ What's New in Python 3.3.0 Release Candidate 3?
 Core and Builtins
 -----------------
 
-- Issue #15900: Fix reference leak in `PyUnicode_TranslateCharmap()`.
+- bpo-15900: Fix reference leak in `PyUnicode_TranslateCharmap()`.
 
-- Issue #15926: Fix crash after multiple reinitializations of the interpreter.
+- bpo-15926: Fix crash after multiple reinitializations of the interpreter.
 
-- Issue #15895: Fix FILE pointer leak in one error branch of
-  `PyRun_SimpleFileExFlags()` when filename points to a pyc/pyo file, closeit is
-  false an and set_main_loader() fails.
+- bpo-15895: Fix FILE pointer leak in one error branch of
+  `PyRun_SimpleFileExFlags()` when filename points to a pyc/pyo file,
+  closeit is false an and set_main_loader() fails.
 
 - Fixes for a few crash and memory leak regressions found by Coverity.
 
 Library
 -------
 
-- Issue #15882: Change `_decimal` to accept any coefficient tuple when
+- bpo-15882: Change `_decimal` to accept any coefficient tuple when
   constructing infinities. This is done for backwards compatibility with
   decimal.py: Infinity coefficients are undefined in _decimal (in accordance
   with the specification).
 
-- Issue #15925: Fix a regression in `email.util` where the `parsedate()` and
-  `parsedate_tz()` functions did not return None anymore when the argument could
-  not be parsed.
+- bpo-15925: Fix a regression in `email.util` where the `parsedate()` and
+  `parsedate_tz()` functions did not return None anymore when the argument
+  could not be parsed.
 
-Extension Modules
------------------
-
-- Issue #15973: Fix a segmentation fault when comparing datetime timezone
+- bpo-15973: Fix a segmentation fault when comparing datetime timezone
   objects.
 
-- Issue #15977: Fix memory leak in Modules/_ssl.c when the function
-  _set_npn_protocols() is called multiple times, thanks to Daniel Sommermann.
+- bpo-15977: Fix memory leak in Modules/_ssl.c when the function
+  _set_npn_protocols() is called multiple times, thanks to Daniel
+  Sommermann.
 
-- Issue #15969: `faulthandler` module: rename dump_tracebacks_later() to
+- bpo-15969: `faulthandler` module: rename dump_tracebacks_later() to
   dump_traceback_later() and cancel_dump_tracebacks_later() to
   cancel_dump_traceback_later().
 
 - _decimal module: use only C 89 style comments.
 
 
-What's New in Python 3.3.0 Release Candidate 2?
+What's New in Python 3.3.0 release candidate 2?
 ===============================================
 
 *Release date: 09-Sep-2012*
@@ -6544,60 +6652,61 @@ What's New in Python 3.3.0 Release Candidate 2?
 Core and Builtins
 -----------------
 
-- Issue #13992: The trashcan mechanism is now thread-safe.  This eliminates
-  sporadic crashes in multi-thread programs when several long deallocator chains
-  ran concurrently and involved subclasses of built-in container types.
+- bpo-13992: The trashcan mechanism is now thread-safe.  This eliminates
+  sporadic crashes in multi-thread programs when several long deallocator
+  chains ran concurrently and involved subclasses of built-in container
+  types.
 
-- Issue #15784: Modify `OSError`.__str__() to better distinguish between errno
+- bpo-15784: Modify `OSError`.__str__() to better distinguish between errno
   error numbers and Windows error numbers.
 
-- Issue #15781: Fix two small race conditions in import's module locking.
+- bpo-15781: Fix two small race conditions in import's module locking.
 
 Library
 -------
 
-- Issue #17158: Add 'symbols' to help() welcome message; clarify
-  'modules spam' messages.
+- bpo-17158: Add 'symbols' to help() welcome message; clarify 'modules spam'
+  messages.
 
-- Issue #15847: Fix a regression in argparse, which did not accept tuples as
+- bpo-15847: Fix a regression in argparse, which did not accept tuples as
   argument lists anymore.
 
-- Issue #15828: Restore support for C extensions in `imp.load_module()`.
+- bpo-15828: Restore support for C extensions in `imp.load_module()`.
 
-- Issue #15340: Fix importing the random module when ``/dev/urandom`` cannot be
-  opened.  This was a regression caused by the hash randomization patch.
+- bpo-15340: Fix importing the random module when ``/dev/urandom`` cannot be
+  opened. This was a regression caused by the hash randomization patch.
 
-- Issue #10650: Deprecate the watchexp parameter of the `Decimal.quantize()`
+- bpo-10650: Deprecate the watchexp parameter of the `Decimal.quantize()`
   method.
 
-- Issue #15785: Modify `window.get_wch()` API of the curses module: return a
-  character for most keys, and an integer for special keys, instead of always
-  returning an integer. So it is now possible to distinguish special keys like
-  keypad keys.
+- bpo-15785: Modify `window.get_wch()` API of the curses module: return a
+  character for most keys, and an integer for special keys, instead of
+  always returning an integer. So it is now possible to distinguish special
+  keys like keypad keys.
 
-- Issue #14223: Fix `window.addch()` of the curses module for special characters
-  like curses.ACS_HLINE: the Python function addch(int) and addch(bytes) is now
-  calling the C function waddch()/mvwaddch() (as it was done in Python 3.2),
-  instead of wadd_wch()/mvwadd_wch(). The Python function addch(str) is still
-  calling the C function wadd_wch()/mvwadd_wch() if the Python curses is linked
-  to libncursesw.
+- bpo-14223: Fix `window.addch()` of the curses module for special
+  characters like curses.ACS_HLINE: the Python function addch(int) and
+  addch(bytes) is now calling the C function waddch()/mvwaddch() (as it was
+  done in Python 3.2), instead of wadd_wch()/mvwadd_wch(). The Python
+  function addch(str) is still calling the C function
+  wadd_wch()/mvwadd_wch() if the Python curses is linked to libncursesw.
 
 Build
 -----
 
-- Issue #15822: Really ensure 2to3 grammar pickles are properly installed
+- bpo-15822: Really ensure 2to3 grammar pickles are properly installed
   (replaces fixes for Issue #15645).
 
 Documentation
 -------------
 
-- Issue #15814: The memoryview enhancements in 3.3.0 accidentally permitted the
-  hashing of multi-dimensional memorviews and memoryviews with multi-byte item
-  formats. The intended restrictions have now been documented - they will be
-  correctly enforced in 3.3.1.
+- bpo-15814: The memoryview enhancements in 3.3.0 accidentally permitted the
+  hashing of multi-dimensional memorviews and memoryviews with multi-byte
+  item formats. The intended restrictions have now been documented - they
+  will be correctly enforced in 3.3.1.
 
 
-What's New in Python 3.3.0 Release Candidate 1?
+What's New in Python 3.3.0 release candidate 1?
 ===============================================
 
 *Release date: 25-Aug-2012*
@@ -6605,83 +6714,84 @@ What's New in Python 3.3.0 Release Candidate 1?
 Core and Builtins
 -----------------
 
-- Issue #15573: memoryview comparisons are now performed by value with full
+- bpo-15573: memoryview comparisons are now performed by value with full
   support for any valid struct module format definition.
 
-- Issue #15316: When an item in the fromlist for `__import__()` doesn't exist,
-  don't raise an error, but if an exception is raised as part of an import do
-  let that propagate.
+- bpo-15316: When an item in the fromlist for `__import__()` doesn't exist,
+  don't raise an error, but if an exception is raised as part of an import
+  do let that propagate.
 
-- Issue #15778: Ensure that ``str(ImportError(msg))`` returns a str even when
+- bpo-15778: Ensure that ``str(ImportError(msg))`` returns a str even when
   msg isn't a str.
 
-- Issue #2051: Source file permission bits are once again correctly copied to
+- bpo-2051: Source file permission bits are once again correctly copied to
   the cached bytecode file. (The migration to importlib reintroduced this
-  problem because these was no regression test. A test has been added as part of
-  this patch)
+  problem because these was no regression test. A test has been added as
+  part of this patch)
 
-- Issue #15761: Fix crash when ``PYTHONEXECUTABLE`` is set on Mac OS X.
+- bpo-15761: Fix crash when ``PYTHONEXECUTABLE`` is set on Mac OS X.
 
-- Issue #15726: Fix incorrect bounds checking in PyState_FindModule.  Patch by
+- bpo-15726: Fix incorrect bounds checking in PyState_FindModule.  Patch by
   Robin Schreiber.
 
-- Issue #15604: Update uses of `PyObject_IsTrue()` to check for and handle
-  errors correctly.  Patch by Serhiy Storchaka.
+- bpo-15604: Update uses of `PyObject_IsTrue()` to check for and handle
+  errors correctly. Patch by Serhiy Storchaka.
 
-- Issue #14846: `importlib.FileFinder` now handles the case where the directory
+- bpo-14846: `importlib.FileFinder` now handles the case where the directory
   being searched is removed after a previous import attempt.
 
 Library
 -------
 
-- Issue #13370: Ensure that ctypes works on Mac OS X when Python is compiled
+- bpo-13370: Ensure that ctypes works on Mac OS X when Python is compiled
   using the clang compiler.
 
-- Issue #13072: The array module's 'u' format code is now deprecated and will be
-  removed in Python 4.0.
+- bpo-13072: The array module's 'u' format code is now deprecated and will
+  be removed in Python 4.0.
 
-- Issue #15544: Fix Decimal.__float__ to work with payload-carrying NaNs.
+- bpo-15544: Fix Decimal.__float__ to work with payload-carrying NaNs.
 
-- Issue #15776: Allow pyvenv to work in existing directory with --clean.
+- bpo-15776: Allow pyvenv to work in existing directory with --clean.
 
-- Issue #15249: email's BytesGenerator now correctly mangles From lines (when
+- bpo-15249: email's BytesGenerator now correctly mangles From lines (when
   requested) even if the body contains undecodable bytes.
 
-- Issue #15777: Fix a refleak in _posixsubprocess.
+- bpo-15777: Fix a refleak in _posixsubprocess.
 
-- Issue ##665194: Update `email.utils.localtime` to use datetime.astimezone and
+- bpo-665194: Update `email.utils.localtime` to use datetime.astimezone and
   correctly handle historic changes in UTC offsets.
 
-- Issue #15199: Fix JavaScript's default MIME type to application/javascript.
+- bpo-15199: Fix JavaScript's default MIME type to application/javascript.
   Patch by Bohuslav Kabrda.
 
-- Issue #12643: `code.InteractiveConsole` now respects `sys.excepthook` when
+- bpo-12643: `code.InteractiveConsole` now respects `sys.excepthook` when
   displaying exceptions.  Patch by Aaron Iles.
 
-- Issue #13579: `string.Formatter` now understands the 'a' conversion specifier.
+- bpo-13579: `string.Formatter` now understands the 'a' conversion
+  specifier.
 
-- Issue #15595: Fix ``subprocess.Popen(universal_newlines=True)`` for certain
+- bpo-15595: Fix ``subprocess.Popen(universal_newlines=True)`` for certain
   locales (utf-16 and utf-32 family). Patch by Chris Jerdonek.
 
-- Issue #15477: In cmath and math modules, add workaround for platforms whose
-  system-supplied log1p function doesn't respect signs of zeros.
+- bpo-15477: In cmath and math modules, add workaround for platforms whose
+  system- supplied log1p function doesn't respect signs of zeros.
 
-- Issue #15715: `importlib.__import__()` will silence an ImportError when the
+- bpo-15715: `importlib.__import__()` will silence an ImportError when the
   use of fromlist leads to a failed import.
 
-- Issue #14669: Fix pickling of connections and sockets on Mac OS X by
+- bpo-14669: Fix pickling of connections and sockets on Mac OS X by
   sending/receiving an acknowledgment after file descriptor transfer.
   TestPicklingConnection has been reenabled for Mac OS X.
 
-- Issue #11062: Fix adding a message from file to Babyl mailbox.
+- bpo-11062: Fix adding a message from file to Babyl mailbox.
 
-- Issue #15646: Prevent equivalent of a fork bomb when using `multiprocessing`
+- bpo-15646: Prevent equivalent of a fork bomb when using `multiprocessing`
   on Windows without the ``if __name__ == '__main__'`` idiom.
 
 IDLE
 ----
 
-- Issue #15678: Fix IDLE menus when started from OS X command line (3.3.0b2
+- bpo-15678: Fix IDLE menus when started from OS X command line (3.3.0b2
   regression).
 
 Documentation
@@ -6689,42 +6799,44 @@ Documentation
 
 - Touched up the Python 2 to 3 porting guide.
 
-- Issue #14674: Add a discussion of the `json` module's standard compliance.
+- bpo-14674: Add a discussion of the `json` module's standard compliance.
   Patch by Chris Rebert.
 
 - Create a 'Concurrent Execution' section in the docs, and split up the
   'Optional Operating System Services' section to use a more user-centric
-  classification scheme (splitting them across the new CE section, IPC and text
-  processing). Operating system limitations can be reflected with the Sphinx
-  ``:platform:`` tag, it doesn't make sense as part of the Table of Contents.
+  classification scheme (splitting them across the new CE section, IPC and
+  text processing). Operating system limitations can be reflected with the
+  Sphinx ``:platform:`` tag, it doesn't make sense as part of the Table of
+  Contents.
 
-- Issue #4966: Bring the sequence docs up to date for the Py3k transition and
+- bpo-4966: Bring the sequence docs up to date for the Py3k transition and
   the many language enhancements since they were original written.
 
-- The "path importer" misnomer has been replaced with Eric Snow's
-  more-awkward-but-at-least-not-wrong suggestion of "path based finder" in the
+- The "path importer" misnomer has been replaced with Eric Snow's more-
+  awkward-but-at-least-not-wrong suggestion of "path based finder" in the
   import system reference docs.
 
-- Issue #15640: Document `importlib.abc.Finder` as deprecated.
+- bpo-15640: Document `importlib.abc.Finder` as deprecated.
 
-- Issue #15630: Add an example for "continue" stmt in the tutorial.  Patch by
+- bpo-15630: Add an example for "continue" stmt in the tutorial.  Patch by
   Daniel Ellis.
 
 Tests
 -----
 
-- Issue #15747: ZFS always returns EOPNOTSUPP when attempting to set the
-  UF_IMMUTABLE flag (via either chflags or lchflags); refactor affected tests in
-  test_posix.py to account for this.
+- bpo-15747: ZFS always returns EOPNOTSUPP when attempting to set the
+  UF_IMMUTABLE flag (via either chflags or lchflags); refactor affected
+  tests in test_posix.py to account for this.
 
-- Issue #15285: Refactor the approach for testing connect timeouts using two
-  external hosts that have been configured specifically for this type of test.
+- bpo-15285: Refactor the approach for testing connect timeouts using two
+  external hosts that have been configured specifically for this type of
+  test.
 
-- Issue #15743: Remove the deprecated method usage in `urllib` tests. Patch by
+- bpo-15743: Remove the deprecated method usage in `urllib` tests. Patch by
   Jeff Knupp.
 
-- Issue #15615: Add some tests for the `json` module's handling of invalid input
-  data.  Patch by Kushal Das.
+- bpo-15615: Add some tests for the `json` module's handling of invalid
+  input data. Patch by Kushal Das.
 
 Build
 -----
@@ -6736,15 +6848,15 @@ Build
 - Drop ``PC\python_nt.h`` as it's not used.  Add input dependency on custom
   build step.
 
-- Issue #15511: Drop explicit dependency on pythonxy.lib from _decimal amd64
+- bpo-15511: Drop explicit dependency on pythonxy.lib from _decimal amd64
   configuration.
 
 - Add missing PGI/PGO configurations for pywlauncher.
 
-- Issue #15645: Ensure 2to3 grammar pickles are properly installed.
+- bpo-15645: Ensure 2to3 grammar pickles are properly installed.
 
 
-What's New in Python 3.3.0 Beta 2?
+What's New in Python 3.3.0 beta 2?
 ==================================
 
 *Release date: 12-Aug-2012*
@@ -6752,271 +6864,276 @@ What's New in Python 3.3.0 Beta 2?
 Core and Builtins
 -----------------
 
-- Issue #15568: Fix the return value of ``yield from`` when StopIteration is
+- bpo-15568: Fix the return value of ``yield from`` when StopIteration is
   raised by a custom iterator.
 
-- Issue #13119: `sys.stdout` and `sys.stderr` are now using "\r\n" newline on
+- bpo-13119: `sys.stdout` and `sys.stderr` are now using "\r\n" newline on
   Windows, as Python 2.
 
-- Issue #15534: Fix the fast-search function for non-ASCII Unicode strings.
+- bpo-15534: Fix the fast-search function for non-ASCII Unicode strings.
 
-- Issue #15508: Fix the docstring for `__import__()` to have the proper default
-  value of 0 for 'level' and to not mention negative levels since they are not
-  supported.
+- bpo-15508: Fix the docstring for `__import__()` to have the proper default
+  value of 0 for 'level' and to not mention negative levels since they are
+  not supported.
 
-- Issue #15425: Eliminated traceback noise from more situations involving
+- bpo-15425: Eliminated traceback noise from more situations involving
   importlib.
 
-- Issue #14578: Support modules registered in the Windows registry again.
+- bpo-14578: Support modules registered in the Windows registry again.
 
-- Issue #15466: Stop using TYPE_INT64 in marshal, to make importlib.h (and other
-  byte code files) equal between 32-bit and 64-bit systems.
+- bpo-15466: Stop using TYPE_INT64 in marshal, to make importlib.h (and
+  other byte code files) equal between 32-bit and 64-bit systems.
 
-- Issue #1692335: Move initial exception args assignment to
+- bpo-1692335: Move initial exception args assignment to
   `BaseException.__new__()` to help pickling of naive subclasses.
 
-- Issue #12834: Fix `PyBuffer_ToContiguous()` for non-contiguous arrays.
+- bpo-12834: Fix `PyBuffer_ToContiguous()` for non-contiguous arrays.
 
-- Issue #15456: Fix code `__sizeof__()` after #12399 change.  Patch by Serhiy
+- bpo-15456: Fix code `__sizeof__()` after #12399 change.  Patch by Serhiy
   Storchaka.
 
-- Issue #15404: Refleak in PyMethodObject repr.
+- bpo-15404: Refleak in PyMethodObject repr.
 
-- Issue #15394: An issue in `PyModule_Create()` that caused references to be
+- bpo-15394: An issue in `PyModule_Create()` that caused references to be
   leaked on some error paths has been fixed.  Patch by Julia Lawall.
 
-- Issue #15368: An issue that caused bytecode generation to be non-deterministic
-  has been fixed.
+- bpo-15368: An issue that caused bytecode generation to be non-
+  deterministic has been fixed.
 
-- Issue #15202: Consistently use the name "follow_symlinks" for new parameters
+- bpo-15202: Consistently use the name "follow_symlinks" for new parameters
   in os and shutil functions.
 
-- Issue #15314: ``__main__.__loader__`` is now set correctly during interpreter
+- bpo-15314: ``__main__.__loader__`` is now set correctly during interpreter
   startup.
 
-- Issue #15111: When a module imported using 'from import' has an ImportError
+- bpo-15111: When a module imported using 'from import' has an ImportError
   inside itself, don't mask that fact behind a generic ImportError for the
   module itself.
 
-- Issue #15293: Add GC support to the AST base node type.
+- bpo-15293: Add GC support to the AST base node type.
 
-- Issue #15291: Fix a memory leak where AST nodes where not properly
+- bpo-15291: Fix a memory leak where AST nodes where not properly
   deallocated.
 
-- Issue #15110: Fix the tracebacks generated by "import xxx" to not show the
+- bpo-15110: Fix the tracebacks generated by "import xxx" to not show the
   importlib stack frames.
 
-- Issue #16369: Global PyTypeObjects not initialized with PyType_Ready(...).
+- bpo-16369: Global PyTypeObjects not initialized with PyType_Ready(...).
 
-- Issue #15020: The program name used to search for Python's path is now
+- bpo-15020: The program name used to search for Python's path is now
   "python3" under Unix, not "python".
 
-- Issue #15897: zipimport.c doesn't check return value of fseek().
-  Patch by Felipe Cruz.
+- bpo-15897: zipimport.c doesn't check return value of fseek(). Patch by
+  Felipe Cruz.
 
-- Issue #15033: Fix the exit status bug when modules invoked using -m switch,
-  return the proper failure return value (1). Patch contributed by Jeff Knupp.
+- bpo-15033: Fix the exit status bug when modules invoked using -m switch,
+  return the proper failure return value (1). Patch contributed by Jeff
+  Knupp.
 
-- Issue #15229: An `OSError` subclass whose __init__ doesn't call back
-  OSError.__init__ could produce incomplete instances, leading to crashes when
-  calling str() on them.
+- bpo-15229: An `OSError` subclass whose __init__ doesn't call back
+  OSError.__init__ could produce incomplete instances, leading to crashes
+  when calling str() on them.
 
-- Issue #15307: Virtual environments now use symlinks with framework builds on
+- bpo-15307: Virtual environments now use symlinks with framework builds on
   Mac OS X, like other POSIX builds.
 
 Library
 -------
 
-- Issue #14590: configparser now correctly strips inline comments when delimiter
-  occurs earlier without preceding space.
+- bpo-14590: configparser now correctly strips inline comments when
+  delimiter occurs earlier without preceding space.
 
-- Issue #15424: Add a `__sizeof__()` implementation for array objects.  Patch by
-  Ludwig Hähne.
+- bpo-15424: Add a `__sizeof__()` implementation for array objects.  Patch
+  by Ludwig Hähne.
 
-- Issue #15576: Allow extension modules to act as a package's __init__ module.
+- bpo-15576: Allow extension modules to act as a package's __init__ module.
 
-- Issue #15502: Have `importlib.invalidate_caches()` work on `sys.meta_path`
+- bpo-15502: Have `importlib.invalidate_caches()` work on `sys.meta_path`
   instead of `sys.path_importer_cache`.
 
-- Issue #15163: Pydoc shouldn't list __loader__ as module data.
+- bpo-15163: Pydoc shouldn't list __loader__ as module data.
 
-- Issue #15471: Do not use mutable objects as defaults for
+- bpo-15471: Do not use mutable objects as defaults for
   `importlib.__import__()`.
 
-- Issue #15559: To avoid a problematic failure mode when passed to the bytes
-  constructor, objects in the ipaddress module no longer implement `__index__()`
-  (they still implement `__int__()` as appropriate).
+- bpo-15559: To avoid a problematic failure mode when passed to the bytes
+  constructor, objects in the ipaddress module no longer implement
+  `__index__()` (they still implement `__int__()` as appropriate).
 
-- Issue #15546: Fix handling of pathological input data in the peek() and
+- bpo-15546: Fix handling of pathological input data in the peek() and
   read1() methods of the BZ2File, GzipFile and LZMAFile classes.
 
-- Issue #12655: Instead of requiring a custom type, `os.sched_getaffinity()` and
-  `os.sched_setaffinity()` now use regular sets of integers to represent the
-  CPUs a process is restricted to.
+- bpo-12655: Instead of requiring a custom type, `os.sched_getaffinity()`
+  and `os.sched_setaffinity()` now use regular sets of integers to represent
+  the CPUs a process is restricted to.
 
-- Issue #15538: Fix compilation of the `socket.getnameinfo()` /
+- bpo-15538: Fix compilation of the `socket.getnameinfo()` /
   `socket.getaddrinfo()` emulation code.  Patch by Philipp Hagemeister.
 
-- Issue #15519: Properly expose WindowsRegistryFinder in importlib (and use the
+- bpo-15519: Properly expose WindowsRegistryFinder in importlib (and use the
   correct term for it).  Original patch by Eric Snow.
 
-- Issue #15502: Bring the importlib ABCs into line with the current state of the
-  import protocols given PEP 420.  Original patch by Eric Snow.
+- bpo-15502: Bring the importlib ABCs into line with the current state of
+  the import protocols given PEP 420.  Original patch by Eric Snow.
 
-- Issue #15499: Launching a webbrowser in Unix used to sleep for a few seconds.
+- bpo-15499: Launching a webbrowser in Unix used to sleep for a few seconds.
   Original patch by Anton Barkovsky.
 
-- Issue #15463: The faulthandler module truncates strings to 500 characters,
+- bpo-15463: The faulthandler module truncates strings to 500 characters,
   instead of 100, to be able to display long file paths.
 
-- Issue #6056: Make `multiprocessing` use setblocking(True) on the sockets it
-  uses.  Original patch by J Derek Wilson.
+- bpo-6056: Make `multiprocessing` use setblocking(True) on the sockets it
+  uses. Original patch by J Derek Wilson.
 
-- Issue #15364: Fix sysconfig.get_config_var('srcdir') to be an absolute path.
+- bpo-15364: Fix sysconfig.get_config_var('srcdir') to be an absolute path.
 
-- Issue #15413: `os.times()` had disappeared under Windows.
+- bpo-15413: `os.times()` had disappeared under Windows.
 
-- Issue #15402: An issue in the struct module that caused `sys.getsizeof()` to
-  return incorrect results for struct.Struct instances has been fixed.  Initial
-  patch by Serhiy Storchaka.
+- bpo-15402: An issue in the struct module that caused `sys.getsizeof()` to
+  return incorrect results for struct.Struct instances has been fixed.
+  Initial patch by Serhiy Storchaka.
 
-- Issue #15232: When mangle_from is True, `email.Generator` now correctly
+- bpo-15232: When mangle_from is True, `email.Generator` now correctly
   mangles lines that start with 'From ' that occur in a MIME preamble or
   epilogue.
 
-- Issue #15094: Incorrectly placed #endif in _tkinter.c.  Patch by Serhiy
+- bpo-15094: Incorrectly placed #endif in _tkinter.c.  Patch by Serhiy
   Storchaka.
 
-- Issue #13922: `argparse` no longer incorrectly strips '--'s that appear after
+- bpo-13922: `argparse` no longer incorrectly strips '--'s that appear after
   the first one.
 
-- Issue #12353: `argparse` now correctly handles null argument values.
+- bpo-12353: `argparse` now correctly handles null argument values.
 
-- Issue #10017, issue #14998: Fix TypeError using pprint on dictionaries with
-  user-defined types as keys or other unorderable keys.
+- bpo-10017: Fix TypeError using pprint on dictionaries with user-defined
+  types as keys or other unorderable keys. (See also: bpo-14998)
 
-- Issue #15397: `inspect.getmodulename()` is now based directly on importlib via
-  a new `importlib.machinery.all_suffixes()` API.
+- bpo-15397: `inspect.getmodulename()` is now based directly on importlib
+  via a new `importlib.machinery.all_suffixes()` API.
 
-- Issue #14635: `telnetlib` will use poll() rather than select() when possible to
-  avoid failing due to the select() file descriptor limit.
+- bpo-14635: `telnetlib` will use poll() rather than select() when possible
+  to avoid failing due to the select() file descriptor limit.
 
-- Issue #15180: Clarify posixpath.join() error message when mixing str & bytes.
+- bpo-15180: Clarify posixpath.join() error message when mixing str & bytes.
 
-- Issue #15343: pkgutil now includes an iter_importer_modules implementation for
-  importlib.machinery.FileFinder (similar to the way it already handled
+- bpo-15343: pkgutil now includes an iter_importer_modules implementation
+  for importlib.machinery.FileFinder (similar to the way it already handled
   zipimport.zipimporter).
 
-- Issue #15314: runpy now sets __main__.__loader__ correctly.
+- bpo-15314: runpy now sets __main__.__loader__ correctly.
 
-- Issue #15357: The import emulation in pkgutil is now deprecated. pkgutil uses
+- bpo-15357: The import emulation in pkgutil is now deprecated. pkgutil uses
   importlib internally rather than the emulation.
 
-- Issue #15233: Python now guarantees that callables registered with the atexit
+- bpo-15233: Python now guarantees that callables registered with the atexit
   module will be called in a deterministic order.
 
-- Issue #15238: `shutil.copystat()` now copies Linux "extended attributes".
+- bpo-15238: `shutil.copystat()` now copies Linux "extended attributes".
 
-- Issue #15230: runpy.run_path now correctly sets __package__ as described in
+- bpo-15230: runpy.run_path now correctly sets __package__ as described in
   the documentation.
 
-- Issue #15315: Support VS 2010 in distutils cygwincompiler.
+- bpo-15315: Support VS 2010 in distutils cygwincompiler.
 
-- Issue #15294: Fix a regression in pkgutil.extend_path()'s handling of nested
+- bpo-15294: Fix a regression in pkgutil.extend_path()'s handling of nested
   namespace packages.
 
-- Issue #15056: `imp.cache_from_source()` and `imp.source_from_cache()` raise
+- bpo-15056: `imp.cache_from_source()` and `imp.source_from_cache()` raise
   NotImplementedError when `sys.implementation.cache_tag` is set to None.
 
-- Issue #15256: Grammatical mistake in exception raised by `imp.find_module()`.
+- bpo-15256: Grammatical mistake in exception raised by `imp.find_module()`.
 
-- Issue #5931: `wsgiref` environ variable SERVER_SOFTWARE will specify an
-  implementation specific term like CPython, Jython instead of generic "Python".
+- bpo-5931: `wsgiref` environ variable SERVER_SOFTWARE will specify an
+  implementation specific term like CPython, Jython instead of generic
+  "Python".
 
-- Issue #13248: Remove obsolete argument "max_buffer_size" of BufferedWriter and
-  BufferedRWPair, from the io module.
+- bpo-13248: Remove obsolete argument "max_buffer_size" of BufferedWriter
+  and BufferedRWPair, from the io module.
 
-- Issue #13248: Remove obsolete argument "version" of `argparse.ArgumentParser`.
+- bpo-13248: Remove obsolete argument "version" of
+  `argparse.ArgumentParser`.
 
-- Issue #14814: Implement more consistent ordering and sorting behaviour for
+- bpo-14814: Implement more consistent ordering and sorting behaviour for
   ipaddress objects.
 
-- Issue #14814: `ipaddress` network objects correctly return NotImplemented when
-  compared to arbitrary objects instead of raising TypeError.
+- bpo-14814: `ipaddress` network objects correctly return NotImplemented
+  when compared to arbitrary objects instead of raising TypeError.
 
-- Issue #14990: Correctly fail with SyntaxError on invalid encoding declaration.
+- bpo-14990: Correctly fail with SyntaxError on invalid encoding
+  declaration.
 
-- Issue #14814: `ipaddress` now provides more informative error messages when
+- bpo-14814: `ipaddress` now provides more informative error messages when
   constructing instances directly (changes permitted during beta due to
   provisional API status).
 
-- Issue #15247: `io.FileIO` now raises an error when given a file descriptor
+- bpo-15247: `io.FileIO` now raises an error when given a file descriptor
   pointing to a directory.
 
-- Issue #15261: Stop os.stat(fd) crashing on Windows when fd not open.
+- bpo-15261: Stop os.stat(fd) crashing on Windows when fd not open.
 
-- Issue #15166: Implement `imp.get_tag()` using `sys.implementation.cache_tag`.
+- bpo-15166: Implement `imp.get_tag()` using `sys.implementation.cache_tag`.
 
-- Issue #15210: Catch KeyError when `importlib.__init__()` can't find
+- bpo-15210: Catch KeyError when `importlib.__init__()` can't find
   _frozen_importlib in sys.modules, not ImportError.
 
-- Issue #15030: `importlib.abc.PyPycLoader` now supports the new source size
+- bpo-15030: `importlib.abc.PyPycLoader` now supports the new source size
   header field in .pyc files.
 
-- Issue #5346: Preserve permissions of mbox, MMDF and Babyl mailbox files on
+- bpo-5346: Preserve permissions of mbox, MMDF and Babyl mailbox files on
   flush().
 
-- Issue #10571: Fix the "--sign" option of distutils' upload command.  Patch by
+- bpo-10571: Fix the "--sign" option of distutils' upload command.  Patch by
   Jakub Wilk.
 
-- Issue #9559: If messages were only added, a new file is no longer created and
+- bpo-9559: If messages were only added, a new file is no longer created and
   renamed over the old file when flush() is called on an mbox, MMDF or Babyl
   mailbox.
 
-- Issue #10924: Fixed `crypt.mksalt()` to use a RNG that is suitable for
+- bpo-10924: Fixed `crypt.mksalt()` to use a RNG that is suitable for
   cryptographic purpose.
 
-- Issue #15184: Ensure consistent results of OS X configuration tailoring for
+- bpo-15184: Ensure consistent results of OS X configuration tailoring for
   universal builds by factoring out common OS X-specific customizations from
-  sysconfig, distutils.sysconfig, distutils.util, and distutils.unixccompiler
-  into a new module _osx_support.
+  sysconfig, distutils.sysconfig, distutils.util, and
+  distutils.unixccompiler into a new module _osx_support.
 
 C API
 -----
 
-- Issue #15610: `PyImport_ImportModuleEx()` now uses a 'level' of 0 instead of -1.
+- bpo-15610: `PyImport_ImportModuleEx()` now uses a 'level' of 0 instead of
+  -1.
 
-- Issue #15169, issue #14599: Strip out the C implementation of
-  `imp.source_from_cache()` used by PyImport_ExecCodeModuleWithPathnames() and
-  used the Python code instead. Leads to PyImport_ExecCodeModuleObject() to not
-  try to infer the source path from the bytecode path as
-  PyImport_ExecCodeModuleWithPathnames() does.
+- bpo-15169: Strip out the C implementation of `imp.source_from_cache()`
+  used by PyImport_ExecCodeModuleWithPathnames() and used the Python code
+  instead. Leads to PyImport_ExecCodeModuleObject() to not try to infer the
+  source path from the bytecode path as
+  PyImport_ExecCodeModuleWithPathnames() does. (See also: bpo-14599)
 
-Extension Modules
------------------
+Library
+-------
 
-- Issue #6493: An issue in ctypes on Windows that caused structure bitfields of
+- bpo-6493: An issue in ctypes on Windows that caused structure bitfields of
   type `ctypes.c_uint32` and width 32 to incorrectly be set has been fixed.
 
-- Issue #15194: Update libffi to the 3.0.11 release.
+- bpo-15194: Update libffi to the 3.0.11 release.
 
 IDLE
 ----
 
-- Issue #13052: Fix IDLE crashing when replace string in Search/Replace dialog
+- bpo-13052: Fix IDLE crashing when replace string in Search/Replace dialog
   ended with ``\``.  Patch by Roger Serwy.
 
 Tools/Demos
 -----------
 
-- Issue #15458: python-config gets a new option --configdir to print the $LIBPL
+- bpo-15458: python-config gets a new option --configdir to print the $LIBPL
   value.
 
 - Move importlib.test.benchmark to Tools/importbench.
 
-- Issue #12605: The gdb hooks for debugging CPython (within Tools/gdb) have been
-  enhanced to show information on more C frames relevant to CPython within the
-  "py-bt" and "py-bt-full" commands:
+- bpo-12605: The gdb hooks for debugging CPython (within Tools/gdb) have
+  been enhanced to show information on more C frames relevant to CPython
+  within the "py-bt" and "py-bt-full" commands:
 
   * C frames that are waiting on the GIL
   * C frames that are garbage-collecting
@@ -7025,96 +7142,96 @@ Tools/Demos
 Documentation
 -------------
 
-- Issue #15041: Update "see also" list in tkinter documentation.
+- bpo-15041: Update "see also" list in tkinter documentation.
 
-- Issue #15444: Use proper spelling for non-ASCII contributor names.  Patch by
+- bpo-15444: Use proper spelling for non-ASCII contributor names.  Patch by
   Serhiy Storchaka.
 
-- Issue #15295: Reorganize and rewrite the documentation on the import system.
+- bpo-15295: Reorganize and rewrite the documentation on the import system.
 
-- Issue #15230: Clearly document some of the limitations of the runpy module and
-  nudge readers towards importlib when appropriate.
+- bpo-15230: Clearly document some of the limitations of the runpy module
+  and nudge readers towards importlib when appropriate.
 
-- Issue #15053: Copy Python 3.3 import lock change notice to all relevant
+- bpo-15053: Copy Python 3.3 import lock change notice to all relevant
   functions in imp instead of just at the top of the relevant section.
 
-- Issue #15288: Link to the term "loader" in notes in pkgutil about how things
+- bpo-15288: Link to the term "loader" in notes in pkgutil about how things
   won't work as expected in Python 3.3 and mark the requisite functions as
   "changed" since they will no longer work with modules directly imported by
   import itself.
 
-- Issue #13557: Clarify effect of giving two different namespaces to `exec()` or
-  `execfile()`.
+- bpo-13557: Clarify effect of giving two different namespaces to `exec()`
+  or `execfile()`.
 
-- Issue #15250: Document that `filecmp.dircmp()` compares files shallowly. Patch
-  contributed by Chris Jerdonek.
+- bpo-15250: Document that `filecmp.dircmp()` compares files shallowly.
+  Patch contributed by Chris Jerdonek.
 
-- Issue #15442: Expose the default list of directories ignored by
-  `filecmp.dircmp()` as a module attribute, and expand the list to more modern
-  values.
+- bpo-15442: Expose the default list of directories ignored by
+  `filecmp.dircmp()` as a module attribute, and expand the list to more
+  modern values.
 
 Tests
 -----
 
-- Issue #15467: Move helpers for `__sizeof__()` tests into test_support.  Patch
+- bpo-15467: Move helpers for `__sizeof__()` tests into test_support.  Patch
   by Serhiy Storchaka.
 
-- Issue #15320: Make iterating the list of tests thread-safe when running tests
+- bpo-15320: Make iterating the list of tests thread-safe when running tests
   in multiprocess mode. Patch by Chris Jerdonek.
 
-- Issue #15168: Move `importlib.test` to `test.test_importlib`.
+- bpo-15168: Move `importlib.test` to `test.test_importlib`.
 
-- Issue #15091: Reactivate a test on UNIX which was failing thanks to a
+- bpo-15091: Reactivate a test on UNIX which was failing thanks to a
   forgotten `importlib.invalidate_caches()` call.
 
-- Issue #15230: Adopted a more systematic approach in the runpy tests.
+- bpo-15230: Adopted a more systematic approach in the runpy tests.
 
-- Issue #15300: Ensure the temporary test working directories are in the same
+- bpo-15300: Ensure the temporary test working directories are in the same
   parent folder when running tests in multiprocess mode from a Python build.
   Patch by Chris Jerdonek.
 
-- Issue #15284: Skip {send,recv}msg tests in test_socket when IPv6 is not
+- bpo-15284: Skip {send,recv}msg tests in test_socket when IPv6 is not
   enabled. Patch by Brian Brazil.
 
-- Issue #15277: Fix a resource leak in support.py when IPv6 is disabled.  Patch
+- bpo-15277: Fix a resource leak in support.py when IPv6 is disabled.  Patch
   by Brian Brazil.
 
 Build
 -----
 
-- Issue #11715: Fix multiarch detection without having Debian development tools
+- bpo-11715: Fix multiarch detection without having Debian development tools
   (dpkg-dev) installed.
 
-- Issue #15037: Build OS X installers with local copy of ncurses 5.9 libraries
+- bpo-15037: Build OS X installers with local copy of ncurses 5.9 libraries
   to avoid curses.unget_wch bug present in older versions of ncurses such as
   those shipped with OS X.
 
-- Issue #15560: Fix building _sqlite3 extension on OS X with an SDK.  Also, for
-  OS X installers, ensure consistent sqlite3 behavior and feature availability
-  by building a local copy of libsqlite3 rather than depending on the wide range
-  of versions supplied with various OS X releases.
+- bpo-15560: Fix building _sqlite3 extension on OS X with an SDK.  Also, for
+  OS X installers, ensure consistent sqlite3 behavior and feature
+  availability by building a local copy of libsqlite3 rather than depending
+  on the wide range of versions supplied with various OS X releases.
 
-- Issue #8847: Disable COMDAT folding in Windows PGO builds.
+- bpo-8847: Disable COMDAT folding in Windows PGO builds.
 
-- Issue #14018: Fix OS X Tcl/Tk framework checking when using OS X SDKs.
+- bpo-14018: Fix OS X Tcl/Tk framework checking when using OS X SDKs.
 
-- Issue #16256: OS X installer now sets correct permissions for doc directory.
+- bpo-16256: OS X installer now sets correct permissions for doc directory.
 
-- Issue #15431: Add _freeze_importlib project to regenerate importlib.h on
+- bpo-15431: Add _freeze_importlib project to regenerate importlib.h on
   Windows. Patch by Kristján Valur Jónsson.
 
-- Issue #14197: For OS X framework builds, ensure links to the shared library
+- bpo-14197: For OS X framework builds, ensure links to the shared library
   are created with the proper ABI suffix.
 
-- Issue #14330: For cross builds, don't use host python, use host search paths
+- bpo-14330: For cross builds, don't use host python, use host search paths
   for host compiler.
 
-- Issue #15235: Allow Berkley DB versions up to 5.3 to build the dbm module.
+- bpo-15235: Allow Berkley DB versions up to 5.3 to build the dbm module.
 
-- Issue #15268: Search curses.h in /usr/include/ncursesw.
+- bpo-15268: Search curses.h in /usr/include/ncursesw.
 
 
-What's New in Python 3.3.0 Beta 1?
+What's New in Python 3.3.0 beta 1?
 ==================================
 
 *Release date: 27-Jun-2012*
@@ -7122,83 +7239,84 @@ What's New in Python 3.3.0 Beta 1?
 Core and Builtins
 -----------------
 
-- Fix a (most likely) very rare memory leak when calling main() and not being
-  able to decode a command-line argument.
+- Fix a (most likely) very rare memory leak when calling main() and not
+  being able to decode a command-line argument.
 
-- Issue #14815: Use Py_ssize_t instead of long for the object hash, to
-  preserve all 64 bits of hash on Win64.
+- bpo-14815: Use Py_ssize_t instead of long for the object hash, to preserve
+  all 64 bits of hash on Win64.
 
-- Issue #12268: File readline, readlines and read() or readall() methods
-  no longer lose data when an underlying read system call is interrupted.
-  IOError is no longer raised due to a read system call returning EINTR
-  from within these methods.
+- bpo-12268: File readline, readlines and read() or readall() methods no
+  longer lose data when an underlying read system call is interrupted.
+  IOError is no longer raised due to a read system call returning EINTR from
+  within these methods.
 
-- Issue #11626: Add _SizeT functions to stable ABI.
+- bpo-11626: Add _SizeT functions to stable ABI.
 
-- Issue #15142: Fix reference leak when deallocating instances of types
-  created using PyType_FromSpec().
+- bpo-15142: Fix reference leak when deallocating instances of types created
+  using PyType_FromSpec().
 
-- Issue #10053: Don't close FDs when FileIO.__init__ fails. Loosely based on
+- bpo-10053: Don't close FDs when FileIO.__init__ fails. Loosely based on
   the work by Hirokazu Yamamoto.
 
-- Issue #15096: Removed support for ur'' as the raw notation isn't
-  compatible with Python 2.x's raw unicode strings.
+- bpo-15096: Removed support for ur'' as the raw notation isn't compatible
+  with Python 2.x's raw unicode strings.
 
-- Issue #13783: Generator objects now use the identifier APIs internally
+- bpo-13783: Generator objects now use the identifier APIs internally
 
-- Issue #14874: Restore charmap decoding speed to pre-PEP 393 levels.
-  Patch by Serhiy Storchaka.
+- bpo-14874: Restore charmap decoding speed to pre-PEP 393 levels. Patch by
+  Serhiy Storchaka.
 
-- Issue #15026: utf-16 encoding is now significantly faster (up to 10x).
-  Patch by Serhiy Storchaka.
+- bpo-15026: utf-16 encoding is now significantly faster (up to 10x). Patch
+  by Serhiy Storchaka.
 
-- Issue #11022: open() and io.TextIOWrapper are now calling
-  locale.getpreferredencoding(False) instead of locale.getpreferredencoding()
-  in text mode if the encoding is not specified. Don't change temporary the
-  locale encoding using locale.setlocale(), use the current locale encoding
-  instead of the user preferred encoding.
+- bpo-11022: open() and io.TextIOWrapper are now calling
+  locale.getpreferredencoding(False) instead of
+  locale.getpreferredencoding() in text mode if the encoding is not
+  specified. Don't change temporary the locale encoding using
+  locale.setlocale(), use the current locale encoding instead of the user
+  preferred encoding.
 
-- Issue #14673: Add Eric Snow's sys.implementation implementation.
+- bpo-14673: Add Eric Snow's sys.implementation implementation.
 
-- Issue #15038: Optimize python Locks on Windows.
+- bpo-15038: Optimize python Locks on Windows.
 
 Library
 -------
 
-- Issue #12288: Consider '0' and '0.0' as valid initialvalue
-  for tkinter SimpleDialog.
+- bpo-12288: Consider '0' and '0.0' as valid initialvalue for tkinter
+  SimpleDialog.
 
-- Issue #15512: Add a __sizeof__ implementation for parser.
-  Patch by Serhiy Storchaka.
+- bpo-15512: Add a __sizeof__ implementation for parser. Patch by Serhiy
+  Storchaka.
 
-- Issue #15469: Add a __sizeof__ implementation for deque objects.
-  Patch by Serhiy Storchaka.
+- bpo-15469: Add a __sizeof__ implementation for deque objects. Patch by
+  Serhiy Storchaka.
 
-- Issue #15489: Add a __sizeof__ implementation for BytesIO objects.
-  Patch by Serhiy Storchaka.
+- bpo-15489: Add a __sizeof__ implementation for BytesIO objects. Patch by
+  Serhiy Storchaka.
 
-- Issue #15487: Add a __sizeof__ implementation for buffered I/O objects.
-  Patch by Serhiy Storchaka.
+- bpo-15487: Add a __sizeof__ implementation for buffered I/O objects. Patch
+  by Serhiy Storchaka.
 
-- Issue #15514: Correct __sizeof__ support for cpu_set.
-  Patch by Serhiy Storchaka.
+- bpo-15514: Correct __sizeof__ support for cpu_set. Patch by Serhiy
+  Storchaka.
 
-- Issue #15177: Added dir_fd parameter to os.fwalk().
+- bpo-15177: Added dir_fd parameter to os.fwalk().
 
-- Issue #15061: Re-implemented hmac.compare_digest() in C to prevent further
-  timing analysis and to support all buffer protocol aware objects as well as
-  ASCII only str instances safely.
+- bpo-15061: Re-implemented hmac.compare_digest() in C to prevent further
+  timing analysis and to support all buffer protocol aware objects as well
+  as ASCII only str instances safely.
 
-- Issue #15164: Change return value of platform.uname() from a
-  plain tuple to a collections.namedtuple.
+- bpo-15164: Change return value of platform.uname() from a plain tuple to a
+  collections.namedtuple.
 
 - Support Mageia Linux in the platform module.
 
-- Issue #11678: Support Arch linux in the platform module.
+- bpo-11678: Support Arch linux in the platform module.
 
-- Issue #15118: Change return value of os.uname() and os.times() from
-  plain tuples to immutable iterable objects with named attributes
-  (structseq objects).
+- bpo-15118: Change return value of os.uname() and os.times() from plain
+  tuples to immutable iterable objects with named attributes (structseq
+  objects).
 
 - Speed up _decimal by another 10-15% by caching the thread local context
   that was last accessed. In the pi benchmark (64-bit platform, prec=9),
@@ -7206,244 +7324,239 @@ Library
 
 - Remove the packaging module, which is not ready for prime time.
 
-- Issue #15154: Add "dir_fd" parameter to os.rmdir, remove "rmdir"
-  parameter from os.remove / os.unlink.
+- bpo-15154: Add "dir_fd" parameter to os.rmdir, remove "rmdir" parameter
+  from os.remove / os.unlink.
 
-- Issue #4489: Add a shutil.rmtree that isn't susceptible to symlink attacks.
+- bpo-4489: Add a shutil.rmtree that isn't susceptible to symlink attacks.
   It is used automatically on platforms supporting the necessary os.openat()
   and os.unlinkat() functions. Main code by Martin von Löwis.
 
-- Issue #15156: HTMLParser now uses the new "html.entities.html5" dictionary.
+- bpo-15156: HTMLParser now uses the new "html.entities.html5" dictionary.
 
-- Issue #11113: add a new "html5" dictionary containing the named character
+- bpo-11113: add a new "html5" dictionary containing the named character
   references defined by the HTML5 standard and the equivalent Unicode
   character(s) to the html.entities module.
 
-- Issue #15114: the strict mode of HTMLParser and the HTMLParseError exception
+- bpo-15114: the strict mode of HTMLParser and the HTMLParseError exception
   are deprecated now that the parser is able to parse invalid markup.
 
-- Issue #3665: \u and \U escapes are now supported in unicode regular
+- bpo-3665: \u and \U escapes are now supported in unicode regular
   expressions.  Patch by Serhiy Storchaka.
 
-- Issue #15153: Added inspect.getgeneratorlocals to simplify white box
-  testing of generator state updates
+- bpo-15153: Added inspect.getgeneratorlocals to simplify white box testing
+  of generator state updates
 
-- Issue #13062: Added inspect.getclosurevars to simplify testing stateful
+- bpo-13062: Added inspect.getclosurevars to simplify testing stateful
   closures
 
-- Issue #11024: Fixes and additional tests for Time2Internaldate.
+- bpo-11024: Fixes and additional tests for Time2Internaldate.
 
-- Issue #14626: Large refactoring of functions / parameters in the os module.
-  Many functions now support "dir_fd" and "follow_symlinks" parameters;
-  some also support accepting an open file descriptor in place of a path
-  string.  Added os.support_* collections as LBYL helpers.  Removed many
-  functions only previously seen in 3.3 alpha releases (often starting with
-  "f" or "l", or ending with "at").  Originally suggested by Serhiy Storchaka;
+- bpo-14626: Large refactoring of functions / parameters in the os module.
+  Many functions now support "dir_fd" and "follow_symlinks" parameters; some
+  also support accepting an open file descriptor in place of a path string.
+  Added os.support_* collections as LBYL helpers.  Removed many functions
+  only previously seen in 3.3 alpha releases (often starting with "f" or
+  "l", or ending with "at").  Originally suggested by Serhiy Storchaka;
   implemented by Larry Hastings.
 
-- Issue #15008: Implement PEP 362 "Signature Objects".
-  Patch by Yury Selivanov.
+- bpo-15008: Implement PEP 362 "Signature Objects". Patch by Yury Selivanov.
 
-- Issue: #15138: base64.urlsafe_{en,de}code() are now 3-4x faster.
+- bpo-15138: base64.urlsafe_{en,de}code() are now 3-4x faster.
 
-- Issue #444582: Add shutil.which, for finding programs on the system path.
-  Original patch by Erik Demaine, with later iterations by Jan Killian
-  and Brian Curtin.
+- bpo-444582: Add shutil.which, for finding programs on the system path.
+  Original patch by Erik Demaine, with later iterations by Jan Killian and
+  Brian Curtin.
 
-- Issue #14837: SSL errors now have ``library`` and ``reason`` attributes
+- bpo-14837: SSL errors now have ``library`` and ``reason`` attributes
   describing precisely what happened and in which OpenSSL submodule.  The
   str() of a SSLError is also enhanced accordingly.
 
-- Issue #9527: datetime.astimezone() method will now supply a class
-  timezone instance corresponding to the system local timezone when
-  called with no arguments.
+- bpo-9527: datetime.astimezone() method will now supply a class timezone
+  instance corresponding to the system local timezone when called with no
+  arguments.
 
-- Issue #14653: email.utils.mktime_tz() no longer relies on system
-  mktime() when timezone offest is supplied.
+- bpo-14653: email.utils.mktime_tz() no longer relies on system mktime()
+  when timezone offest is supplied.
 
-- Issue #14684: zlib.compressobj() and zlib.decompressobj() now support the use
+- bpo-14684: zlib.compressobj() and zlib.decompressobj() now support the use
   of predefined compression dictionaries. Original patch by Sam Rushing.
 
 - Fix GzipFile's handling of filenames given as bytes objects.
 
-- Issue #14772: Return destination values from some shutil functions.
+- bpo-14772: Return destination values from some shutil functions.
 
-- Issue #15064: Implement context manager protocol for multiprocessing types
+- bpo-15064: Implement context manager protocol for multiprocessing types
 
-- Issue #15101: Make pool finalizer avoid joining current thread.
+- bpo-15101: Make pool finalizer avoid joining current thread.
 
-- Issue #14657: The frozen instance of importlib used for bootstrap is now
-  also the module imported as importlib._bootstrap.
+- bpo-14657: The frozen instance of importlib used for bootstrap is now also
+  the module imported as importlib._bootstrap.
 
-- Issue #14055: Add __sizeof__ support to _elementtree.
+- bpo-14055: Add __sizeof__ support to _elementtree.
 
-- Issue #15054: A bug in tokenize.tokenize that caused string literals
-  with 'b' prefixes to be incorrectly tokenized has been fixed.
-  Patch by Serhiy Storchaka.
+- bpo-15054: A bug in tokenize.tokenize that caused string literals with 'b'
+  prefixes to be incorrectly tokenized has been fixed. Patch by Serhiy
+  Storchaka.
 
-- Issue #15006: Allow equality comparison between naive and aware
-  time or datetime objects.
+- bpo-15006: Allow equality comparison between naive and aware time or
+  datetime objects.
 
-- Issue #15036: Mailbox no longer throws an error if a flush is done
-  between operations when removing or changing multiple items in mbox,
-  MMDF, or Babyl mailboxes.
+- bpo-15036: Mailbox no longer throws an error if a flush is done between
+  operations when removing or changing multiple items in mbox, MMDF, or
+  Babyl mailboxes.
 
-- Issue #14059: Implement multiprocessing.Barrier.
+- bpo-14059: Implement multiprocessing.Barrier.
 
-- Issue #15061: The inappropriately named hmac.secure_compare has been
-  renamed to hmac.compare_digest, restricted to operating on bytes inputs
-  only and had its documentation updated to more accurately reflect both its
-  intent and its limitations
+- bpo-15061: The inappropriately named hmac.secure_compare has been renamed
+  to hmac.compare_digest, restricted to operating on bytes inputs only and
+  had its documentation updated to more accurately reflect both its intent
+  and its limitations
 
-- Issue #13841: Make child processes exit using sys.exit() on Windows.
+- bpo-13841: Make child processes exit using sys.exit() on Windows.
 
-- Issue #14936: curses_panel was converted to PEP 3121 and PEP 384 API.
-  Patch by Robin Schreiber.
+- bpo-14936: curses_panel was converted to PEP 3121 and PEP 384 API. Patch
+  by Robin Schreiber.
 
-- Issue #1667546: On platforms supporting tm_zone and tm_gmtoff fields
-  in struct tm, time.struct_time objects returned by time.gmtime(),
+- bpo-1667546: On platforms supporting tm_zone and tm_gmtoff fields in
+  struct tm, time.struct_time objects returned by time.gmtime(),
   time.localtime() and time.strptime() functions now have tm_zone and
-  tm_gmtoff attributes.  Original patch by Paul Boddie.
+  tm_gmtoff attributes. Original patch by Paul Boddie.
 
 - Rename adjusted attribute to adjustable in time.get_clock_info() result.
 
-- Issue #3518: Remove references to non-existent BaseManager.from_address()
+- bpo-3518: Remove references to non-existent BaseManager.from_address()
   method.
 
-- Issue #13857: Added textwrap.indent() function (initial patch by Ezra
-  Berch)
+- bpo-13857: Added textwrap.indent() function (initial patch by Ezra Berch)
 
-- Issue #2736: Added datetime.timestamp() method.
+- bpo-2736: Added datetime.timestamp() method.
 
-- Issue #13854: Make multiprocessing properly handle non-integer
-  non-string argument to SystemExit.
+- bpo-13854: Make multiprocessing properly handle non-integer non-string
+  argument to SystemExit.
 
-- Issue #12157: Make pool.map() empty iterables correctly.  Initial
-  patch by mouad.
+- bpo-12157: Make pool.map() empty iterables correctly.  Initial patch by
+  mouad.
 
-- Issue #11823: disassembly now shows argument counts on calls with keyword args.
+- bpo-11823: disassembly now shows argument counts on calls with keyword
+  args.
 
-- Issue #14711: os.stat_float_times() has been deprecated.
+- bpo-14711: os.stat_float_times() has been deprecated.
 
 - LZMAFile now accepts the modes "rb"/"wb"/"ab" as synonyms of "r"/"w"/"a".
 
 - The bz2 and lzma modules now each contain an open() function, allowing
   compressed files to readily be opened in text mode as well as binary mode.
 
-- BZ2File.__init__() and LZMAFile.__init__() now accept a file object as their
-  first argument, rather than requiring a separate "fileobj" argument.
+- BZ2File.__init__() and LZMAFile.__init__() now accept a file object as
+  their first argument, rather than requiring a separate "fileobj" argument.
 
 - gzip.open() now accepts file objects as well as filenames.
 
-- Issue #14992: os.makedirs(path, exist_ok=True) would raise an OSError
-  when the path existed and had the S_ISGID mode bit set when it was
-  not explicitly asked for.  This is no longer an exception as mkdir
-  cannot control if the OS sets that bit for it or not.
+- bpo-14992: os.makedirs(path, exist_ok=True) would raise an OSError when
+  the path existed and had the S_ISGID mode bit set when it was not
+  explicitly asked for.  This is no longer an exception as mkdir cannot
+  control if the OS sets that bit for it or not.
 
-- Issue #14989: Make the CGI enable option to http.server available via command
+- bpo-14989: Make the CGI enable option to http.server available via command
   line.
 
-- Issue #14987: Add a missing import statement to inspect.
+- bpo-14987: Add a missing import statement to inspect.
 
-- Issue #1079: email.header.decode_header now correctly parses all the examples
-  in RFC2047.  There is a necessary visible behavior change: the leading and/or
-  trailing whitespace on ASCII parts is now preserved.
+- bpo-1079: email.header.decode_header now correctly parses all the examples
+  in RFC2047. There is a necessary visible behavior change: the leading
+  and/or trailing whitespace on ASCII parts is now preserved.
 
-- Issue #14969: Better handling of exception chaining in contextlib.ExitStack
+- bpo-14969: Better handling of exception chaining in contextlib.ExitStack
 
-- Issue #14963: Convert contextlib.ExitStack.__exit__ to use an iterative
+- bpo-14963: Convert contextlib.ExitStack.__exit__ to use an iterative
   algorithm (Patch by Alon Horev)
 
-- Issue #14785: Add sys._debugmallocstats() to help debug low-level memory
+- bpo-14785: Add sys._debugmallocstats() to help debug low-level memory
   allocation issues
 
-- Issue #14443: Ensure that .py files are byte-compiled with the correct Python
+- bpo-14443: Ensure that .py files are byte-compiled with the correct Python
   executable within bdist_rpm even on older versions of RPM
 
-C-API
+C API
 -----
 
-- Issue #15146: Add PyType_FromSpecWithBases. Patch by Robin Schreiber.
+- bpo-15146: Add PyType_FromSpecWithBases. Patch by Robin Schreiber.
 
-- Issue #15042: Add PyState_AddModule and PyState_RemoveModule. Add version
+- bpo-15042: Add PyState_AddModule and PyState_RemoveModule. Add version
   guard for Py_LIMITED_API additions. Patch by Robin Schreiber.
 
-- Issue #13783: Inadvertent additions to the public C API in the PEP 380
+- bpo-13783: Inadvertent additions to the public C API in the PEP 380
   implementation have either been removed or marked as private interfaces.
 
-Extension Modules
------------------
+Library
+-------
 
-- Issue #15000: Support the "unique" x32 architecture in _posixsubprocess.c.
+- bpo-15000: Support the "unique" x32 architecture in _posixsubprocess.c.
 
 IDLE
 ----
 
-- Issue #9803: Don't close IDLE on saving if breakpoint is open.
-  Patch by Roger Serwy.
+- bpo-9803: Don't close IDLE on saving if breakpoint is open. Patch by Roger
+  Serwy.
 
-- Issue #14962: Update text coloring in IDLE shell window after changing
+- bpo-14962: Update text coloring in IDLE shell window after changing
   options.  Patch by Roger Serwy.
 
 Documentation
 -------------
 
-- Issue #15176: Clarified behavior, documentation, and implementation
-  of os.listdir().
+- bpo-15176: Clarified behavior, documentation, and implementation of
+  os.listdir().
 
-- Issue #14982: Document that pkgutil's iteration functions require the
-  non-standard iter_modules() method to be defined by an importer (something
-  the importlib importers do not define).
+- bpo-14982: Document that pkgutil's iteration functions require the non-
+  standard iter_modules() method to be defined by an importer (something the
+  importlib importers do not define).
 
-- Issue #15081: Document PyState_FindModule.
-  Patch by Robin Schreiber.
+- bpo-15081: Document PyState_FindModule. Patch by Robin Schreiber.
 
-- Issue #14814: Added first draft of ipaddress module API reference
+- bpo-14814: Added first draft of ipaddress module API reference
 
 Tests
 -----
 
-- Issue #15187: Bugfix: remove temporary directories test_shutil was leaving
+- bpo-15187: Bugfix: remove temporary directories test_shutil was leaving
   behind.
 
-- Issue #14769: test_capi now has SkipitemTest, which cleverly checks
-  for "parity" between PyArg_ParseTuple() and the Python/getargs.c static
+- bpo-14769: test_capi now has SkipitemTest, which cleverly checks for
+  "parity" between PyArg_ParseTuple() and the Python/getargs.c static
   function skipitem() for all possible "format units".
 
 - test_nntplib now tolerates being run from behind NNTP gateways that add
   "X-Antivirus" headers to articles
 
-- Issue #15043: test_gdb is now skipped entirely if gdb security settings
-  block loading of the gdb hooks
+- bpo-15043: test_gdb is now skipped entirely if gdb security settings block
+  loading of the gdb hooks
 
-- Issue #14963: Add test cases for exception handling behaviour
-  in contextlib.ExitStack (Initial patch by Alon Horev)
+- bpo-14963: Add test cases for exception handling behaviour in
+  contextlib.ExitStack (Initial patch by Alon Horev)
 
 Build
 -----
 
-- Issue #13590: Improve support for OS X Xcode 4:
-    * Try to avoid building Python or extension modules with problematic
-      llvm-gcc compiler.
-    * Since Xcode 4 removes ppc support, extension module builds now
-      check for ppc compiler support and automatically remove ppc and
-      ppc64 archs when not available.
-    * Since Xcode 4 no longer install SDKs in default locations,
-      extension module builds now revert to using installed headers
-      and libs if the SDK used to build the interpreter is not
-      available.
-    * Update ./configure to use better defaults for universal builds;
-      in particular, --enable-universalsdk=yes uses the Xcode default
-      SDK and --with-universal-archs now defaults to "intel" if ppc
-      not available.
-
-- Issue #14225: Fix Unicode support for curses (#12567) on OS X
-
-- Issue #14928: Fix importlib bootstrap issues by using a custom executable
+- bpo-13590: Improve support for OS X Xcode 4:   * Try to avoid building
+  Python or extension modules with problematic     llvm-gcc compiler.   *
+  Since Xcode 4 removes ppc support, extension module builds now     check
+  for ppc compiler support and automatically remove ppc and     ppc64 archs
+  when not available. * Since Xcode 4 no longer install SDKs in default
+  locations,     extension module builds now revert to using installed
+  headers     and libs if the SDK used to build the interpreter is not
+  available.   * Update ./configure to use better defaults for universal
+  builds;     in particular, --enable- universalsdk=yes uses the Xcode
+  default     SDK and --with-universal-archs now defaults to "intel" if ppc
+  not available.
+
+- bpo-14225: Fix Unicode support for curses (#12567) on OS X
+
+- bpo-14928: Fix importlib bootstrap issues by using a custom executable
   (Modules/_freeze_importlib) to build Python/importlib.h.
 
 
-What's New in Python 3.3.0 Alpha 4?
+What's New in Python 3.3.0 alpha 4?
 ===================================
 
 *Release date: 31-May-2012*
@@ -7451,274 +7564,277 @@ What's New in Python 3.3.0 Alpha 4?
 Core and Builtins
 -----------------
 
-- Issue #14835: Make plistlib output empty arrays & dicts like OS X.
-  Patch by Sidney San Martín.
+- bpo-14835: Make plistlib output empty arrays & dicts like OS X. Patch by
+  Sidney San Martín.
 
-- Issue #14744: Use the new _PyUnicodeWriter internal API to speed up
-  str%args and str.format(args).
+- bpo-14744: Use the new _PyUnicodeWriter internal API to speed up str%args
+  and str.format(args).
 
-- Issue #14930: Make memoryview objects weakrefable.
+- bpo-14930: Make memoryview objects weakrefable.
 
-- Issue #14775: Fix a potential quadratic dict build-up due to the garbage
+- bpo-14775: Fix a potential quadratic dict build-up due to the garbage
   collector repeatedly trying to untrack dicts.
 
-- Issue #14857: fix regression in references to PEP 3135 implicit __class__
+- bpo-14857: fix regression in references to PEP 3135 implicit __class__
   closure variable (Reopens issue #12370)
 
-- Issue #14712 (PEP 405): Virtual environments. Implemented by Vinay Sajip.
+- bpo-14712: Virtual environments. Implemented by Vinay Sajip. (See also:
+  PEP 405)
 
-- Issue #14660 (PEP 420): Namespace packages. Implemented by Eric Smith.
+- bpo-14660: Namespace packages. Implemented by Eric Smith. (See also: PEP
+  420)
 
-- Issue #14494: Fix __future__.py and its documentation to note that
-  absolute imports are the default behavior in 3.0 instead of 2.7.
-  Patch by Sven Marnach.
+- bpo-14494: Fix __future__.py and its documentation to note that absolute
+  imports are the default behavior in 3.0 instead of 2.7. Patch by Sven
+  Marnach.
 
-- Issue #9260: A finer-grained import lock.  Most of the import sequence
-  now uses per-module locks rather than the global import lock, eliminating
+- bpo-9260: A finer-grained import lock.  Most of the import sequence now
+  uses per- module locks rather than the global import lock, eliminating
   well-known issues with threads and imports.
 
-- Issue #14624: UTF-16 decoding is now 3x to 4x faster on various inputs.
-  Patch by Serhiy Storchaka.
+- bpo-14624: UTF-16 decoding is now 3x to 4x faster on various inputs. Patch
+  by Serhiy Storchaka.
 
 - asdl_seq and asdl_int_seq are now Py_ssize_t sized.
 
-- Issue #14133 (PEP 415): Implement suppression of __context__ display with an
-  attribute on BaseException. This replaces the original mechanism of PEP 409.
+- bpo-14133: Implement suppression of __context__ display with an attribute
+  on BaseException. This replaces the original mechanism of PEP 409. (See
+  also: PEP 415)
 
-- Issue #14417: Mutating a dict during lookup now restarts the lookup instead
+- bpo-14417: Mutating a dict during lookup now restarts the lookup instead
   of raising a RuntimeError (undoes issue #14205).
 
-- Issue #14738: Speed-up UTF-8 decoding on non-ASCII data.  Patch by Serhiy
+- bpo-14738: Speed-up UTF-8 decoding on non-ASCII data.  Patch by Serhiy
   Storchaka.
 
-- Issue #14700: Fix two broken and undefined-behaviour-inducing overflow checks
+- bpo-14700: Fix two broken and undefined-behaviour-inducing overflow checks
   in old-style string formatting.
 
 Library
 -------
 
-- Issue #14690: Use monotonic clock instead of system clock in the sched,
+- bpo-14690: Use monotonic clock instead of system clock in the sched,
   subprocess and trace modules.
 
-- Issue #14443: Tell rpmbuild to use the correct version of Python in
+- bpo-14443: Tell rpmbuild to use the correct version of Python in
   bdist_rpm. Initial patch by Ross Lagerwall.
 
-- Issue #12515: email now registers a defect if it gets to EOF while parsing
-  MIME part without seeing the closing MIME boundary.
+- bpo-12515: email now registers a defect if it gets to EOF while parsing a
+  MIME part without seeing the closing MIME boundary.
 
-- Issue #1672568: email now always decodes base64 payloads, adding padding and
-  ignoring non-base64-alphabet characters if needed, and registering defects
-  for any such problems.
+- bpo-1672568: email now always decodes base64 payloads, adding padding and
+  ignoring non- base64-alphabet characters if needed, and registering
+  defects for any such problems.
 
-- Issue #14925: email now registers a defect when the parser decides that there
+- bpo-14925: email now registers a defect when the parser decides that there
   is a missing header/body separator line.  MalformedHeaderDefect, which the
   existing code would never actually generate, is deprecated.
 
-- Issue #10365: File open dialog now works instead of crashing even when
-  the parent window is closed before the dialog. Patch by Roger Serwy.
+- bpo-10365: File open dialog now works instead of crashing even when the
+  parent window is closed before the dialog. Patch by Roger Serwy.
 
-- Issue #8739: Updated smtpd to support RFC 5321, and added support for the
-  RFC 1870 SIZE extension.
+- bpo-8739: Updated smtpd to support RFC 5321, and added support for the RFC
+  1870 SIZE extension.
 
-- Issue #665194: Added a localtime function to email.utils to provide an
-  aware local datetime for use in setting Date headers.
+- bpo-665194: Added a localtime function to email.utils to provide an aware
+  local datetime for use in setting Date headers.
 
-- Issue #12586: Added new provisional policies that implement convenient
+- bpo-12586: Added new provisional policies that implement convenient
   unicode support for email headers.  See What's New for details.
 
-- Issue #14731: Refactored email Policy framework to support full backward
+- bpo-14731: Refactored email Policy framework to support full backward
   compatibility with Python 3.2 by default yet allow for the introduction of
-  new features through new policies.  Note that Policy.must_be_7bit is renamed
-  to cte_type.
+  new features through new policies.  Note that Policy.must_be_7bit is
+  renamed to cte_type.
 
-- Issue #14876: Use user-selected font for highlight configuration.
+- bpo-14876: Use user-selected font for highlight configuration.
 
-- Issue #14920: Fix the help(urllib.parse) failure on locale C on terminals.
+- bpo-14920: Fix the help(urllib.parse) failure on locale C on terminals.
   Have ascii characters in help.
 
-- Issue #14548: Make multiprocessing finalizers check pid before
-  running to cope with possibility of gc running just after fork.
+- bpo-14548: Make multiprocessing finalizers check pid before running to
+  cope with possibility of gc running just after fork.
 
-- Issue #14036: Add an additional check to validate that port in urlparse does
+- bpo-14036: Add an additional check to validate that port in urlparse does
   not go in illegal range and returns None.
 
-- Issue #14862: Add missing names to os.__all__
+- bpo-14862: Add missing names to os.__all__
 
-- Issue #14875: Use float('inf') instead of float('1e66666') in the json module.
+- bpo-14875: Use float('inf') instead of float('1e66666') in the json
+  module.
 
-- Issue #13585: Added contextlib.ExitStack
+- bpo-13585: Added contextlib.ExitStack
 
 - PEP 3144, Issue #14814: Added the ipaddress module
 
-- Issue #14426: Correct the Date format in Expires attribute of Set-Cookie
+- bpo-14426: Correct the Date format in Expires attribute of Set-Cookie
   Header in Cookie.py.
 
-- Issue #14588: The types module now provide new_class() and prepare_class()
+- bpo-14588: The types module now provide new_class() and prepare_class()
   functions to support PEP 3115 compliant dynamic class creation. Patch by
   Daniel Urban and Nick Coghlan.
 
-- Issue #13152: Allow to specify a custom tabsize for expanding tabs in
+- bpo-13152: Allow to specify a custom tabsize for expanding tabs in
   textwrap. Patch by John Feuerstein.
 
-- Issue #14721: Send the correct 'Content-length: 0' header when the body is an
+- bpo-14721: Send the correct 'Content-length: 0' header when the body is an
   empty string ''. Initial Patch contributed by Arve Knudsen.
 
-- Issue #14072: Fix parsing of 'tel' URIs in urlparse by making the check for
+- bpo-14072: Fix parsing of 'tel' URIs in urlparse by making the check for
   ports stricter.
 
-- Issue #9374: Generic parsing of query and fragment portions of url for any
+- bpo-9374: Generic parsing of query and fragment portions of url for any
   scheme. Supported both by RFC3986 and RFC2396.
 
-- Issue #14798: Fix the functions in pyclbr to raise an ImportError
-  when the first part of a dotted name is not a package. Patch by
-  Xavier de Gaye.
+- bpo-14798: Fix the functions in pyclbr to raise an ImportError when the
+  first part of a dotted name is not a package. Patch by Xavier de Gaye.
 
-- Issue #12098: multiprocessing on Windows now starts child processes
-  using the same sys.flags as the current process.  Initial patch by
-  Sergey Mezentsev.
+- bpo-12098: multiprocessing on Windows now starts child processes using the
+  same sys.flags as the current process.  Initial patch by Sergey Mezentsev.
 
-- Issue #13031: Small speed-up for tarfile when unzipping tarfiles.
-  Patch by Justin Peel.
+- bpo-13031: Small speed-up for tarfile when unzipping tarfiles. Patch by
+  Justin Peel.
 
-- Issue #14780: urllib.request.urlopen() now has a ``cadefault`` argument
-  to use the default certificate store.  Initial patch by James Oakley.
+- bpo-14780: urllib.request.urlopen() now has a ``cadefault`` argument to
+  use the default certificate store.  Initial patch by James Oakley.
 
-- Issue #14829: Fix bisect and range() indexing with large indices
-  (>= 2 ** 32) under 64-bit Windows.
+- bpo-14829: Fix bisect and range() indexing with large indices (>= 2 ** 32)
+  under 64-bit Windows.
 
-- Issue #14732: The _csv module now uses PEP 3121 module initialization.
-  Patch by Robin Schreiber.
+- bpo-14732: The _csv module now uses PEP 3121 module initialization. Patch
+  by Robin Schreiber.
 
-- Issue #14809: Add HTTP status codes introduced by RFC 6585 to http.server
-  and http.client. Patch by EungJun Yi.
+- bpo-14809: Add HTTP status codes introduced by RFC 6585 to http.server and
+  http.client. Patch by EungJun Yi.
 
-- Issue #14777: tkinter may return undecoded UTF-8 bytes as a string when
+- bpo-14777: tkinter may return undecoded UTF-8 bytes as a string when
   accessing the Tk clipboard.  Modify clipboad_get() to first request type
   UTF8_STRING when no specific type is requested in an X11 windowing
-  environment, falling back to the current default type STRING if that fails.
-  Original patch by Thomas Kluyver.
+  environment, falling back to the current default type STRING if that
+  fails. Original patch by Thomas Kluyver.
 
-- Issue #14773: Fix os.fwalk() failing on dangling symlinks.
+- bpo-14773: Fix os.fwalk() failing on dangling symlinks.
 
-- Issue #12541: Be lenient with quotes around Realm field of HTTP Basic
+- bpo-12541: Be lenient with quotes around Realm field of HTTP Basic
   Authentation in urllib2.
 
-- Issue #14807: move undocumented tarfile.filemode() to stat.filemode() and add
+- bpo-14807: move undocumented tarfile.filemode() to stat.filemode() and add
   doc entry. Add tarfile.filemode alias with deprecation warning.
 
-- Issue #13815: TarFile.extractfile() now returns io.BufferedReader objects.
+- bpo-13815: TarFile.extractfile() now returns io.BufferedReader objects.
 
-- Issue #14532: Add a secure_compare() helper to the hmac module, to mitigate
+- bpo-14532: Add a secure_compare() helper to the hmac module, to mitigate
   timing attacks. Patch by Jon Oberheide.
 
 - Add importlib.util.resolve_name().
 
-- Issue #14366: Support lzma compression in zip files.
-  Patch by Serhiy Storchaka.
+- bpo-14366: Support lzma compression in zip files. Patch by Serhiy
+  Storchaka.
 
-- Issue #13959: Introduce importlib.find_loader() and document
+- bpo-13959: Introduce importlib.find_loader() and document
   imp.find_module/load_module as deprecated.
 
-- Issue #14082: shutil.copy2() now copies extended attributes, if possible.
+- bpo-14082: shutil.copy2() now copies extended attributes, if possible.
   Patch by Hynek Schlawack.
 
-- Issue #13959: Make importlib.abc.FileLoader.load_module()/get_filename() and
+- bpo-13959: Make importlib.abc.FileLoader.load_module()/get_filename() and
   importlib.machinery.ExtensionFileLoader.load_module() have their single
   argument be optional. Allows for the replacement (and thus deprecation) of
   imp.load_source()/load_package()/load_compiled().
 
-- Issue #13959: imp.get_suffixes() has been deprecated in favour of the new
-  attributes on importlib.machinery: SOURCE_SUFFIXES, DEBUG_BYTECODE_SUFFIXES,
-  OPTIMIZED_BYTECODE_SUFFIXES, BYTECODE_SUFFIXES, and EXTENSION_SUFFIXES. This
-  led to an indirect deprecation of inspect.getmoduleinfo().
+- bpo-13959: imp.get_suffixes() has been deprecated in favour of the new
+  attributes on importlib.machinery: SOURCE_SUFFIXES,
+  DEBUG_BYTECODE_SUFFIXES, OPTIMIZED_BYTECODE_SUFFIXES, BYTECODE_SUFFIXES,
+  and EXTENSION_SUFFIXES. This led to an indirect deprecation of
+  inspect.getmoduleinfo().
 
-- Issue #14662: Prevent shutil failures on OS X when destination does not
+- bpo-14662: Prevent shutil failures on OS X when destination does not
   support chflag operations.  Patch by Hynek Schlawack.
 
-- Issue #14157: Fix time.strptime failing without a year on February 29th.
+- bpo-14157: Fix time.strptime failing without a year on February 29th.
   Patch by Hynek Schlawack.
 
-- Issue #14753: Make multiprocessing's handling of negative timeouts
-  the same as it was in Python 3.2.
+- bpo-14753: Make multiprocessing's handling of negative timeouts the same
+  as it was in Python 3.2.
 
-- Issue #14583: Fix importlib bug when a package's __init__.py would first
+- bpo-14583: Fix importlib bug when a package's __init__.py would first
   import one of its modules then raise an error.
 
-- Issue #14741: Fix missing support for Ellipsis ('...') in parser module.
+- bpo-14741: Fix missing support for Ellipsis ('...') in parser module.
 
-- Issue #14697: Fix missing support for set displays and set comprehensions in
+- bpo-14697: Fix missing support for set displays and set comprehensions in
   parser module.
 
-- Issue #14701: Fix missing support for 'raise ... from' in parser module.
+- bpo-14701: Fix missing support for 'raise ... from' in parser module.
 
-- Add support for timeouts to the acquire() methods of
-  multiprocessing's lock/semaphore/condition proxies.
+- Add support for timeouts to the acquire() methods of multiprocessing's
+  lock/semaphore/condition proxies.
 
-- Issue #13989: Add support for text mode to gzip.open().
+- bpo-13989: Add support for text mode to gzip.open().
 
-- Issue #14127: The os.stat() result object now provides three additional
-  fields: st_ctime_ns, st_mtime_ns, and st_atime_ns, providing those times as an
-  integer with nanosecond resolution.  The functions os.utime(), os.lutimes(),
-  and os.futimes() now accept a new parameter, ns, which accepts mtime and atime
-  as integers with nanosecond resolution.
+- bpo-14127: The os.stat() result object now provides three additional
+  fields: st_ctime_ns, st_mtime_ns, and st_atime_ns, providing those times
+  as an integer with nanosecond resolution.  The functions os.utime(),
+  os.lutimes(), and os.futimes() now accept a new parameter, ns, which
+  accepts mtime and atime as integers with nanosecond resolution.
 
-- Issue #14127 and #10148: shutil.copystat now preserves exact mtime and atime
-  on filesystems providing nanosecond resolution.
+- bpo-14127: shutil.copystat now preserves exact mtime and atime on
+  filesystems providing nanosecond resolution. (See also: bpo-10148)
 
 IDLE
 ----
 
-- Issue #14958: Change IDLE systax highlighting to recognize all string and
+- bpo-14958: Change IDLE systax highlighting to recognize all string and
   byte literals supported in Python 3.3.
 
-- Issue #10997: Prevent a duplicate entry in IDLE's "Recent Files" menu.
+- bpo-10997: Prevent a duplicate entry in IDLE's "Recent Files" menu.
 
-- Issue #14929: Stop IDLE 3.x from closing on Unicode decode errors when
+- bpo-14929: Stop IDLE 3.x from closing on Unicode decode errors when
   grepping. Patch by Roger Serwy.
 
-- Issue #12510: Attempting to get invalid tooltip no longer closes IDLE.
-  Other tooltipss have been corrected or improved and the number of tests
-  has been tripled. Original patch by Roger Serwy.
+- bpo-12510: Attempting to get invalid tooltip no longer closes IDLE. Other
+  tooltipss have been corrected or improved and the number of tests has been
+  tripled. Original patch by Roger Serwy.
 
 Tools/Demos
 -----------
 
-- Issue #14695: Bring Tools/parser/unparse.py support up to date with
-  the Python 3.3 Grammar.
+- bpo-14695: Bring Tools/parser/unparse.py support up to date with the
+  Python 3.3 Grammar.
 
 Build
 -----
 
-- Issue #14472: Update .gitignore. Patch by Matej Cepl.
+- bpo-14472: Update .gitignore. Patch by Matej Cepl.
 
 - Upgrade Windows library versions: bzip 1.0.6, OpenSSL 1.0.1c.
 
-- Issue #14693: Under non-Windows platforms, hashlib's fallback modules are
+- bpo-14693: Under non-Windows platforms, hashlib's fallback modules are
   always compiled, even if OpenSSL is present at build time.
 
-- Issue #13210: Windows build now uses VS2010, ported from VS2008.
+- bpo-13210: Windows build now uses VS2010, ported from VS2008.
 
-C-API
+C API
 -----
 
-- Issue #14705: The PyArg_Parse() family of functions now support the 'p' format
-  unit, which accepts a "boolean predicate" argument.  It converts any Python
-  value into an integer--0 if it is "false", and 1 otherwise.
+- bpo-14705: The PyArg_Parse() family of functions now support the 'p'
+  format unit, which accepts a "boolean predicate" argument.  It converts
+  any Python value into an integer--0 if it is "false", and 1 otherwise.
 
 Documentation
 -------------
 
-- Issue #14863: Update the documentation of os.fdopen() to reflect the
-  fact that it's only a thin wrapper around open() anymore.
+- bpo-14863: Update the documentation of os.fdopen() to reflect the fact
+  that it's only a thin wrapper around open() anymore.
 
-- Issue #14588: The language reference now accurately documents the Python 3
+- bpo-14588: The language reference now accurately documents the Python 3
   class definition process. Patch by Nick Coghlan.
 
-- Issue #14943: Correct a default argument value for winreg.OpenKey
-  and correctly list the argument names in the function's explanation.
+- bpo-14943: Correct a default argument value for winreg.OpenKey and
+  correctly list the argument names in the function's explanation.
 
 
-What's New in Python 3.3.0 Alpha 3?
+What's New in Python 3.3.0 alpha 3?
 ===================================
 
 *Release date: 01-May-2012*
@@ -7726,249 +7842,257 @@ What's New in Python 3.3.0 Alpha 3?
 Core and Builtins
 -----------------
 
-- Issue #14699: Fix calling the classmethod descriptor directly.
+- bpo-14699: Fix calling the classmethod descriptor directly.
 
-- Issue #14433: Prevent msvcrt crash in interactive prompt when stdin is closed.
+- bpo-14433: Prevent msvcrt crash in interactive prompt when stdin is
+  closed.
 
-- Issue #14521: Make result of float('nan') and float('-nan') more consistent
+- bpo-14521: Make result of float('nan') and float('-nan') more consistent
   across platforms.
 
-- Issue #14646: __import__() sets __loader__ if the loader did not.
+- bpo-14646: __import__() sets __loader__ if the loader did not.
 
-- Issue #14605: No longer have implicit entries in sys.meta_path. If
+- bpo-14605: No longer have implicit entries in sys.meta_path. If
   sys.meta_path is found to be empty, raise ImportWarning.
 
-- Issue #14605: No longer have implicit entries in sys.path_hooks. If
+- bpo-14605: No longer have implicit entries in sys.path_hooks. If
   sys.path_hooks is found to be empty, a warning will be raised. None is now
-  inserted into sys.path_importer_cache if no finder was discovered. This also
-  means imp.NullImporter is no longer implicitly used.
+  inserted into sys.path_importer_cache if no finder was discovered. This
+  also means imp.NullImporter is no longer implicitly used.
 
-- Issue #13903: Implement PEP 412. Individual dictionary instances can now share
-  their keys with other dictionaries. Classes take advantage of this to share
-  their instance dictionary keys for improved memory and performance.
+- bpo-13903: Implement PEP 412. Individual dictionary instances can now
+  share their keys with other dictionaries. Classes take advantage of this
+  to share their instance dictionary keys for improved memory and
+  performance.
 
-- Issue #11603 (again): Setting __repr__ to __str__ now raises a RuntimeError
-  when repr() or str() is called on such an object.
+- bpo-11603: Setting __repr__ to __str__ now raises a RuntimeError when
+  repr() or str() is called on such an object.
 
-- Issue #14658: Fix binding a special method to a builtin implementation of a
+- bpo-14658: Fix binding a special method to a builtin implementation of a
   special method with a different name.
 
-- Issue #14630: Fix a memory access bug for instances of a subclass of int
-  with value 0.
+- bpo-14630: Fix a memory access bug for instances of a subclass of int with
+  value 0.
 
-- Issue #14339: Speed improvements to bin, oct and hex functions.  Patch by
+- bpo-14339: Speed improvements to bin, oct and hex functions.  Patch by
   Serhiy Storchaka.
 
-- Issue #14385: It is now possible to use a custom type for the __builtins__
+- bpo-14385: It is now possible to use a custom type for the __builtins__
   namespace, instead of a dict. It can be used for sandboxing for example.
-  Raise also a NameError instead of ImportError if __build_class__ name if not
-  found in __builtins__.
+  Raise also a NameError instead of ImportError if __build_class__ name if
+  not found in __builtins__.
 
-- Issue #12599: Be more strict in accepting None compared to a false-like
+- bpo-12599: Be more strict in accepting None compared to a false-like
   object for importlib.util.module_for_loader and
   importlib.machinery.PathFinder.
 
-- Issue #14612: Fix jumping around with blocks by setting f_lineno.
+- bpo-14612: Fix jumping around with blocks by setting f_lineno.
 
-- Issue #14592: Attempting a relative import w/o __package__ or __name__ set in
+- bpo-14592: Attempting a relative import w/o __package__ or __name__ set in
   globals raises a KeyError.
 
-- Issue #14607: Fix keyword-only arguments which started with ``__``.
+- bpo-14607: Fix keyword-only arguments which started with ``__``.
 
-- Issue #10854: The ImportError raised when an extension module on Windows
-  fails to import now uses the new path and name attributes from
-  Issue #1559549.
+- bpo-10854: The ImportError raised when an extension module on Windows
+  fails to import now uses the new path and name attributes from Issue
+  #1559549.
 
-- Issue #13889: Check and (if necessary) set FPU control word before calling
+- bpo-13889: Check and (if necessary) set FPU control word before calling
   any of the dtoa.c string <-> float conversion functions, on MSVC builds of
-  Python.  This fixes issues when embedding Python in a Delphi app.
+  Python. This fixes issues when embedding Python in a Delphi app.
 
-- __import__() now matches PEP 328 and documentation by defaulting 'index' to 0
-  instead of -1 and removing support for negative values.
+- __import__() now matches PEP 328 and documentation by defaulting 'index'
+  to 0 instead of -1 and removing support for negative values.
 
-- Issue #2377: Make importlib the implementation of __import__().
+- bpo-2377: Make importlib the implementation of __import__().
 
-- Issue #1559549: ImportError now has 'name' and 'path' attributes that are set
+- bpo-1559549: ImportError now has 'name' and 'path' attributes that are set
   using keyword arguments to its constructor. They are currently not set by
   import as they are meant for use by importlib.
 
-- Issue #14474: Save and restore exception state in thread.start_new_thread()
+- bpo-14474: Save and restore exception state in thread.start_new_thread()
   while writing error message if the thread leaves a unhandled exception.
 
-- Issue #13019: Fix potential reference leaks in bytearray.extend().  Patch
-  by Suman Saha.
+- bpo-13019: Fix potential reference leaks in bytearray.extend().  Patch by
+  Suman Saha.
 
 Library
 -------
 
-- Issue #14768: os.path.expanduser('~/a') doesn't works correctly when HOME is '/'.
+- bpo-14768: os.path.expanduser('~/a') doesn't works correctly when HOME is
+  '/'.
 
-- Issue #14371: Support bzip2 in zipfile module.  Patch by Serhiy Storchaka.
+- bpo-14371: Support bzip2 in zipfile module.  Patch by Serhiy Storchaka.
 
-- Issue #13183: Fix pdb skipping frames after hitting a breakpoint and running
+- bpo-13183: Fix pdb skipping frames after hitting a breakpoint and running
   step.  Patch by Xavier de Gaye.
 
-- Issue #14696: Fix parser module to understand 'nonlocal' declarations.
+- bpo-14696: Fix parser module to understand 'nonlocal' declarations.
 
-- Issue #10941: Fix imaplib.Internaldate2tuple to produce correct result near
+- bpo-10941: Fix imaplib.Internaldate2tuple to produce correct result near
   the DST transition.  Patch by Joe Peterson.
 
-- Issue #9154: Fix parser module to understand function annotations.
+- bpo-9154: Fix parser module to understand function annotations.
 
-- Issue #6085: In http.server.py SimpleHTTPServer.address_string returns the
-  client ip address instead client hostname. Patch by Charles-François Natali.
+- bpo-6085: In http.server.py SimpleHTTPServer.address_string returns the
+  client ip address instead client hostname. Patch by Charles-François
+  Natali.
 
-- Issue #14309: Deprecate time.clock(), use time.perf_counter() or
+- bpo-14309: Deprecate time.clock(), use time.perf_counter() or
   time.process_time() instead.
 
-- Issue #14428: Implement the PEP 418. Add time.get_clock_info(),
+- bpo-14428: Implement the PEP 418. Add time.get_clock_info(),
   time.perf_counter() and time.process_time() functions, and rename
   time.steady() to time.monotonic().
 
-- Issue #14646: importlib.util.module_for_loader() now sets __loader__ and
+- bpo-14646: importlib.util.module_for_loader() now sets __loader__ and
   __package__ (when possible).
 
-- Issue #14664: It is now possible to use @unittest.skip{If,Unless} on a
-  test class that doesn't inherit from TestCase (i.e. a mixin).
+- bpo-14664: It is now possible to use @unittest.skip{If,Unless} on a test
+  class that doesn't inherit from TestCase (i.e. a mixin).
 
-- Issue #4892: multiprocessing Connections can now be transferred over
+- bpo-4892: multiprocessing Connections can now be transferred over
   multiprocessing Connections.  Patch by Richard Oudkerk (sbt).
 
-- Issue #14160: TarFile.extractfile() failed to resolve symbolic links when
-  the links were not located in an archive subdirectory.
+- bpo-14160: TarFile.extractfile() failed to resolve symbolic links when the
+  links were not located in an archive subdirectory.
 
-- Issue #14638: pydoc now treats non-string __name__ values as if they
-  were missing, instead of raising an error.
+- bpo-14638: pydoc now treats non-string __name__ values as if they were
+  missing, instead of raising an error.
 
-- Issue #13684: Fix httplib tunnel issue of infinite loops for certain sites
+- bpo-13684: Fix httplib tunnel issue of infinite loops for certain sites
   which send EOF without trailing \r\n.
 
-- Issue #14605: Add importlib.abc.FileLoader, importlib.machinery.(FileFinder,
+- bpo-14605: Add importlib.abc.FileLoader, importlib.machinery.(FileFinder,
   SourceFileLoader, SourcelessFileLoader, ExtensionFileLoader).
 
-- Issue #13959: imp.cache_from_source()/source_from_cache() now follow
-  os.path.join()/split() semantics for path manipulation instead of its prior,
-  custom semantics of caring the right-most path separator forward in path
-  joining.
+- bpo-13959: imp.cache_from_source()/source_from_cache() now follow
+  os.path.join()/split() semantics for path manipulation instead of its
+  prior, custom semantics of caring the right-most path separator forward in
+  path joining.
 
-- Issue #2193: Allow ":" character in Cookie NAME values.
+- bpo-2193: Allow ":" character in Cookie NAME values.
 
-- Issue #14629: tokenizer.detect_encoding will specify the filename in the
+- bpo-14629: tokenizer.detect_encoding will specify the filename in the
   SyntaxError exception if found at readline.__self__.name.
 
-- Issue #14629: Raise SyntaxError in tokenizer.detect_encoding if the
-  first two lines have non-UTF-8 characters without an encoding declaration.
+- bpo-14629: Raise SyntaxError in tokenizer.detect_encoding if the first two
+  lines have non-UTF-8 characters without an encoding declaration.
 
-- Issue #14308: Fix an exception when a "dummy" thread is in the threading
+- bpo-14308: Fix an exception when a "dummy" thread is in the threading
   module's active list after a fork().
 
-- Issue #11750: The Windows API functions scattered in the _subprocess and
+- bpo-11750: The Windows API functions scattered in the _subprocess and
   _multiprocessing.win32 modules now live in a single module "_winapi".
   Patch by sbt.
 
-- Issue #14087: multiprocessing: add Condition.wait_for(). Patch by sbt.
+- bpo-14087: multiprocessing: add Condition.wait_for(). Patch by sbt.
 
-- Issue #14538: HTMLParser can now parse correctly start tags that contain
-  bare '/'.
+- bpo-14538: HTMLParser can now parse correctly start tags that contain a
+  bare '/'.
 
-- Issue #14452: SysLogHandler no longer inserts a UTF-8 BOM into the message.
+- bpo-14452: SysLogHandler no longer inserts a UTF-8 BOM into the message.
 
-- Issue #14386: Expose the dict_proxy internal type as types.MappingProxyType.
+- bpo-14386: Expose the dict_proxy internal type as types.MappingProxyType.
 
-- Issue #13959: Make imp.reload() always use a module's __loader__ to perform
+- bpo-13959: Make imp.reload() always use a module's __loader__ to perform
   the reload.
 
-- Issue #13959: Add imp.py and rename the built-in module to _imp, allowing for
-  re-implementing parts of the module in pure Python.
+- bpo-13959: Add imp.py and rename the built-in module to _imp, allowing for
+  re- implementing parts of the module in pure Python.
 
-- Issue #13496: Fix potential overflow in bisect.bisect algorithm when applied
+- bpo-13496: Fix potential overflow in bisect.bisect algorithm when applied
   to a collection of size > sys.maxsize / 2.
 
 - Have importlib take advantage of ImportError's new 'name' and 'path'
   attributes.
 
-- Issue #14399: zipfile now recognizes that the archive has been modified even
-  if only the comment is changed.  In addition, the TypeError that results from
-  trying to set a non-binary value as a comment is now raised at the time
-  the comment is set rather than at the time the zipfile is written.
+- bpo-14399: zipfile now recognizes that the archive has been modified even
+  if only the comment is changed.  In addition, the TypeError that results
+  from trying to set a non-binary value as a comment is now raised at the
+  time the comment is set rather than at the time the zipfile is written.
 
-- trace.CoverageResults.is_ignored_filename() now ignores any name that starts
-  with "<" and ends with ">" instead of special-casing "<string>" and
+- trace.CoverageResults.is_ignored_filename() now ignores any name that
+  starts with "<" and ends with ">" instead of special-casing "<string>" and
   "<doctest ".
 
-- Issue #12537: The mailbox module no longer depends on knowledge of internal
+- bpo-12537: The mailbox module no longer depends on knowledge of internal
   implementation details of the email package Message object.
 
-- Issue #7978: socketserver now restarts the select() call when EINTR is
+- bpo-7978: socketserver now restarts the select() call when EINTR is
   returned.  This avoids crashing the server loop when a signal is received.
   Patch by Jerzy Kozera.
 
-- Issue #14522: Avoid duplicating socket handles in multiprocessing.connection.
+- bpo-14522: Avoid duplicating socket handles in multiprocessing.connection.
   Patch by sbt.
 
 - Don't Py_DECREF NULL variable in io.IncrementalNewlineDecoder.
 
-- Issue #3033: Add displayof parameter to tkinter font. Patch by Guilherme Polo.
+- bpo-3033: Add displayof parameter to tkinter font. Patch by Guilherme
+  Polo.
 
-- Issue #14482: Raise a ValueError, not a NameError, when trying to create
-  multiprocessing Client or Listener with an AF_UNIX type address under
+- bpo-14482: Raise a ValueError, not a NameError, when trying to create a
+  multiprocessing Client or Listener with an AF_UNIX type address under
   Windows.  Patch by Popa Claudiu.
 
-- Issue #802310: Generate always unique tkinter font names if not directly passed.
+- bpo-802310: Generate always unique tkinter font names if not directly
+  passed.
 
-- Issue #14151: Raise a ValueError, not a NameError, when trying to create
-  a multiprocessing Client or Listener with an AF_PIPE type address under
-  non-Windows platforms.  Patch by Popa Claudiu.
+- bpo-14151: Raise a ValueError, not a NameError, when trying to create a
+  multiprocessing Client or Listener with an AF_PIPE type address under non-
+  Windows platforms. Patch by Popa Claudiu.
 
-- Issue #14493: Use gvfs-open or xdg-open in webbrowser.
+- bpo-14493: Use gvfs-open or xdg-open in webbrowser.
 
 Build
 -----
 
-- "make touch" will now touch generated files that are checked into Mercurial,
-  after a "hg update" which failed to bring the timestamps into the right order.
+- "make touch" will now touch generated files that are checked into
+  Mercurial, after a "hg update" which failed to bring the timestamps into
+  the right order.
 
 Tests
 -----
 
-- Issue #14026: In test_cmd_line_script, check that sys.argv is populated
+- bpo-14026: In test_cmd_line_script, check that sys.argv is populated
   correctly for the various invocation approaches (Patch by Jason Yeo)
 
-- Issue #14032: Fix incorrect variable name in test_cmd_line_script debugging
+- bpo-14032: Fix incorrect variable name in test_cmd_line_script debugging
   message (Patch by Jason Yeo)
 
-- Issue #14589: Update certificate chain for sha256.tbs-internet.com, fixing
-  test failure in test_ssl.
+- bpo-14589: Update certificate chain for sha256.tbs-internet.com, fixing a
+  test failure in test_ssl.
 
-- Issue #14355: Regrtest now supports the standard unittest test loading, and
+- bpo-14355: Regrtest now supports the standard unittest test loading, and
   will use it if a test file contains no `test_main` method.
 
 IDLE
 ----
 
-- Issue #8515: Set __file__ when run file in IDLE.
-  Initial patch by Bruce Frederiksen.
+- bpo-8515: Set __file__ when run file in IDLE. Initial patch by Bruce
+  Frederiksen.
 
-- Issue #14496: Fix wrong name in idlelib/tabbedpages.py.
-  Patch by Popa Claudiu.
+- bpo-14496: Fix wrong name in idlelib/tabbedpages.py. Patch by Popa
+  Claudiu.
 
-Tools / Demos
--------------
+Tools/Demos
+-----------
 
-- Issue #3561: The Windows installer now has an option, off by default, for
-  placing the Python installation into the system "Path" environment variable.
+- bpo-3561: The Windows installer now has an option, off by default, for
+  placing the Python installation into the system "Path" environment
+  variable.
 
-- Issue #13165: stringbench is now available in the Tools/stringbench folder.
+- bpo-13165: stringbench is now available in the Tools/stringbench folder.
   It used to live in its own SVN project.
 
-C-API
+C API
 -----
 
-- Issue #14098: New functions PyErr_GetExcInfo and PyErr_SetExcInfo.
-  Patch by Stefan Behnel.
+- bpo-14098: New functions PyErr_GetExcInfo and PyErr_SetExcInfo. Patch by
+  Stefan Behnel.
 
 
-What's New in Python 3.3.0 Alpha 2?
+What's New in Python 3.3.0 alpha 2?
 ===================================
 
 *Release date: 01-Apr-2012*
@@ -7976,226 +8100,228 @@ What's New in Python 3.3.0 Alpha 2?
 Core and Builtins
 -----------------
 
-- Issue #1683368: object.__new__ and object.__init__ raise a TypeError if they
+- bpo-1683368: object.__new__ and object.__init__ raise a TypeError if they
   are passed arguments and their complementary method is not overridden.
 
-- Issue #14378: Fix compiling ast.ImportFrom nodes with a "__future__" string as
-  the module name that was not interned.
+- bpo-14378: Fix compiling ast.ImportFrom nodes with a "__future__" string
+  as the module name that was not interned.
 
-- Issue #14331: Use significantly less stack space when importing modules by
+- bpo-14331: Use significantly less stack space when importing modules by
   allocating path buffers on the heap instead of the stack.
 
-- Issue #14334: Prevent in a segfault in type.__getattribute__ when it was not
+- bpo-14334: Prevent in a segfault in type.__getattribute__ when it was not
   passed strings.
 
-- Issue #1469629: Allow cycles through an object's __dict__ slot to be
+- bpo-1469629: Allow cycles through an object's __dict__ slot to be
   collected. (For example if ``x.__dict__ is x``).
 
-- Issue #14205: dict lookup raises a RuntimeError if the dict is modified
+- bpo-14205: dict lookup raises a RuntimeError if the dict is modified
   during a lookup.
 
-- Issue #14220: When a generator is delegating to another iterator with the
+- bpo-14220: When a generator is delegating to another iterator with the
   yield from syntax, it needs to have its ``gi_running`` flag set to True.
 
-- Issue #14435: Remove dedicated block allocator from floatobject.c and rely
-  on the PyObject_Malloc() api like all other objects.
+- bpo-14435: Remove dedicated block allocator from floatobject.c and rely on
+  the PyObject_Malloc() api like all other objects.
 
-- Issue #14471: Fix a possible buffer overrun in the winreg module.
+- bpo-14471: Fix a possible buffer overrun in the winreg module.
 
-- Issue #14288: Allow the serialization of builtin iterators
+- bpo-14288: Allow the serialization of builtin iterators
 
 Library
 -------
 
-- Issue #14300: Under Windows, sockets created using socket.dup() now allow
-  overlapped I/O.  Patch by sbt.
+- bpo-14300: Under Windows, sockets created using socket.dup() now allow
+  overlapped I/O. Patch by sbt.
 
-- Issue #13872: socket.detach() now marks the socket closed (as mirrored
-  in the socket repr()).  Patch by Matt Joiner.
+- bpo-13872: socket.detach() now marks the socket closed (as mirrored in the
+  socket repr()).  Patch by Matt Joiner.
 
-- Issue #14406: Fix a race condition when using ``concurrent.futures.wait(
+- bpo-14406: Fix a race condition when using ``concurrent.futures.wait(
   return_when=ALL_COMPLETED)``.  Patch by Matt Joiner.
 
-- Issue #5136: deprecate old, unused functions from tkinter.
+- bpo-5136: deprecate old, unused functions from tkinter.
 
-- Issue #14416: syslog now defines the LOG_ODELAY and LOG_AUTHPRIV constants
-  if they are defined in <syslog.h>.
+- bpo-14416: syslog now defines the LOG_ODELAY and LOG_AUTHPRIV constants if
+  they are defined in <syslog.h>.
 
-- Issue #14295: Add unittest.mock
+- bpo-14295: Add unittest.mock
 
-- Issue #7652: Add --with-system-libmpdec option to configure for linking
-  the _decimal module against an installed libmpdec.
+- bpo-7652: Add --with-system-libmpdec option to configure for linking the
+  _decimal module against an installed libmpdec.
 
-- Issue #14380: MIMEText now defaults to utf-8 when passed non-ASCII unicode
+- bpo-14380: MIMEText now defaults to utf-8 when passed non-ASCII unicode
   with no charset specified.
 
-- Issue #10340: asyncore - properly handle EINVAL in dispatcher constructor on
+- bpo-10340: asyncore - properly handle EINVAL in dispatcher constructor on
   OSX; avoid to call handle_connect in case of a disconnected socket which
   was not meant to connect.
 
-- Issue #14204: The ssl module now has support for the Next Protocol
+- bpo-14204: The ssl module now has support for the Next Protocol
   Negotiation extension, if available in the underlying OpenSSL library.
   Patch by Colin Marc.
 
-- Issue #3035: Unused functions from tkinter are marked as pending deprecated.
+- bpo-3035: Unused functions from tkinter are marked as pending deprecated.
 
-- Issue #12757: Fix the skipping of doctests when python is run with -OO so
+- bpo-12757: Fix the skipping of doctests when python is run with -OO so
   that it works in unittest's verbose mode as well as non-verbose mode.
 
-- Issue #7652: Integrate the decimal floating point libmpdec library to speed
+- bpo-7652: Integrate the decimal floating point libmpdec library to speed
   up the decimal module. Performance gains of the new C implementation are
   between 10x and 100x, depending on the application.
 
-- Issue #14269: SMTPD now conforms to the RFC and requires a HELO command
+- bpo-14269: SMTPD now conforms to the RFC and requires a HELO command
   before MAIL, RCPT, or DATA.
 
-- Issue #13694: asynchronous connect in asyncore.dispatcher does not set addr
+- bpo-13694: asynchronous connect in asyncore.dispatcher does not set addr
   attribute.
 
-- Issue #14344: fixed the repr of email.policy objects.
+- bpo-14344: fixed the repr of email.policy objects.
 
-- Issue #11686: Added missing entries to email package __all__ lists
-  (mostly the new Bytes classes).
+- bpo-11686: Added missing entries to email package __all__ lists (mostly
+  the new Bytes classes).
 
-- Issue #14335: multiprocessing's custom Pickler subclass now inherits from
-  the C-accelerated implementation.  Patch by sbt.
+- bpo-14335: multiprocessing's custom Pickler subclass now inherits from the
+  C-accelerated implementation.  Patch by sbt.
 
-- Issue #10484: Fix the CGIHTTPServer's PATH_INFO handling problem.
+- bpo-10484: Fix the CGIHTTPServer's PATH_INFO handling problem.
 
-- Issue #11199: Fix the with urllib which hangs on particular ftp urls.
+- bpo-11199: Fix the with urllib which hangs on particular ftp urls.
 
 - Improve the memory utilization and speed of functools.lru_cache.
 
-- Issue #14222: Use the new time.steady() function instead of time.time() for
+- bpo-14222: Use the new time.steady() function instead of time.time() for
   timeout in queue and threading modules to not be affected of system time
   update.
 
-- Issue #13248: Remove lib2to3.pytree.Base.get_prefix/set_prefix.
+- bpo-13248: Remove lib2to3.pytree.Base.get_prefix/set_prefix.
 
-- Issue #14234: CVE-2012-0876: Randomize hashes of xml attributes in the hash
-  table internal to the pyexpat module's copy of the expat library to avoid a
-  denial of service due to hash collisions.  Patch by David Malcolm with some
-  modifications by the expat project.
+- bpo-14234: CVE-2012-0876: Randomize hashes of xml attributes in the hash
+  table internal to the pyexpat module's copy of the expat library to avoid
+  a denial of service due to hash collisions.  Patch by David Malcolm with
+  some modifications by the expat project.
 
-- Issue #12818: format address no longer needlessly \ escapes ()s in names when
+- bpo-12818: format address no longer needlessly \ escapes ()s in names when
   the name ends up being quoted.
 
-- Issue #14062: BytesGenerator now correctly folds Header objects,
-  including using linesep when folding.
+- bpo-14062: BytesGenerator now correctly folds Header objects, including
+  using linesep when folding.
 
-- Issue #13839: When invoked on the command-line, the pstats module now
-  accepts several filenames of profile stat files and merges them all.
-  Patch by Matt Joiner.
+- bpo-13839: When invoked on the command-line, the pstats module now accepts
+  several filenames of profile stat files and merges them all. Patch by Matt
+  Joiner.
 
-- Issue #14291: Email now defaults to utf-8 for non-ASCII unicode headers
+- bpo-14291: Email now defaults to utf-8 for non-ASCII unicode headers
   instead of raising an error.  This fixes a regression relative to 2.7.
 
-- Issue #989712: Support using Tk without a mainloop.
+- bpo-989712: Support using Tk without a mainloop.
 
-- Issue #3835: Refuse to use unthreaded Tcl in threaded Python.
+- bpo-3835: Refuse to use unthreaded Tcl in threaded Python.
 
-- Issue #2843: Add new Tk API to Tkinter.
+- bpo-2843: Add new Tk API to Tkinter.
 
-- Issue #14184: Increase the default stack size for secondary threads on
-  Mac OS X to avoid interpreter crashes when using threads on 10.7.
+- bpo-14184: Increase the default stack size for secondary threads on Mac OS
+  X to avoid interpreter crashes when using threads on 10.7.
 
-- Issue #14180: datetime.date.fromtimestamp(),
+- bpo-14180: datetime.date.fromtimestamp(),
   datetime.datetime.fromtimestamp() and datetime.datetime.utcfromtimestamp()
-  now raise an OSError instead of ValueError if localtime() or gmtime() failed.
+  now raise an OSError instead of ValueError if localtime() or gmtime()
+  failed.
 
-- Issue #14180: time.ctime(), gmtime(), time.localtime(),
+- bpo-14180: time.ctime(), gmtime(), time.localtime(),
   datetime.date.fromtimestamp(), datetime.datetime.fromtimestamp() and
-  datetime.datetime.utcfromtimestamp() now raises an OverflowError, instead of
-  a ValueError, if the timestamp does not fit in time_t.
+  datetime.datetime.utcfromtimestamp() now raises an OverflowError, instead
+  of a ValueError, if the timestamp does not fit in time_t.
 
-- Issue #14180: datetime.datetime.fromtimestamp() and
+- bpo-14180: datetime.datetime.fromtimestamp() and
   datetime.datetime.utcfromtimestamp() now round microseconds towards zero
   instead of rounding to nearest with ties going away from zero.
 
-- Issue #10543: Fix unittest test discovery with Jython bytecode files.
+- bpo-10543: Fix unittest test discovery with Jython bytecode files.
 
-- Issue #1178863: Separate initialisation from setting when initializing
-  Tkinter.Variables; harmonize exceptions to ValueError; only delete variables
-  that have not been deleted; assert that variable names are strings.
+- bpo-1178863: Separate initialisation from setting when initializing
+  Tkinter.Variables; harmonize exceptions to ValueError; only delete
+  variables that have not been deleted; assert that variable names are
+  strings.
 
-- Issue #14104: Implement time.monotonic() on Mac OS X, patch written by
+- bpo-14104: Implement time.monotonic() on Mac OS X, patch written by
   Nicholas Riley.
 
-- Issue #13394: the aifc module now uses warnings.warn() to signal warnings.
+- bpo-13394: the aifc module now uses warnings.warn() to signal warnings.
 
-- Issue #14252: Fix subprocess.Popen.terminate() to not raise an error under
+- bpo-14252: Fix subprocess.Popen.terminate() to not raise an error under
   Windows when the child process has already exited.
 
-- Issue #14223: curses.addch() is no more limited to the range 0-255 when the
+- bpo-14223: curses.addch() is no more limited to the range 0-255 when the
   Python curses is not linked to libncursesw. It was a regression introduced
   in Python 3.3a1.
 
-- Issue #14168: Check for presence of Element._attrs in minidom before
+- bpo-14168: Check for presence of Element._attrs in minidom before
   accessing it.
 
-- Issue #12328: Fix multiprocessing's use of overlapped I/O on Windows.
-  Also, add a multiprocessing.connection.wait(rlist, timeout=None) function
-  for polling multiple objects at once.  Patch by sbt.
+- bpo-12328: Fix multiprocessing's use of overlapped I/O on Windows. Also,
+  add a multiprocessing.connection.wait(rlist, timeout=None) function for
+  polling multiple objects at once.  Patch by sbt.
 
-- Issue #14007: Accept incomplete TreeBuilder objects (missing start, end,
-  data or close method) for the Python implementation as well.
-  Drop the no-op TreeBuilder().xml() method from the C implementation.
+- bpo-14007: Accept incomplete TreeBuilder objects (missing start, end, data
+  or close method) for the Python implementation as well. Drop the no-op
+  TreeBuilder().xml() method from the C implementation.
 
-- Issue #14210: pdb now has tab-completion not only for command names, but
-  also for their arguments, wherever possible.
+- bpo-14210: pdb now has tab-completion not only for command names, but also
+  for their arguments, wherever possible.
 
-- Issue #14310: Sockets can now be with other processes on Windows using
-  the api socket.socket.share() and socket.fromshare().
+- bpo-14310: Sockets can now be with other processes on Windows using the
+  api socket.socket.share() and socket.fromshare().
 
-- Issue #10576: The gc module now has a 'callbacks' member that will get
-  called when garbage collection takes place.
+- bpo-10576: The gc module now has a 'callbacks' member that will get called
+  when garbage collection takes place.
 
 Build
 -----
 
-- Issue #14557: Fix extensions build on HP-UX. Patch by Adi Roiban.
+- bpo-14557: Fix extensions build on HP-UX. Patch by Adi Roiban.
 
-- Issue #14387: Do not include accu.h from Python.h.
+- bpo-14387: Do not include accu.h from Python.h.
 
-- Issue #14359: Only use O_CLOEXEC in _posixmodule.c if it is defined.
-  Based on patch from Hervé Coatanhay.
+- bpo-14359: Only use O_CLOEXEC in _posixmodule.c if it is defined. Based on
+  patch from Hervé Coatanhay.
 
-- Issue #14321: Do not run pgen during the build if files are up to date.
+- bpo-14321: Do not run pgen during the build if files are up to date.
 
 Documentation
 -------------
 
-- Issue #14034: added the argparse tutorial.
+- bpo-14034: added the argparse tutorial.
 
-- Issue #14324: Fix configure tests for cross builds.
+- bpo-14324: Fix configure tests for cross builds.
 
-- Issue #14327: Call AC_CANONICAL_HOST in configure.ac and check in
+- bpo-14327: Call AC_CANONICAL_HOST in configure.ac and check in
   config.{guess,sub}. Don't use uname calls for cross builds.
 
-Extension Modules
------------------
+Library
+-------
 
-- Issue #9041: An issue in ctypes.c_longdouble, ctypes.c_double, and
+- bpo-9041: An issue in ctypes.c_longdouble, ctypes.c_double, and
   ctypes.c_float that caused an incorrect exception to be returned in the
   case of overflow has been fixed.
 
-- Issue #14212: The re module didn't retain a reference to buffers it was
+- bpo-14212: The re module didn't retain a reference to buffers it was
   scanning, resulting in segfaults.
 
-- Issue #14259: The finditer() method of re objects did not take any
-  keyword arguments, contrary to the documentation.
+- bpo-14259: The finditer() method of re objects did not take any keyword
+  arguments, contrary to the documentation.
 
-- Issue #10142: Support for SEEK_HOLE/SEEK_DATA (for example, under ZFS).
+- bpo-10142: Support for SEEK_HOLE/SEEK_DATA (for example, under ZFS).
 
 Tests
 -----
 
-- Issue #14442: Add missing errno import in test_smtplib.
+- bpo-14442: Add missing errno import in test_smtplib.
 
-- Issue #8315: (partial fix) python -m unittest test.test_email now works.
+- bpo-8315: (partial fix) python -m unittest test.test_email now works.
 
 
-What's New in Python 3.3.0 Alpha 1?
+What's New in Python 3.3.0 alpha 1?
 ===================================
 
 *Release date: 05-Mar-2012*
@@ -8203,96 +8329,97 @@ What's New in Python 3.3.0 Alpha 1?
 Core and Builtins
 -----------------
 
-- Issue #14172: Fix reference leak when marshalling a buffer-like object
-  (other than a bytes object).
+- bpo-14172: Fix reference leak when marshalling a buffer-like object (other
+  than a bytes object).
 
-- Issue #13521: dict.setdefault() now does only one lookup for the given key,
+- bpo-13521: dict.setdefault() now does only one lookup for the given key,
   making it "atomic" for many purposes.  Patch by Filip Gruszczyński.
 
 - PEP 409, Issue #6210: "raise X from None" is now supported as a means of
   suppressing the display of the chained exception context. The chained
   context still remains available as the __context__ attribute.
 
-- Issue #10181: New memoryview implementation fixes multiple ownership
-  and lifetime issues of dynamically allocated Py_buffer members (#9990)
-  as well as crashes (#8305, #7433). Many new features have been added
-  (See whatsnew/3.3), and the documentation has been updated extensively.
-  The ndarray test object from _testbuffer.c implements all aspects of
-  PEP-3118, so further development towards the complete implementation
-  of the PEP can proceed in a test-driven manner.
+- bpo-10181: New memoryview implementation fixes multiple ownership and
+  lifetime issues of dynamically allocated Py_buffer members (#9990) as well
+  as crashes (#8305, #7433). Many new features have been added (See
+  whatsnew/3.3), and the documentation has been updated extensively. The
+  ndarray test object from _testbuffer.c implements all aspects of PEP-3118,
+  so further development towards the complete implementation of the PEP can
+  proceed in a test-driven manner.
 
-  Thanks to Nick Coghlan, Antoine Pitrou and Pauli Virtanen for review
-  and many ideas.
+  Thanks to Nick Coghlan, Antoine Pitrou and Pauli Virtanen for review and
+  many ideas.
 
-- Issue #12834: Fix incorrect results of memoryview.tobytes() for
-  non-contiguous arrays.
+- bpo-12834: Fix incorrect results of memoryview.tobytes() for non-
+  contiguous arrays.
 
-- Issue #5231: Introduce memoryview.cast() method that allows changing
-  format and shape without making a copy of the underlying memory.
+- bpo-5231: Introduce memoryview.cast() method that allows changing format
+  and shape without making a copy of the underlying memory.
 
-- Issue #14084: Fix a file descriptor leak when importing a module with a
-  bad encoding.
+- bpo-14084: Fix a file descriptor leak when importing a module with a bad
+  encoding.
 
 - Upgrade Unicode data to Unicode 6.1.
 
-- Issue #14040: Remove rarely used file name suffixes for C extensions
-  (under POSIX mainly).
+- bpo-14040: Remove rarely used file name suffixes for C extensions (under
+  POSIX mainly).
 
-- Issue #14051: Allow arbitrary attributes to be set of classmethod and
+- bpo-14051: Allow arbitrary attributes to be set of classmethod and
   staticmethod.
 
-- Issue #13703: oCERT-2011-003: Randomize hashes of str and bytes to protect
-  against denial of service attacks due to hash collisions within the dict and
-  set types.  Patch by David Malcolm, based on work by Victor Stinner.
+- bpo-13703: oCERT-2011-003: Randomize hashes of str and bytes to protect
+  against denial of service attacks due to hash collisions within the dict
+  and set types. Patch by David Malcolm, based on work by Victor Stinner.
 
-- Issue #13020: Fix a reference leak when allocating a structsequence object
+- bpo-13020: Fix a reference leak when allocating a structsequence object
   fails.  Patch by Suman Saha.
 
-- Issue #13908: Ready types returned from PyType_FromSpec.
+- bpo-13908: Ready types returned from PyType_FromSpec.
 
-- Issue #11235: Fix OverflowError when trying to import a source file whose
+- bpo-11235: Fix OverflowError when trying to import a source file whose
   modification time doesn't fit in a 32-bit timestamp.
 
-- Issue #12705: A SyntaxError exception is now raised when attempting to
+- bpo-12705: A SyntaxError exception is now raised when attempting to
   compile multiple statements as a single interactive statement.
 
 - Fix the builtin module initialization code to store the init function for
   future reinitialization.
 
-- Issue #8052: The posix subprocess module would take a long time closing
-  all possible file descriptors in the child process rather than just open
-  file descriptors.  It now closes only the open fds if possible for the
-  default close_fds=True behavior.
+- bpo-8052: The posix subprocess module would take a long time closing all
+  possible file descriptors in the child process rather than just open file
+  descriptors.  It now closes only the open fds if possible for the default
+  close_fds=True behavior.
 
-- Issue #13629: Renumber the tokens in token.h so that they match the indexes
+- bpo-13629: Renumber the tokens in token.h so that they match the indexes
   into _PyParser_TokenNames.
 
-- Issue #13752: Add a casefold() method to str.
+- bpo-13752: Add a casefold() method to str.
 
-- Issue #13761: Add a "flush" keyword argument to the print() function,
-  used to ensure flushing the output stream.
+- bpo-13761: Add a "flush" keyword argument to the print() function, used to
+  ensure flushing the output stream.
 
-- Issue #13645: pyc files now contain the size of the corresponding source
+- bpo-13645: pyc files now contain the size of the corresponding source
   code, to avoid timestamp collisions (especially on filesystems with a low
   timestamp resolution) when checking for freshness of the bytecode.
 
 - PEP 380, Issue #11682: Add "yield from <x>" to support easy delegation to
-  subgenerators (initial patch by Greg Ewing, integration into 3.3 by
-  Renaud Blanch, Ryan Kelly, Zbigniew Jędrzejewski-Szmek and Nick Coghlan)
+  subgenerators (initial patch by Greg Ewing, integration into 3.3 by Renaud
+  Blanch, Ryan Kelly, Zbigniew Jędrzejewski-Szmek and Nick Coghlan)
 
-- Issue #13748: Raw bytes literals can now be written with the ``rb`` prefix
-  as well as ``br``.
+- bpo-13748: Raw bytes literals can now be written with the ``rb`` prefix as
+  well as ``br``.
 
-- Issue #12736: Use full unicode case mappings for upper, lower, and title case.
+- bpo-12736: Use full unicode case mappings for upper, lower, and title
+  case.
 
-- Issue #12760: Add a create mode to open(). Patch by David Townshend.
+- bpo-12760: Add a create mode to open(). Patch by David Townshend.
 
-- Issue #13738: Simplify implementation of bytes.lower() and bytes.upper().
+- bpo-13738: Simplify implementation of bytes.lower() and bytes.upper().
 
-- Issue #13577: Built-in methods and functions now have a __qualname__.
-  Patch by sbt.
+- bpo-13577: Built-in methods and functions now have a __qualname__. Patch
+  by sbt.
 
-- Issue #6695: Full garbage collection runs now clear the freelist of set
+- bpo-6695: Full garbage collection runs now clear the freelist of set
   objects.  Initial patch by Matthias Troffaes.
 
 - Fix OSError.__init__ and OSError.__new__ so that each of them can be
@@ -8302,109 +8429,110 @@ Core and Builtins
   effect of appearing to resolve the issue.  Thanks to Mark Shannon for
   noticing.
 
-- Issue #13505: Pickle bytes objects in a way that is compatible with
-  Python 2 when using protocols <= 2.
+- bpo-13505: Pickle bytes objects in a way that is compatible with Python 2
+  when using protocols <= 2.
 
-- Issue #11147: Fix an unused argument in _Py_ANNOTATE_MEMORY_ORDER.  (Fix
+- bpo-11147: Fix an unused argument in _Py_ANNOTATE_MEMORY_ORDER.  (Fix
   given by Campbell Barton).
 
-- Issue #13503: Use a more efficient reduction format for bytearrays with
-  pickle protocol >= 3.  The old reduction format is kept with older protocols
-  in order to allow unpickling under Python 2.  Patch by Irmen de Jong.
+- bpo-13503: Use a more efficient reduction format for bytearrays with
+  pickle protocol >= 3.  The old reduction format is kept with older
+  protocols in order to allow unpickling under Python 2.  Patch by Irmen de
+  Jong.
 
-- Issue #7111: Python can now be run without a stdin, stdout or stderr
-  stream.  It was already the case with Python 2.  However, the corresponding
-  sys module entries are now set to None (instead of an unusable file object).
+- bpo-7111: Python can now be run without a stdin, stdout or stderr stream.
+  It was already the case with Python 2.  However, the corresponding sys
+  module entries are now set to None (instead of an unusable file object).
 
-- Issue #11849: Ensure that free()d memory arenas are really released
-  on POSIX systems supporting anonymous memory mappings.  Patch by
-  Charles-François Natali.
+- bpo-11849: Ensure that free()d memory arenas are really released on POSIX
+  systems supporting anonymous memory mappings.  Patch by Charles-François
+  Natali.
 
 - PEP 3155 / issue #13448: Qualified name for classes and functions.
 
-- Issue #13436: Fix a bogus error message when an AST object was passed
-  an invalid integer value.
+- bpo-13436: Fix a bogus error message when an AST object was passed an
+  invalid integer value.
 
-- Issue #13411: memoryview objects are now hashable when the underlying
-  object is hashable.
+- bpo-13411: memoryview objects are now hashable when the underlying object
+  is hashable.
 
-- Issue #13338: Handle all enumerations in _Py_ANNOTATE_MEMORY_ORDER
-  to allow compiling extension modules with -Wswitch-enum on gcc.
-  Initial patch by Floris Bruynooghe.
+- bpo-13338: Handle all enumerations in _Py_ANNOTATE_MEMORY_ORDER to allow
+  compiling extension modules with -Wswitch-enum on gcc. Initial patch by
+  Floris Bruynooghe.
 
-- Issue #10227: Add an allocation cache for a single slice object.  Patch by
+- bpo-10227: Add an allocation cache for a single slice object.  Patch by
   Stefan Behnel.
 
-- Issue #13393: BufferedReader.read1() now asks the full requested size to
-  the raw stream instead of limiting itself to the buffer size.
+- bpo-13393: BufferedReader.read1() now asks the full requested size to the
+  raw stream instead of limiting itself to the buffer size.
 
-- Issue #13392: Writing a pyc file should now be atomic under Windows as well.
+- bpo-13392: Writing a pyc file should now be atomic under Windows as well.
 
-- Issue #13333: The UTF-7 decoder now accepts lone surrogates (the encoder
+- bpo-13333: The UTF-7 decoder now accepts lone surrogates (the encoder
   already accepts them).
 
-- Issue #13389: Full garbage collection passes now clear the freelists for
-  list and dict objects.  They already cleared other freelists in the
+- bpo-13389: Full garbage collection passes now clear the freelists for list
+  and dict objects.  They already cleared other freelists in the
   interpreter.
 
-- Issue #13327: Remove the need for an explicit None as the second argument
-  to os.utime, os.lutimes, os.futimes, os.futimens, os.futimesat, in
-  order to update to the current time. Also added keyword argument
-  handling to os.utimensat in order to remove the need for explicit None.
+- bpo-13327: Remove the need for an explicit None as the second argument to
+  os.utime, os.lutimes, os.futimes, os.futimens, os.futimesat, in order to
+  update to the current time. Also added keyword argument handling to
+  os.utimensat in order to remove the need for explicit None.
 
-- Issue #13350: Simplify some C code by replacing most usages of
+- bpo-13350: Simplify some C code by replacing most usages of
   PyUnicode_Format by PyUnicode_FromFormat.
 
-- Issue #13342: input() used to ignore sys.stdin's and sys.stdout's unicode
+- bpo-13342: input() used to ignore sys.stdin's and sys.stdout's unicode
   error handler in interactive mode (when calling into PyOS_Readline()).
 
-- Issue #9896: Add start, stop, and step attributes to range objects.
+- bpo-9896: Add start, stop, and step attributes to range objects.
 
-- Issue #13343: Fix a SystemError when a lambda expression uses a global
+- bpo-13343: Fix a SystemError when a lambda expression uses a global
   variable in the default value of a keyword-only argument: ``lambda *,
   arg=GLOBAL_NAME: None``
 
-- Issue #12797: Added custom opener parameter to builtin open() and
+- bpo-12797: Added custom opener parameter to builtin open() and
   FileIO.open().
 
-- Issue #10519: Avoid unnecessary recursive function calls in
-  setobject.c.
+- bpo-10519: Avoid unnecessary recursive function calls in setobject.c.
 
-- Issue #10363: Deallocate global locks in Py_Finalize().
+- bpo-10363: Deallocate global locks in Py_Finalize().
 
-- Issue #13018: Fix reference leaks in error paths in dictobject.c.
-  Patch by Suman Saha.
+- bpo-13018: Fix reference leaks in error paths in dictobject.c. Patch by
+  Suman Saha.
 
-- Issue #13201: Define '==' and '!=' to compare range objects based on
-  the sequence of values they define (instead of comparing based on
-  object identity).
+- bpo-13201: Define '==' and '!=' to compare range objects based on the
+  sequence of values they define (instead of comparing based on object
+  identity).
 
-- Issue #1294232: In a few cases involving metaclass inheritance, the
+- bpo-1294232: In a few cases involving metaclass inheritance, the
   interpreter would sometimes invoke the wrong metaclass when building a new
   class object. These cases now behave correctly. Patch by Daniel Urban.
 
-- Issue #12753: Add support for Unicode name aliases and named sequences.
-  Both ``unicodedata.lookup()`` and '\N{...}' now resolve aliases,
-  and ``unicodedata.lookup()`` resolves named sequences too.
+- bpo-12753: Add support for Unicode name aliases and named sequences. Both
+  ``unicodedata.lookup()`` and '\N{...}' now resolve aliases, and
+  ``unicodedata.lookup()`` resolves named sequences too.
 
-- Issue #12170: The count(), find(), rfind(), index() and rindex() methods
-  of bytes and bytearray objects now accept an integer between 0 and 255
-  as their first argument.  Patch by Petri Lehtinen.
+- bpo-12170: The count(), find(), rfind(), index() and rindex() methods of
+  bytes and bytearray objects now accept an integer between 0 and 255 as
+  their first argument.  Patch by Petri Lehtinen.
 
-- Issue #12604: VTRACE macro expanded to no-op in _sre.c to avoid compiler
+- bpo-12604: VTRACE macro expanded to no-op in _sre.c to avoid compiler
   warnings. Patch by Josh Triplett and Petri Lehtinen.
 
-- Issue #12281: Rewrite the MBCS codec to handle correctly replace and ignore
-  error handlers on all Windows versions. The MBCS codec is now supporting all
-  error handlers, instead of only replace to encode and ignore to decode.
+- bpo-12281: Rewrite the MBCS codec to handle correctly replace and ignore
+  error handlers on all Windows versions. The MBCS codec is now supporting
+  all error handlers, instead of only replace to encode and ignore to
+  decode.
 
-- Issue #13188: When called without an explicit traceback argument,
+- bpo-13188: When called without an explicit traceback argument,
   generator.throw() now gets the traceback from the passed exception's
-  ``__traceback__`` attribute.  Patch by Petri Lehtinen.
+  ``__traceback__`` attribute. Patch by Petri Lehtinen.
 
-- Issue #13146: Writing a pyc file is now atomic under POSIX.
+- bpo-13146: Writing a pyc file is now atomic under POSIX.
 
-- Issue #7833: Extension modules built using distutils on Windows will no
+- bpo-7833: Extension modules built using distutils on Windows will no
   longer include a "manifest" to prevent them failing at import time in some
   embedded situations.
 
@@ -8412,2198 +8540,2205 @@ Core and Builtins
 
 - Add internal API for static strings (_Py_identifier et al.).
 
-- Issue #13063: the Windows error ERROR_NO_DATA (numbered 232 and described
-  as "The pipe is being closed") is now mapped to POSIX errno EPIPE
-  (previously EINVAL).
+- bpo-13063: the Windows error ERROR_NO_DATA (numbered 232 and described as
+  "The pipe is being closed") is now mapped to POSIX errno EPIPE (previously
+  EINVAL).
 
-- Issue #12911: Fix memory consumption when calculating the repr() of huge
+- bpo-12911: Fix memory consumption when calculating the repr() of huge
   tuples or lists.
 
 - PEP 393: flexible string representation. Thanks to Torsten Becker for the
   initial implementation, and Victor Stinner for various bug fixes.
 
-- Issue #14081: The 'sep' and 'maxsplit' parameter to str.split, bytes.split,
+- bpo-14081: The 'sep' and 'maxsplit' parameter to str.split, bytes.split,
   and bytearray.split may now be passed as keyword arguments.
 
-- Issue #13012: The 'keepends' parameter to str.splitlines may now be passed
-  as a keyword argument: "my_string.splitlines(keepends=True)".  The same
+- bpo-13012: The 'keepends' parameter to str.splitlines may now be passed as
+  a keyword argument: "my_string.splitlines(keepends=True)".  The same
   change also applies to bytes.splitlines and bytearray.splitlines.
 
-- Issue #7732: Don't open a directory as a file anymore while importing a
+- bpo-7732: Don't open a directory as a file anymore while importing a
   module. Ignore the direcotry if its name matchs the module name (e.g.
   "__init__.py") and raise a ImportError instead.
 
-- Issue #13021: Missing decref on an error path.  Thanks to Suman Saha for
+- bpo-13021: Missing decref on an error path.  Thanks to Suman Saha for
   finding the bug and providing a patch.
 
-- Issue #12973: Fix overflow checks that relied on undefined behaviour in
-  list_repeat (listobject.c) and islice_next (itertoolsmodule.c).  These bugs
-  caused test failures with recent versions of Clang.
+- bpo-12973: Fix overflow checks that relied on undefined behaviour in
+  list_repeat (listobject.c) and islice_next (itertoolsmodule.c).  These
+  bugs caused test failures with recent versions of Clang.
 
-- Issue #12904: os.utime, os.futimes, os.lutimes, and os.futimesat now write
+- bpo-12904: os.utime, os.futimes, os.lutimes, and os.futimesat now write
   atime and mtime with nanosecond precision on modern POSIX platforms.
 
-- Issue #12802: the Windows error ERROR_DIRECTORY (numbered 267) is now
-  mapped to POSIX errno ENOTDIR (previously EINVAL).
+- bpo-12802: the Windows error ERROR_DIRECTORY (numbered 267) is now mapped
+  to POSIX errno ENOTDIR (previously EINVAL).
 
-- Issue #9200: The str.is* methods now work with strings that contain non-BMP
+- bpo-9200: The str.is* methods now work with strings that contain non-BMP
   characters even in narrow Unicode builds.
 
-- Issue #12791: Break reference cycles early when a generator exits with
-  an exception.
+- bpo-12791: Break reference cycles early when a generator exits with an
+  exception.
 
-- Issue #12773: Make __doc__ mutable on user-defined classes.
+- bpo-12773: Make __doc__ mutable on user-defined classes.
 
-- Issue #12766: Raise a ValueError when creating a class with a class variable
+- bpo-12766: Raise a ValueError when creating a class with a class variable
   that conflicts with a name in __slots__.
 
-- Issue #12266: Fix str.capitalize() to correctly uppercase/lowercase
+- bpo-12266: Fix str.capitalize() to correctly uppercase/lowercase
   titlecased and cased non-letter characters.
 
-- Issue #12732: In narrow unicode builds, allow Unicode identifiers which fall
+- bpo-12732: In narrow unicode builds, allow Unicode identifiers which fall
   outside the BMP.
 
-- Issue #12575: Validate user-generated AST before it is compiled.
+- bpo-12575: Validate user-generated AST before it is compiled.
 
 - Make type(None), type(Ellipsis), and type(NotImplemented) callable. They
   return the respective singleton instances.
 
 - Forbid summing bytes with sum().
 
-- Verify the types of AST strings and identifiers provided by the user before
-  compiling them.
+- Verify the types of AST strings and identifiers provided by the user
+  before compiling them.
 
-- Issue #12647: The None object now has a __bool__() method that returns False.
-  Formerly, bool(None) returned False only because of special case logic
-  in PyObject_IsTrue().
+- bpo-12647: The None object now has a __bool__() method that returns False.
+  Formerly, bool(None) returned False only because of special case logic in
+  PyObject_IsTrue().
 
-- Issue #12579: str.format_map() now raises a ValueError if used on a
-  format string that contains positional fields. Initial patch by
-  Julian Berman.
+- bpo-12579: str.format_map() now raises a ValueError if used on a format
+  string that contains positional fields. Initial patch by Julian Berman.
 
-- Issue #10271: Allow warnings.showwarning() be any callable.
+- bpo-10271: Allow warnings.showwarning() be any callable.
 
-- Issue #11627: Fix segfault when __new__ on a exception returns a
-  non-exception class.
+- bpo-11627: Fix segfault when __new__ on a exception returns a non-
+  exception class.
 
-- Issue #12149: Update the method cache after a type's dictionary gets
-  cleared by the garbage collector.  This fixes a segfault when an instance
-  and its type get caught in a reference cycle, and the instance's
-  deallocator calls one of the methods on the type (e.g. when subclassing
-  IOBase).  Diagnosis and patch by Davide Rizzo.
+- bpo-12149: Update the method cache after a type's dictionary gets cleared
+  by the garbage collector.  This fixes a segfault when an instance and its
+  type get caught in a reference cycle, and the instance's deallocator calls
+  one of the methods on the type (e.g. when subclassing IOBase).  Diagnosis
+  and patch by Davide Rizzo.
 
-- Issue #9611, Issue #9015: FileIO.read() clamps the length to INT_MAX on Windows.
+- bpo-9611: FileIO.read() clamps the length to INT_MAX on Windows. (See
+  also: bpo-9015)
 
-- Issue #9642: Uniformize the tests on the availability of the mbcs codec, add
+- bpo-9642: Uniformize the tests on the availability of the mbcs codec, add
   a new HAVE_MBCS define.
 
-- Issue #9642: Fix filesystem encoding initialization: use the ANSI code page
-  on Windows if the mbcs codec is not available, and fail with a fatal error if
-  we cannot get the locale encoding (if nl_langinfo(CODESET) is not available)
-  instead of using UTF-8.
+- bpo-9642: Fix filesystem encoding initialization: use the ANSI code page
+  on Windows if the mbcs codec is not available, and fail with a fatal error
+  if we cannot get the locale encoding (if nl_langinfo(CODESET) is not
+  available) instead of using UTF-8.
 
 - When a generator yields, do not retain the caller's exception state on the
   generator.
 
-- Issue #12475: Prevent generators from leaking their exception state into the
+- bpo-12475: Prevent generators from leaking their exception state into the
   caller's frame as they return for the last time.
 
-- Issue #12291: You can now load multiple marshalled objects from a stream,
+- bpo-12291: You can now load multiple marshalled objects from a stream,
   with other data interleaved between marshalled objects.
 
-- Issue #12356: When required positional or keyword-only arguments are not
-  given, produce a informative error message which includes the name(s) of the
-  missing arguments.
+- bpo-12356: When required positional or keyword-only arguments are not
+  given, produce a informative error message which includes the name(s) of
+  the missing arguments.
 
-- Issue #12370: Fix super with no arguments when __class__ is overriden in the
+- bpo-12370: Fix super with no arguments when __class__ is overriden in the
   class body.
 
-- Issue #12084: os.stat on Windows now works properly with relative symbolic
+- bpo-12084: os.stat on Windows now works properly with relative symbolic
   links when called from any directory.
 
 - Loosen type restrictions on the __dir__ method. __dir__ can now return any
   sequence, which will be converted to a list and sorted by dir().
 
-- Issue #12265: Make error messages produced by passing an invalid set of
+- bpo-12265: Make error messages produced by passing an invalid set of
   arguments to a function more informative.
 
-- Issue #12225: Still allow Python to build if Python is not in its hg repo or
+- bpo-12225: Still allow Python to build if Python is not in its hg repo or
   mercurial is not installed.
 
-- Issue #1195: my_fgets() now always clears errors before calling fgets(). Fix
+- bpo-1195: my_fgets() now always clears errors before calling fgets(). Fix
   the following case: sys.stdin.read() stopped with CTRL+d (end of file),
   raw_input() interrupted by CTRL+c.
 
-- Issue #12216: Allow unexpected EOF errors to happen on any line of the file.
+- bpo-12216: Allow unexpected EOF errors to happen on any line of the file.
 
-- Issue #12199: The TryExcept and TryFinally and AST nodes have been unified
+- bpo-12199: The TryExcept and TryFinally and AST nodes have been unified
   into a Try node.
 
-- Issue #9670: Increase the default stack size for secondary threads on
-  Mac OS X and FreeBSD to reduce the chances of a crash instead of a
-  "maximum recursion depth" RuntimeError exception.
-  (patch by Ronald Oussoren)
+- bpo-9670: Increase the default stack size for secondary threads on Mac OS
+  X and FreeBSD to reduce the chances of a crash instead of a "maximum
+  recursion depth" RuntimeError exception. (patch by Ronald Oussoren)
 
-- Issue #12106: The use of the multiple-with shorthand syntax is now reflected
+- bpo-12106: The use of the multiple-with shorthand syntax is now reflected
   in the AST.
 
-- Issue #12190: Try to use the same filename object when compiling unmarshalling
-  a code objects in the same file.
+- bpo-12190: Try to use the same filename object when compiling
+  unmarshalling a code objects in the same file.
 
-- Issue #12166: Move implementations of dir() specialized for various types into
-  the __dir__() methods of those types.
+- bpo-12166: Move implementations of dir() specialized for various types
+  into the __dir__() methods of those types.
 
-- Issue #5715: In socketserver, close the server socket in the child process.
+- bpo-5715: In socketserver, close the server socket in the child process.
 
-- Correct lookup of __dir__ on objects. Among other things, this causes errors
-  besides AttributeError found on lookup to be propagated.
+- Correct lookup of __dir__ on objects. Among other things, this causes
+  errors besides AttributeError found on lookup to be propagated.
 
-- Issue #12060: Use sig_atomic_t type and volatile keyword in the signal
+- bpo-12060: Use sig_atomic_t type and volatile keyword in the signal
   module. Patch written by Charles-François Natali.
 
-- Issue #1746656: Added the if_nameindex, if_indextoname, if_nametoindex
+- bpo-1746656: Added the if_nameindex, if_indextoname, if_nametoindex
   methods to the socket module.
 
-- Issue #12044: Fixed subprocess.Popen when used as a context manager to
-  wait for the process to end when exiting the context to avoid unintentionally
+- bpo-12044: Fixed subprocess.Popen when used as a context manager to wait
+  for the process to end when exiting the context to avoid unintentionally
   leaving zombie processes around.
 
-- Issue #1195: Fix input() if it is interrupted by CTRL+d and then CTRL+c,
-  clear the end-of-file indicator after CTRL+d.
+- bpo-1195: Fix input() if it is interrupted by CTRL+d and then CTRL+c,
+  clear the end- of-file indicator after CTRL+d.
 
-- Issue #1856: Avoid crashes and lockups when daemon threads run while the
+- bpo-1856: Avoid crashes and lockups when daemon threads run while the
   interpreter is shutting down; instead, these threads are now killed when
   they try to take the GIL.
 
-- Issue #9756: When calling a method descriptor or a slot wrapper descriptor,
+- bpo-9756: When calling a method descriptor or a slot wrapper descriptor,
   the check of the object type doesn't read the __class__ attribute anymore.
-  Fix a crash if a class override its __class__ attribute (e.g. a proxy of the
-  str type). Patch written by Andreas Stührk.
+  Fix a crash if a class override its __class__ attribute (e.g. a proxy of
+  the str type). Patch written by Andreas Stührk.
 
-- Issue #10517: After fork(), reinitialize the TLS used by the PyGILState_*
+- bpo-10517: After fork(), reinitialize the TLS used by the PyGILState_*
   APIs, to avoid a crash with the pthread implementation in RHEL 5.  Patch
   by Charles-François Natali.
 
-- Issue #10914: Initialize correctly the filesystem codec when creating a new
-  subinterpreter to fix a bootstrap issue with codecs implemented in Python, as
-  the ISO-8859-15 codec.
+- bpo-10914: Initialize correctly the filesystem codec when creating a new
+  subinterpreter to fix a bootstrap issue with codecs implemented in Python,
+  as the ISO-8859-15 codec.
 
-- Issue #11918: OS/2 and VMS are no more supported because of the lack of
+- bpo-11918: OS/2 and VMS are no more supported because of the lack of
   maintainer.
 
-- Issue #6780: fix starts/endswith error message to mention that tuples are
+- bpo-6780: fix starts/endswith error message to mention that tuples are
   accepted too.
 
-- Issue #5057: fix a bug in the peepholer that led to non-portable pyc files
+- bpo-5057: fix a bug in the peepholer that led to non-portable pyc files
   between narrow and wide builds while optimizing BINARY_SUBSCR on non-BMP
   chars (e.g. "\U00012345"[0]).
 
-- Issue #11845: Fix typo in rangeobject.c that caused a crash in
-  compute_slice_indices.  Patch by Daniel Urban.
+- bpo-11845: Fix typo in rangeobject.c that caused a crash in
+  compute_slice_indices. Patch by Daniel Urban.
 
-- Issue #5673: Added a `timeout` keyword argument to subprocess.Popen.wait,
+- bpo-5673: Added a `timeout` keyword argument to subprocess.Popen.wait,
   subprocess.Popen.communicated, subprocess.call, subprocess.check_call, and
-  subprocess.check_output.  If the blocking operation takes more than `timeout`
-  seconds, the `subprocess.TimeoutExpired` exception is raised.
+  subprocess.check_output.  If the blocking operation takes more than
+  `timeout` seconds, the `subprocess.TimeoutExpired` exception is raised.
 
-- Issue #11650: PyOS_StdioReadline() retries fgets() if it was interrupted
-  (EINTR), for example if the program is stopped with CTRL+z on Mac OS X. Patch
-  written by Charles-Francois Natali.
+- bpo-11650: PyOS_StdioReadline() retries fgets() if it was interrupted
+  (EINTR), for example if the program is stopped with CTRL+z on Mac OS X.
+  Patch written by Charles-Francois Natali.
 
-- Issue #9319: Include the filename in "Non-UTF8 code ..." syntax error.
+- bpo-9319: Include the filename in "Non-UTF8 code ..." syntax error.
 
-- Issue #10785: Store the filename as Unicode in the Python parser.
+- bpo-10785: Store the filename as Unicode in the Python parser.
 
-- Issue #11619: _PyImport_LoadDynamicModule() doesn't encode the path to bytes
+- bpo-11619: _PyImport_LoadDynamicModule() doesn't encode the path to bytes
   on Windows.
 
-- Issue #10998: Remove mentions of -Q, sys.flags.division_warning and
+- bpo-10998: Remove mentions of -Q, sys.flags.division_warning and
   Py_DivisionWarningFlag left over from Python 2.
 
-- Issue #11244: Remove an unnecessary peepholer check that was preventing
+- bpo-11244: Remove an unnecessary peepholer check that was preventing
   negative zeros from being constant-folded properly.
 
-- Issue #11395: io.FileIO().write() clamps the data length to 32,767 bytes on
-  Windows if the file is a TTY to workaround a Windows bug. The Windows console
-  returns an error (12: not enough space error) on writing into stdout if
-  stdout mode is binary and the length is greater than 66,000 bytes (or less,
-  depending on heap usage).
+- bpo-11395: io.FileIO().write() clamps the data length to 32,767 bytes on
+  Windows if the file is a TTY to workaround a Windows bug. The Windows
+  console returns an error (12: not enough space error) on writing into
+  stdout if stdout mode is binary and the length is greater than 66,000
+  bytes (or less, depending on heap usage).
 
-- Issue #11320: fix bogus memory management in Modules/getpath.c, leading to
-  possible crash when calling Py_SetPath().
+- bpo-11320: fix bogus memory management in Modules/getpath.c, leading to a
+  possible crash when calling Py_SetPath().
 
-- Issue #11432: A bug was introduced in subprocess.Popen on posix systems with
-  3.2.0 where the stdout or stderr file descriptor being the same as the stdin
-  file descriptor would raise an exception. webbrowser.open would fail. fixed.
+- bpo-11432: A bug was introduced in subprocess.Popen on posix systems with
+  3.2.0 where the stdout or stderr file descriptor being the same as the
+  stdin file descriptor would raise an exception. webbrowser.open would
+  fail. fixed.
 
-- Issue #9856: Change object.__format__ with a non-empty format string
-  to be a DeprecationWarning. In 3.2 it was a PendingDeprecationWarning.
-  In 3.4 it will be a TypeError.
+- bpo-9856: Change object.__format__ with a non-empty format string to be a
+  DeprecationWarning. In 3.2 it was a PendingDeprecationWarning. In 3.4 it
+  will be a TypeError.
 
-- Issue #11244: The peephole optimizer is now able to constant-fold
-  arbitrarily complex expressions.  This also fixes a 3.2 regression where
-  operations involving negative numbers were not constant-folded.
+- bpo-11244: The peephole optimizer is now able to constant-fold arbitrarily
+  complex expressions.  This also fixes a 3.2 regression where operations
+  involving negative numbers were not constant-folded.
 
-- Issue #11450: Don't truncate hg version info in Py_GetBuildInfo() when
-  there are many tags (e.g. when using mq).  Patch by Nadeem Vawda.
+- bpo-11450: Don't truncate hg version info in Py_GetBuildInfo() when there
+  are many tags (e.g. when using mq).  Patch by Nadeem Vawda.
 
-- Issue #11335: Fixed a memory leak in list.sort when the key function
-  throws an exception.
+- bpo-11335: Fixed a memory leak in list.sort when the key function throws
+  an exception.
 
-- Issue #8923: When a string is encoded to UTF-8 in strict mode, the result is
+- bpo-8923: When a string is encoded to UTF-8 in strict mode, the result is
   cached into the object. Examples: str.encode(), str.encode('utf-8'),
   PyUnicode_AsUTF8String() and PyUnicode_AsEncodedString(unicode, "utf-8",
   NULL).
 
-- Issue #10829: Refactor PyUnicode_FromFormat(), use the same function to parse
+- bpo-10829: Refactor PyUnicode_FromFormat(), use the same function to parse
   the format string in the 3 steps, fix crashs on invalid format strings.
 
-- Issue #13007: whichdb should recognize gdbm 1.9 magic numbers.
+- bpo-13007: whichdb should recognize gdbm 1.9 magic numbers.
 
-- Issue #11286: Raise a ValueError from calling PyMemoryView_FromBuffer with
-  buffer struct having a NULL data pointer.
+- bpo-11286: Raise a ValueError from calling PyMemoryView_FromBuffer with a
+  buffer struct having a NULL data pointer.
 
-- Issue #11272: On Windows, input() strips '\r' (and not only '\n'), and
+- bpo-11272: On Windows, input() strips '\r' (and not only '\n'), and
   sys.stdin uses universal newline (replace '\r\n' by '\n').
 
-- Issue #11828: startswith and endswith now accept None as slice index.
-  Patch by Torsten Becker.
+- bpo-11828: startswith and endswith now accept None as slice index. Patch
+  by Torsten Becker.
 
-- Issue #11168: Remove filename debug variable from PyEval_EvalFrameEx().
-  It encoded the Unicode filename to UTF-8, but the encoding fails on
+- bpo-11168: Remove filename debug variable from PyEval_EvalFrameEx(). It
+  encoded the Unicode filename to UTF-8, but the encoding fails on
   undecodable filename (on surrogate characters) which raises an unexpected
   UnicodeEncodeError on recursion limit.
 
-- Issue #11187: Remove bootstrap code (use ASCII) of
+- bpo-11187: Remove bootstrap code (use ASCII) of
   PyUnicode_AsEncodedString(), it was replaced by a better fallback (use the
   locale encoding) in PyUnicode_EncodeFSDefault().
 
 - Check for NULL result in PyType_FromSpec.
 
-- Issue #10516: New copy() and clear() methods for lists and bytearrays.
+- bpo-10516: New copy() and clear() methods for lists and bytearrays.
 
-- Issue #11386: bytearray.pop() now throws IndexError when the bytearray is
+- bpo-11386: bytearray.pop() now throws IndexError when the bytearray is
   empty, instead of OverflowError.
 
-- Issue #12380: The rjust, ljust and center methods of bytes and bytearray
-  now accept a bytearray argument.
+- bpo-12380: The rjust, ljust and center methods of bytes and bytearray now
+  accept a bytearray argument.
 
 Library
 -------
 
-- Issue #14195: An issue that caused weakref.WeakSet instances to incorrectly
-  return True for a WeakSet instance 'a' in both 'a < a' and 'a > a' has been
-  fixed.
+- bpo-14195: An issue that caused weakref.WeakSet instances to incorrectly
+  return True for a WeakSet instance 'a' in both 'a < a' and 'a > a' has
+  been fixed.
 
-- Issue #14166: Pickler objects now have an optional ``dispatch_table``
+- bpo-14166: Pickler objects now have an optional ``dispatch_table``
   attribute which allows to set custom per-pickler reduction functions.
   Patch by sbt.
 
-- Issue #14177: marshal.loads() now raises TypeError when given an unicode
+- bpo-14177: marshal.loads() now raises TypeError when given an unicode
   string.  Patch by Guilherme Gonçalves.
 
-- Issue #13550: Remove the debug machinery from the threading module: remove
+- bpo-13550: Remove the debug machinery from the threading module: remove
   verbose arguments from all threading classes and functions.
 
-- Issue #14159: Fix the len() of weak containers (WeakSet, WeakKeyDictionary,
+- bpo-14159: Fix the len() of weak containers (WeakSet, WeakKeyDictionary,
   WeakValueDictionary) to return a better approximation when some objects
   are dead or dying.  Moreover, the implementation is now O(1) rather than
   O(n).
 
-- Issue #11841: Fix comparison bug with 'rc' versions in packaging.version.
+- bpo-11841: Fix comparison bug with 'rc' versions in packaging.version.
   Patch by Filip Gruszczyński.
 
-- Issue #6884: Fix long-standing bugs with MANIFEST.in parsing in distutils
-  on Windows.  Also fixed in packaging.
+- bpo-6884: Fix long-standing bugs with MANIFEST.in parsing in distutils on
+  Windows. Also fixed in packaging.
 
-- Issue #8033: sqlite3: Fix 64-bit integer handling in user functions
-  on 32-bit architectures. Initial patch by Philippe Devalkeneer.
+- bpo-8033: sqlite3: Fix 64-bit integer handling in user functions on 32-bit
+  architectures. Initial patch by Philippe Devalkeneer.
 
 - HTMLParser is now able to handle slashes in the start tag.
 
-- Issue #13641: Decoding functions in the base64 module now accept ASCII-only
+- bpo-13641: Decoding functions in the base64 module now accept ASCII-only
   unicode strings.  Patch by Catalin Iacob.
 
-- Issue #14043: Speed up importlib's _FileFinder by at least 8x, and add a
-  new importlib.invalidate_caches() function.
+- bpo-14043: Speed up importlib's _FileFinder by at least 8x, and add a new
+  importlib.invalidate_caches() function.
 
-- Issue #14001: CVE-2012-0845: xmlrpc: Fix an endless loop in
+- bpo-14001: CVE-2012-0845: xmlrpc: Fix an endless loop in
   SimpleXMLRPCServer upon malformed POST request.
 
-- Issue #13961: Move importlib over to using os.replace() for atomic renaming.
+- bpo-13961: Move importlib over to using os.replace() for atomic renaming.
 
 - Do away with ambiguous level values (as suggested by PEP 328) in
   importlib.__import__() by raising ValueError when level < 0.
 
-- Issue #2489: pty.spawn could consume 100% cpu when it encountered an EOF.
+- bpo-2489: pty.spawn could consume 100% cpu when it encountered an EOF.
 
-- Issue #13014: Fix a possible reference leak in SSLSocket.getpeercert().
+- bpo-13014: Fix a possible reference leak in SSLSocket.getpeercert().
 
-- Issue #13777: Add PF_SYSTEM sockets on OS X.
-  Patch by Michael Goderbauer.
+- bpo-13777: Add PF_SYSTEM sockets on OS X. Patch by Michael Goderbauer.
 
-- Issue #13015: Fix a possible reference leak in defaultdict.__repr__.
-  Patch by Suman Saha.
+- bpo-13015: Fix a possible reference leak in defaultdict.__repr__. Patch by
+  Suman Saha.
 
-- Issue #1326113: distutils' and packaging's build_ext commands option now
+- bpo-1326113: distutils' and packaging's build_ext commands option now
   correctly parses multiple values (separated by whitespace or commas) given
   to their --libraries option.
 
-- Issue #10287: nntplib now queries the server's CAPABILITIES first before
+- bpo-10287: nntplib now queries the server's CAPABILITIES first before
   sending MODE READER, and only sends it if not already in READER mode.
   Patch by Hynek Schlawack.
 
-- Issue #13993: HTMLParser is now able to handle broken end tags when
+- bpo-13993: HTMLParser is now able to handle broken end tags when
   strict=False.
 
-- Issue #13930: lib2to3 now supports writing converted output files to another
+- bpo-13930: lib2to3 now supports writing converted output files to another
   directory tree as well as copying unchanged files and altering the file
   suffix.
 
-- Issue #9750: Fix sqlite3.Connection.iterdump on tables and fields
-  with a name that is a keyword or contains quotes. Patch by Marko
-  Kohtala.
-
-- Issue #10287: nntplib now queries the server's CAPABILITIES again after
-  authenticating (since the result may change, according to RFC 4643).
-  Patch by Hynek Schlawack.
-
-- Issue #13590: On OS X 10.7 and 10.6 with Xcode 4.2, building
-  Distutils-based packages with C extension modules may fail because
-  Apple has removed gcc-4.2, the version used to build python.org
-  64-bit/32-bit Pythons.  If the user does not explicitly override
-  the default C compiler by setting the CC environment variable,
-  Distutils will now attempt to compile extension modules with clang
-  if gcc-4.2 is required but not found. Also as a convenience, if
-  the user does explicitly set CC, substitute its value as the default
-  compiler in the Distutils LDSHARED configuration variable for OS X.
-  (Note, the python.org 32-bit-only Pythons use gcc-4.0 and the 10.4u
+- bpo-9750: Fix sqlite3.Connection.iterdump on tables and fields with a name
+  that is a keyword or contains quotes. Patch by Marko Kohtala.
+
+- bpo-10287: nntplib now queries the server's CAPABILITIES again after
+  authenticating (since the result may change, according to RFC 4643). Patch
+  by Hynek Schlawack.
+
+- bpo-13590: On OS X 10.7 and 10.6 with Xcode 4.2, building Distutils-based
+  packages with C extension modules may fail because Apple has removed
+  gcc-4.2, the version used to build python.org 64-bit/32-bit Pythons.  If
+  the user does not explicitly override the default C compiler by setting
+  the CC environment variable, Distutils will now attempt to compile
+  extension modules with clang if gcc-4.2 is required but not found. Also as
+  a convenience, if the user does explicitly set CC, substitute its value as
+  the default compiler in the Distutils LDSHARED configuration variable for
+  OS X. (Note, the python.org 32-bit-only Pythons use gcc-4.0 and the 10.4u
   SDK, neither of which are available in Xcode 4.  This change does not
   attempt to override settings to support their use with Xcode 4.)
 
-- Issue #13960: HTMLParser is now able to handle broken comments when
+- bpo-13960: HTMLParser is now able to handle broken comments when
   strict=False.
 
 - When '' is a path (e.g. in sys.path), make sure __file__ uses the current
   working directory instead of '' in importlib.
 
-- Issue #13609: Add two functions to query the terminal size:
-  os.get_terminal_size (low level) and shutil.get_terminal_size (high level).
-  Patch by Zbigniew Jędrzejewski-Szmek.
+- bpo-13609: Add two functions to query the terminal size:
+  os.get_terminal_size (low level) and shutil.get_terminal_size (high
+  level). Patch by Zbigniew Jędrzejewski-Szmek.
 
-- Issue #13845: On Windows, time.time() now uses GetSystemTimeAsFileTime()
-  instead of ftime() to have a resolution of 100 ns instead of 1 ms (the clock
-  accuracy is between 0.5 ms and 15 ms).
+- bpo-13845: On Windows, time.time() now uses GetSystemTimeAsFileTime()
+  instead of ftime() to have a resolution of 100 ns instead of 1 ms (the
+  clock accuracy is between 0.5 ms and 15 ms).
 
-- Issue #13846: Add time.monotonic(), monotonic clock.
+- bpo-13846: Add time.monotonic(), monotonic clock.
 
-- Issue #8184: multiprocessing: On Windows, don't set SO_REUSEADDR on
-  Connection sockets, and set FILE_FLAG_FIRST_PIPE_INSTANCE on named pipes, to
-  make sure two listeners can't bind to the same socket/pipe (or any existing
-  socket/pipe).
+- bpo-8184: multiprocessing: On Windows, don't set SO_REUSEADDR on
+  Connection sockets, and set FILE_FLAG_FIRST_PIPE_INSTANCE on named pipes,
+  to make sure two listeners can't bind to the same socket/pipe (or any
+  existing socket/pipe).
 
-- Issue #10811: Fix recursive usage of cursors. Instead of crashing,
-  raise a ProgrammingError now.
+- bpo-10811: Fix recursive usage of cursors. Instead of crashing, raise a
+  ProgrammingError now.
 
-- Issue #13734: Add os.fwalk(), a directory walking function yielding file
+- bpo-13734: Add os.fwalk(), a directory walking function yielding file
   descriptors.
 
-- Issue #2945: Make the distutils upload command aware of bdist_rpm products.
+- bpo-2945: Make the distutils upload command aware of bdist_rpm products.
 
-- Issue #13712: pysetup create should not convert package_data to extra_files.
+- bpo-13712: pysetup create should not convert package_data to extra_files.
 
-- Issue #11805: package_data in setup.cfg should allow more than one value.
+- bpo-11805: package_data in setup.cfg should allow more than one value.
 
-- Issue #13676: Handle strings with embedded zeros correctly in sqlite3.
+- bpo-13676: Handle strings with embedded zeros correctly in sqlite3.
 
-- Issue #8828: Add new function os.replace(), for cross-platform renaming
-  with overwriting.
+- bpo-8828: Add new function os.replace(), for cross-platform renaming with
+  overwriting.
 
-- Issue #13848: open() and the FileIO constructor now check for NUL
-  characters in the file name.  Patch by Hynek Schlawack.
+- bpo-13848: open() and the FileIO constructor now check for NUL characters
+  in the file name.  Patch by Hynek Schlawack.
 
-- Issue #13806: The size check in audioop decompression functions was too
+- bpo-13806: The size check in audioop decompression functions was too
   strict and could reject valid compressed data.  Patch by Oleg Plakhotnyuk.
 
-- Issue #13812: When a multiprocessing Process child raises an exception,
-  flush stderr after printing the exception traceback.
+- bpo-13812: When a multiprocessing Process child raises an exception, flush
+  stderr after printing the exception traceback.
 
-- Issue #13885: CVE-2011-3389: the _ssl module would always disable the CBC
-  IV attack countermeasure.
+- bpo-13885: CVE-2011-3389: the _ssl module would always disable the CBC IV
+  attack countermeasure.
 
-- Issue #13847: time.localtime() and time.gmtime() now raise an OSError instead
+- bpo-13847: time.localtime() and time.gmtime() now raise an OSError instead
   of ValueError on failure. time.ctime() and time.asctime() now raises an
-  OSError if localtime() failed. time.clock() now raises a RuntimeError if the
-  processor time used is not available or its value cannot be represented
+  OSError if localtime() failed. time.clock() now raises a RuntimeError if
+  the processor time used is not available or its value cannot be
+  represented
 
-- Issue #13772: In os.symlink() under Windows, do not try to guess the link
+- bpo-13772: In os.symlink() under Windows, do not try to guess the link
   target's type (file or directory).  The detection was buggy and made the
   call non-atomic (therefore prone to race conditions).
 
-- Issue #6631: Disallow relative file paths in urllib urlopen methods.
+- bpo-6631: Disallow relative file paths in urllib urlopen methods.
 
-- Issue #13722: Avoid silencing ImportErrors when initializing the codecs
+- bpo-13722: Avoid silencing ImportErrors when initializing the codecs
   registry.
 
-- Issue #13781: Fix GzipFile bug that caused an exception to be raised when
+- bpo-13781: Fix GzipFile bug that caused an exception to be raised when
   opening for writing using a fileobj returned by os.fdopen().
 
-- Issue #13803: Under Solaris, distutils doesn't include bitness
-  in the directory name.
+- bpo-13803: Under Solaris, distutils doesn't include bitness in the
+  directory name.
 
-- Issue #10278: Add time.wallclock() function, monotonic clock.
+- bpo-10278: Add time.wallclock() function, monotonic clock.
 
-- Issue #13809: Fix regression where bz2 module wouldn't work when threads are
+- bpo-13809: Fix regression where bz2 module wouldn't work when threads are
   disabled. Original patch by Amaury Forgeot d'Arc.
 
-- Issue #13589: Fix some serialization primitives in the aifc module.
-  Patch by Oleg Plakhotnyuk.
+- bpo-13589: Fix some serialization primitives in the aifc module. Patch by
+  Oleg Plakhotnyuk.
 
-- Issue #13642: Unquote before b64encoding user:password during Basic
+- bpo-13642: Unquote before b64encoding user:password during Basic
   Authentication. Patch contributed by Joonas Kuorilehto.
 
-- Issue #12364: Fix a hang in concurrent.futures.ProcessPoolExecutor.
-  The hang would occur when retrieving the result of a scheduled future after
-  the executor had been shut down.
+- bpo-12364: Fix a hang in concurrent.futures.ProcessPoolExecutor. The hang
+  would occur when retrieving the result of a scheduled future after the
+  executor had been shut down.
 
-- Issue #13502: threading: Fix a race condition in Event.wait() that made it
+- bpo-13502: threading: Fix a race condition in Event.wait() that made it
   return False when the event was set and cleared right after.
 
-- Issue #9993: When the source and destination are on different filesystems,
+- bpo-9993: When the source and destination are on different filesystems,
   and the source is a symlink, shutil.move() now recreates a symlink on the
-  destination instead of copying the file contents.  Patch by Jonathan Niehof
-  and Hynek Schlawack.
+  destination instead of copying the file contents.  Patch by Jonathan
+  Niehof and Hynek Schlawack.
 
-- Issue #12926: Fix a bug in tarfile's link extraction.
+- bpo-12926: Fix a bug in tarfile's link extraction.
 
-- Issue #13696: Fix the 302 Relative URL Redirection problem.
+- bpo-13696: Fix the 302 Relative URL Redirection problem.
 
-- Issue #13636: Weak ciphers are now disabled by default in the ssl module
+- bpo-13636: Weak ciphers are now disabled by default in the ssl module
   (except when SSLv2 is explicitly asked for).
 
-- Issue #12715: Add an optional symlinks argument to shutil functions
-  (copyfile, copymode, copystat, copy, copy2).  When that parameter is
-  true, symlinks aren't dereferenced and the operation instead acts on the
-  symlink itself (or creates one, if relevant).  Patch by Hynek Schlawack.
+- bpo-12715: Add an optional symlinks argument to shutil functions
+  (copyfile, copymode, copystat, copy, copy2).  When that parameter is true,
+  symlinks aren't dereferenced and the operation instead acts on the symlink
+  itself (or creates one, if relevant).  Patch by Hynek Schlawack.
 
 - Add a flags parameter to select.epoll.
 
-- Issue #13626: Add support for SSL Diffie-Hellman key exchange, through the
+- bpo-13626: Add support for SSL Diffie-Hellman key exchange, through the
   SSLContext.load_dh_params() method and the ssl.OP_SINGLE_DH_USE option.
 
-- Issue #11006: Don't issue low level warning in subprocess when pipe2() fails.
+- bpo-11006: Don't issue low level warning in subprocess when pipe2() fails.
 
-- Issue #13620: Support for Chrome browser in webbrowser.  Patch contributed
-  by Arnaud Calmettes.
+- bpo-13620: Support for Chrome browser in webbrowser.  Patch contributed by
+  Arnaud Calmettes.
 
-- Issue #11829: Fix code execution holes in inspect.getattr_static for
+- bpo-11829: Fix code execution holes in inspect.getattr_static for
   metaclasses with metaclasses. Patch by Andreas Stührk.
 
-- Issue #12708: Add starmap() and starmap_async() methods (similar to
+- bpo-12708: Add starmap() and starmap_async() methods (similar to
   itertools.starmap()) to multiprocessing.Pool.  Patch by Hynek Schlawack.
 
-- Issue #1785: Fix inspect and pydoc with misbehaving descriptors.
+- bpo-1785: Fix inspect and pydoc with misbehaving descriptors.
 
-- Issue #13637: "a2b" functions in the binascii module now accept ASCII-only
+- bpo-13637: "a2b" functions in the binascii module now accept ASCII-only
   unicode strings.
 
-- Issue #13634: Add support for querying and disabling SSL compression.
+- bpo-13634: Add support for querying and disabling SSL compression.
 
-- Issue #13627: Add support for SSL Elliptic Curve-based Diffie-Hellman
-  key exchange, through the SSLContext.set_ecdh_curve() method and the
+- bpo-13627: Add support for SSL Elliptic Curve-based Diffie-Hellman key
+  exchange, through the SSLContext.set_ecdh_curve() method and the
   ssl.OP_SINGLE_ECDH_USE option.
 
-- Issue #13635: Add ssl.OP_CIPHER_SERVER_PREFERENCE, so that SSL servers
-  choose the cipher based on their own preferences, rather than on the
-  client's.
+- bpo-13635: Add ssl.OP_CIPHER_SERVER_PREFERENCE, so that SSL servers choose
+  the cipher based on their own preferences, rather than on the client's.
 
-- Issue #11813: Fix inspect.getattr_static for modules. Patch by Andreas
+- bpo-11813: Fix inspect.getattr_static for modules. Patch by Andreas
   Stührk.
 
-- Issue #7502: Fix equality comparison for DocTestCase instances.  Patch by
+- bpo-7502: Fix equality comparison for DocTestCase instances.  Patch by
   Cédric Krier.
 
-- Issue #11870: threading: Properly reinitialize threads internal locks and
+- bpo-11870: threading: Properly reinitialize threads internal locks and
   condition variables to avoid deadlocks in child processes.
 
-- Issue #8035: urllib: Fix a bug where the client could remain stuck after a
+- bpo-8035: urllib: Fix a bug where the client could remain stuck after a
   redirection or an error.
 
-- Issue #13560: os.strerror() now uses the current locale encoding instead of
+- bpo-13560: os.strerror() now uses the current locale encoding instead of
   UTF-8.
 
-- Issue #8373: The filesystem path of AF_UNIX sockets now uses the filesystem
+- bpo-8373: The filesystem path of AF_UNIX sockets now uses the filesystem
   encoding and the surrogateescape error handler, rather than UTF-8.  Patch
   by David Watson.
 
-- Issue #10350: Read and save errno before calling a function which might
-  overwrite it.  Original patch by Hallvard B Furuseth.
+- bpo-10350: Read and save errno before calling a function which might
+  overwrite it. Original patch by Hallvard B Furuseth.
 
-- Issue #11610: Introduce a more general way to declare abstract properties.
+- bpo-11610: Introduce a more general way to declare abstract properties.
 
-- Issue #13591: A bug in importlib has been fixed that caused import_module
-  to load a module twice.
+- bpo-13591: A bug in importlib has been fixed that caused import_module to
+  load a module twice.
 
-- Issue #13449 sched.scheduler.run() method has a new "blocking" parameter which
-  when set to False makes run() execute the scheduled events due to expire
-  soonest (if any) and then return.  Patch by Giampaolo Rodolà.
+- bpo-13449: sched.scheduler.run() method has a new "blocking" parameter
+  which when set to False makes run() execute the scheduled events due to
+  expire soonest (if any) and then return.  Patch by Giampaolo Rodolà.
 
-- Issue #8684 sched.scheduler class can be safely used in multi-threaded
-  environments.  Patch by Josiah Carlson and Giampaolo Rodolà.
+- bpo-8684: sched.scheduler class can be safely used in multi-threaded
+  environments. Patch by Josiah Carlson and Giampaolo Rodolà.
 
 - Alias resource.error to OSError ala PEP 3151.
 
-- Issue #5689: Add support for lzma compression to the tarfile module.
+- bpo-5689: Add support for lzma compression to the tarfile module.
 
-- Issue #13248: Turn 3.2's PendingDeprecationWarning into 3.3's
+- bpo-13248: Turn 3.2's PendingDeprecationWarning into 3.3's
   DeprecationWarning.  It covers 'cgi.escape', 'importlib.abc.PyLoader',
   'importlib.abc.PyPycLoader', 'nntplib.NNTP.xgtitle', 'nntplib.NNTP.xpath',
   and private attributes of 'smtpd.SMTPChannel'.
 
-- Issue #5905, Issue #13560: time.strftime() is now using the current locale
-  encoding, instead of UTF-8, if the wcsftime() function is not available.
+- bpo-5905: time.strftime() is now using the current locale encoding,
+  instead of UTF-8, if the wcsftime() function is not available. (See also:
+  bpo-13560)
 
-- Issue #13464: Add a readinto() method to http.client.HTTPResponse.  Patch
-  by Jon Kuhn.
+- bpo-13464: Add a readinto() method to http.client.HTTPResponse.  Patch by
+  Jon Kuhn.
 
 - tarfile.py: Correctly detect bzip2 compressed streams with blocksizes
   other than 900k.
 
-- Issue #13439: Fix many errors in turtle docstrings.
+- bpo-13439: Fix many errors in turtle docstrings.
 
-- Issue #6715: Add a module 'lzma' for compression using the LZMA algorithm.
+- bpo-6715: Add a module 'lzma' for compression using the LZMA algorithm.
   Thanks to Per Øyvind Karlsen for the initial implementation.
 
-- Issue #13487: Make inspect.getmodule robust against changes done to
+- bpo-13487: Make inspect.getmodule robust against changes done to
   sys.modules while it is iterating over it.
 
-- Issue #12618: Fix a bug that prevented py_compile from creating byte
-  compiled files in the current directory.  Initial patch by Sjoerd de Vries.
+- bpo-12618: Fix a bug that prevented py_compile from creating byte compiled
+  files in the current directory.  Initial patch by Sjoerd de Vries.
 
-- Issue #13444: When stdout has been closed explicitly, we should not attempt
+- bpo-13444: When stdout has been closed explicitly, we should not attempt
   to flush it at shutdown and print an error.
 
-- Issue #12567: The curses module uses Unicode functions for Unicode arguments
-  when it is linked to the ncurses library. It encodes also Unicode strings to
-  the locale encoding instead of UTF-8.
+- bpo-12567: The curses module uses Unicode functions for Unicode arguments
+  when it is linked to the ncurses library. It encodes also Unicode strings
+  to the locale encoding instead of UTF-8.
 
-- Issue #12856: Ensure child processes do not inherit the parent's random
-  seed for filename generation in the tempfile module.  Patch by Brian
-  Harring.
+- bpo-12856: Ensure child processes do not inherit the parent's random seed
+  for filename generation in the tempfile module.  Patch by Brian Harring.
 
-- Issue #9957: SpooledTemporaryFile.truncate() now accepts an optional size
+- bpo-9957: SpooledTemporaryFile.truncate() now accepts an optional size
   parameter, as other file-like objects.  Patch by Ryan Kelly.
 
-- Issue #13458: Fix a memory leak in the ssl module when decoding a
-  certificate with a subjectAltName.  Patch by Robert Xiao.
+- bpo-13458: Fix a memory leak in the ssl module when decoding a certificate
+  with a subjectAltName.  Patch by Robert Xiao.
 
-- Issue #13415: os.unsetenv() doesn't ignore errors anymore.
+- bpo-13415: os.unsetenv() doesn't ignore errors anymore.
 
-- Issue #13245: sched.scheduler class constructor's timefunc and
-  delayfunct parameters are now optional.
-  scheduler.enter and scheduler.enterabs methods gained a new kwargs parameter.
-  Patch contributed by Chris Clark.
+- bpo-13245: sched.scheduler class constructor's timefunc and delayfunct
+  parameters are now optional. scheduler.enter and scheduler.enterabs
+  methods gained a new kwargs parameter. Patch contributed by Chris Clark.
 
-- Issue #12328: Under Windows, refactor handling of Ctrl-C events and
-  make _multiprocessing.win32.WaitForMultipleObjects interruptible when
-  the wait_flag parameter is false.  Patch by sbt.
+- bpo-12328: Under Windows, refactor handling of Ctrl-C events and make
+  _multiprocessing.win32.WaitForMultipleObjects interruptible when the
+  wait_flag parameter is false.  Patch by sbt.
 
-- Issue #13322: Fix BufferedWriter.write() to ensure that BlockingIOError is
-  raised when the wrapped raw file is non-blocking and the write would block.
-  Previous code assumed that the raw write() would raise BlockingIOError, but
-  RawIOBase.write() is defined to returned None when the call would block.
-  Patch by sbt.
+- bpo-13322: Fix BufferedWriter.write() to ensure that BlockingIOError is
+  raised when the wrapped raw file is non-blocking and the write would
+  block. Previous code assumed that the raw write() would raise
+  BlockingIOError, but RawIOBase.write() is defined to returned None when
+  the call would block. Patch by sbt.
 
-- Issue #13358: HTMLParser now calls handle_data only once for each CDATA.
+- bpo-13358: HTMLParser now calls handle_data only once for each CDATA.
 
-- Issue #4147: minidom's toprettyxml no longer adds whitespace around a text
+- bpo-4147: minidom's toprettyxml no longer adds whitespace around a text
   node when it is the only child of an element.  Initial patch by Dan
   Kenigsberg.
 
-- Issue #13374: The Windows bytes API has been deprecated in the os module. Use
-  Unicode filenames instead of bytes filenames to not depend on the ANSI code
-  page anymore and to support any filename.
+- bpo-13374: The Windows bytes API has been deprecated in the os module. Use
+  Unicode filenames instead of bytes filenames to not depend on the ANSI
+  code page anymore and to support any filename.
 
-- Issue #13297: Use bytes type to send and receive binary data through XMLRPC.
+- bpo-13297: Use bytes type to send and receive binary data through XMLRPC.
 
-- Issue #6397: Support "/dev/poll" polling objects in select module,
-  under Solaris & derivatives.
+- bpo-6397: Support "/dev/poll" polling objects in select module, under
+  Solaris & derivatives.
 
-- Issues #1745761, #755670, #13357, #12629, #1200313: HTMLParser now correctly
-  handles non-valid attributes, including adjacent and unquoted attributes.
+- bpo-1745761: HTMLParser now correctly handles non-valid attributes,
+  including adjacent and unquoted attributes. (See also: bpo-755670,
+  bpo-13357, bpo-12629, bpo-1200313)
 
-- Issue #13193: Fix distutils.filelist.FileList and packaging.manifest.Manifest
+- bpo-13193: Fix distutils.filelist.FileList and packaging.manifest.Manifest
   under Windows.
 
-- Issue #13384: Remove unnecessary __future__ import in Lib/random.py
+- bpo-13384: Remove unnecessary __future__ import in Lib/random.py
 
-- Issue #13149: Speed up append-only StringIO objects.
+- bpo-13149: Speed up append-only StringIO objects.
 
-- Issue #13373: multiprocessing.Queue.get() could sometimes block indefinitely
+- bpo-13373: multiprocessing.Queue.get() could sometimes block indefinitely
   when called with a timeout.  Patch by Arnaud Ysmal.
 
-- Issue #13254: Fix Maildir initialization so that maildir contents
-  are read correctly.
+- bpo-13254: Fix Maildir initialization so that maildir contents are read
+  correctly.
 
-- Issue #3067: locale.setlocale() now raises TypeError if the second
-  argument is an invalid iterable. Its documentation and docstring
-  were also updated. Initial patch by Jyrki Pulliainen.
+- bpo-3067: locale.setlocale() now raises TypeError if the second argument
+  is an invalid iterable. Its documentation and docstring were also updated.
+  Initial patch by Jyrki Pulliainen.
 
-- Issue #13140: Fix the daemon_threads attribute of ThreadingMixIn.
+- bpo-13140: Fix the daemon_threads attribute of ThreadingMixIn.
 
-- Issue #13339: Fix compile error in posixmodule.c due to missing semicolon.
+- bpo-13339: Fix compile error in posixmodule.c due to missing semicolon.
   Thanks to Robert Xiao.
 
-- Byte compilation in packaging is now isolated from the calling Python -B or
-  -O options, instead of being disallowed under -B or buggy under -O.
+- Byte compilation in packaging is now isolated from the calling Python -B
+  or -O options, instead of being disallowed under -B or buggy under -O.
 
-- Issue #10570: curses.putp() and curses.tparm() are now expecting a byte
+- bpo-10570: curses.putp() and curses.tparm() are now expecting a byte
   string, instead of a Unicode string.
 
-- Issue #13295: http.server now produces valid HTML 4.01 strict.
+- bpo-13295: http.server now produces valid HTML 4.01 strict.
 
-- Issue #2892: preserve iterparse events in case of SyntaxError.
+- bpo-2892: preserve iterparse events in case of SyntaxError.
 
-- Issue #13287: urllib.request and urllib.error now contains an __all__
+- bpo-13287: urllib.request and urllib.error now contains an __all__
   attribute to expose only relevant classes and functions.  Patch by Florent
   Xicluna.
 
-- Issue #670664: Fix HTMLParser to correctly handle the content of
+- bpo-670664: Fix HTMLParser to correctly handle the content of
   ``<script>...</script>`` and ``<style>...</style>``.
 
-- Issue #10817: Fix urlretrieve function to raise ContentTooShortError even
+- bpo-10817: Fix urlretrieve function to raise ContentTooShortError even
   when reporthook is None. Patch by Jyrki Pulliainen.
 
 - Fix the xmlrpc.client user agent to return something similar to
   urllib.request user agent: "Python-xmlrpc/3.3".
 
-- Issue #13293: Better error message when trying to marshal bytes using
+- bpo-13293: Better error message when trying to marshal bytes using
   xmlrpc.client.
 
-- Issue #13291: NameError in xmlrpc package.
+- bpo-13291: NameError in xmlrpc package.
 
-- Issue #13258: Use callable() built-in in the standard library.
+- bpo-13258: Use callable() built-in in the standard library.
 
-- Issue #13273: fix a bug that prevented HTMLParser to properly detect some
+- bpo-13273: fix a bug that prevented HTMLParser to properly detect some
   tags when strict=False.
 
-- Issue #11183: Add finer-grained exceptions to the ssl module, so that
-  you don't have to inspect the exception's attributes in the common case.
+- bpo-11183: Add finer-grained exceptions to the ssl module, so that you
+  don't have to inspect the exception's attributes in the common case.
 
-- Issue #13216: Add cp65001 codec, the Windows UTF-8 (CP_UTF8).
+- bpo-13216: Add cp65001 codec, the Windows UTF-8 (CP_UTF8).
 
-- Issue #13226: Add RTLD_xxx constants to the os module. These constants can be
+- bpo-13226: Add RTLD_xxx constants to the os module. These constants can be
   used with sys.setdlopenflags().
 
-- Issue #10278: Add clock_getres(), clock_gettime() and CLOCK_xxx constants to
+- bpo-10278: Add clock_getres(), clock_gettime() and CLOCK_xxx constants to
   the time module. time.clock_gettime(time.CLOCK_MONOTONIC) provides a
   monotonic clock
 
-- Issue #10332: multiprocessing: fix a race condition when a Pool is closed
+- bpo-10332: multiprocessing: fix a race condition when a Pool is closed
   before all tasks have completed.
 
-- Issue #13255: wrong docstrings in array module.
+- bpo-13255: wrong docstrings in array module.
 
-- Issue #8540: Remove deprecated Context._clamp attribute in Decimal module.
+- bpo-8540: Remove deprecated Context._clamp attribute in Decimal module.
 
-- Issue #13235: Added DeprecationWarning to logging.warn() method and function.
+- bpo-13235: Added DeprecationWarning to logging.warn() method and function.
 
-- Issue #9168: now smtpd is able to bind privileged port.
+- bpo-9168: now smtpd is able to bind privileged port.
 
-- Issue #12529: fix cgi.parse_header issue on strings with double-quotes and
+- bpo-12529: fix cgi.parse_header issue on strings with double-quotes and
   semicolons together. Patch by Ben Darnell and Petri Lehtinen.
 
-- Issue #13227: functools.lru_cache() now has a option to distinguish
-  calls with different argument types.
+- bpo-13227: functools.lru_cache() now has a option to distinguish calls
+  with different argument types.
 
-- Issue #6090: zipfile raises a ValueError when a document with a timestamp
+- bpo-6090: zipfile raises a ValueError when a document with a timestamp
   earlier than 1980 is provided. Patch contributed by Petri Lehtinen.
 
-- Issue #13150: sysconfig no longer parses the Makefile and config.h files
-  when imported, instead doing it at build time.  This makes importing
-  sysconfig faster and reduces Python startup time by 20%.
+- bpo-13150: sysconfig no longer parses the Makefile and config.h files when
+  imported, instead doing it at build time.  This makes importing sysconfig
+  faster and reduces Python startup time by 20%.
 
-- Issue #12448: smtplib now flushes stdout while running ``python -m smtplib``
+- bpo-12448: smtplib now flushes stdout while running ``python -m smtplib``
   in order to display the prompt correctly.
 
-- Issue #12454: The mailbox module is now using ASCII, instead of the locale
+- bpo-12454: The mailbox module is now using ASCII, instead of the locale
   encoding, to read and write .mh_sequences files.
 
-- Issue #13194: zlib.compressobj().copy() and zlib.decompressobj().copy() are
+- bpo-13194: zlib.compressobj().copy() and zlib.decompressobj().copy() are
   now available on Windows.
 
-- Issue #1673007: urllib.request now supports HEAD request via new method argument.
-  Patch contributions by David Stanek, Patrick Westerhoff and Ezio Melotti.
+- bpo-1673007: urllib.request now supports HEAD request via new method
+  argument. Patch contributions by David Stanek, Patrick Westerhoff and Ezio
+  Melotti.
 
-- Issue #12386: packaging does not fail anymore when writing the RESOURCES
+- bpo-12386: packaging does not fail anymore when writing the RESOURCES
   file.
 
-- Issue #13158: Fix decoding and encoding of GNU tar specific base-256 number
+- bpo-13158: Fix decoding and encoding of GNU tar specific base-256 number
   fields in tarfile.
 
-- Issue #13025: mimetypes is now reading MIME types using the UTF-8 encoding,
+- bpo-13025: mimetypes is now reading MIME types using the UTF-8 encoding,
   instead of the locale encoding.
 
-- Issue #10653: On Windows, use strftime() instead of wcsftime() because
+- bpo-10653: On Windows, use strftime() instead of wcsftime() because
   wcsftime() doesn't format time zone correctly.
 
-- Issue #13150: The tokenize module doesn't compile large regular expressions
+- bpo-13150: The tokenize module doesn't compile large regular expressions
   at startup anymore.
 
-- Issue #11171: Fix distutils.sysconfig.get_makefile_filename when Python was
+- bpo-11171: Fix distutils.sysconfig.get_makefile_filename when Python was
   configured with different prefix and exec-prefix.
 
-- Issue #11254: Teach distutils and packaging to compile .pyc and .pyo files in
+- bpo-11254: Teach distutils and packaging to compile .pyc and .pyo files in
   PEP 3147-compliant __pycache__ directories.
 
-- Issue #7367: Fix pkgutil.walk_paths to skip directories whose
-  contents cannot be read.
+- bpo-7367: Fix pkgutil.walk_paths to skip directories whose contents cannot
+  be read.
 
-- Issue #3163: The struct module gets new format characters 'n' and 'N'
+- bpo-3163: The struct module gets new format characters 'n' and 'N'
   supporting C integer types ``ssize_t`` and ``size_t``, respectively.
 
-- Issue #13099: Fix sqlite3.Cursor.lastrowid under a Turkish locale.
-  Reported and diagnosed by Thomas Kluyver.
+- bpo-13099: Fix sqlite3.Cursor.lastrowid under a Turkish locale. Reported
+  and diagnosed by Thomas Kluyver.
 
-- Issue #13087: BufferedReader.seek() now always raises UnsupportedOperation
-  if the underlying raw stream is unseekable, even if the seek could be
+- bpo-13087: BufferedReader.seek() now always raises UnsupportedOperation if
+  the underlying raw stream is unseekable, even if the seek could be
   satisfied using the internal buffer.  Patch by John O'Connor.
 
-- Issue #7689: Allow pickling of dynamically created classes when their
-  metaclass is registered with copyreg.  Patch by Nicolas M. Thiéry and Craig
-  Citro.
+- bpo-7689: Allow pickling of dynamically created classes when their
+  metaclass is registered with copyreg.  Patch by Nicolas M. Thiéry and
+  Craig Citro.
 
-- Issue #13034: When decoding some SSL certificates, the subjectAltName
+- bpo-13034: When decoding some SSL certificates, the subjectAltName
   extension could be unreported.
 
-- Issue #12306: Expose the runtime version of the zlib C library as a constant,
+- bpo-12306: Expose the runtime version of the zlib C library as a constant,
   ZLIB_RUNTIME_VERSION, in the zlib module. Patch by Torsten Landschoff.
 
-- Issue #12959: Add collections.ChainMap to collections.__all__.
+- bpo-12959: Add collections.ChainMap to collections.__all__.
 
-- Issue #8933: distutils' PKG-INFO files and packaging's METADATA files will
-  now correctly report Metadata-Version: 1.1 instead of 1.0 if a Classifier or
-  Download-URL field is present.
+- bpo-8933: distutils' PKG-INFO files and packaging's METADATA files will
+  now correctly report Metadata-Version: 1.1 instead of 1.0 if a Classifier
+  or Download-URL field is present.
 
-- Issue #12567: Add curses.unget_wch() function. Push a character so the next
+- bpo-12567: Add curses.unget_wch() function. Push a character so the next
   get_wch() will return it.
 
-- Issue #9561: distutils and packaging now writes egg-info files using UTF-8,
+- bpo-9561: distutils and packaging now writes egg-info files using UTF-8,
   instead of the locale encoding.
 
-- Issue #8286: The distutils command sdist will print a warning message instead
+- bpo-8286: The distutils command sdist will print a warning message instead
   of crashing when an invalid path is given in the manifest template.
 
-- Issue #12841: tarfile unnecessarily checked the existence of numerical user
-  and group ids on extraction. If one of them did not exist the respective id
-  of the current user (i.e. root) was used for the file and ownership
+- bpo-12841: tarfile unnecessarily checked the existence of numerical user
+  and group ids on extraction. If one of them did not exist the respective
+  id of the current user (i.e. root) was used for the file and ownership
   information was lost.
 
-- Issue #12888: Fix a bug in HTMLParser.unescape that prevented it to escape
+- bpo-12888: Fix a bug in HTMLParser.unescape that prevented it to escape
   more than 128 entities.  Patch by Peter Otten.
 
-- Issue #12878: Expose a __dict__ attribute on io.IOBase and its subclasses.
+- bpo-12878: Expose a __dict__ attribute on io.IOBase and its subclasses.
 
-- Issue #12494: On error, call(), check_call(), check_output() and
+- bpo-12494: On error, call(), check_call(), check_output() and
   getstatusoutput() functions of the subprocess module now kill the process,
   read its status (to avoid zombis) and close pipes.
 
-- Issue #12720: Expose low-level Linux extended file attribute functions in os.
+- bpo-12720: Expose low-level Linux extended file attribute functions in os.
 
-- Issue #10946: The distutils commands bdist_dumb, bdist_wininst and bdist_msi
+- bpo-10946: The distutils commands bdist_dumb, bdist_wininst and bdist_msi
   now respect a --skip-build option given to bdist.  The packaging commands
   were fixed too.
 
-- Issue #12847: Fix a crash with negative PUT and LONG_BINPUT arguments in
-  the C pickle implementation.
+- bpo-12847: Fix a crash with negative PUT and LONG_BINPUT arguments in the
+  C pickle implementation.
 
-- Issue #11564: Avoid crashes when trying to pickle huge objects or containers
-  (more than 2**31 items).  Instead, in most cases, an OverflowError is raised.
+- bpo-11564: Avoid crashes when trying to pickle huge objects or containers
+  (more than 2**31 items).  Instead, in most cases, an OverflowError is
+  raised.
 
-- Issue #12287: Fix a stack corruption in ossaudiodev module when the FD is
+- bpo-12287: Fix a stack corruption in ossaudiodev module when the FD is
   greater than FD_SETSIZE.
 
-- Issue #12839: Fix crash in zlib module due to version mismatch.
-  Fix by Richard M. Tew.
+- bpo-12839: Fix crash in zlib module due to version mismatch. Fix by
+  Richard M. Tew.
 
-- Issue #9923: The mailcap module now correctly uses the platform path
+- bpo-9923: The mailcap module now correctly uses the platform path
   separator for the MAILCAP environment variable on non-POSIX platforms.
 
-- Issue #12835: Follow up to #6560 that unconditionally prevents use of the
+- bpo-12835: Follow up to #6560 that unconditionally prevents use of the
   unencrypted sendmsg/recvmsg APIs on SSL wrapped sockets. Patch by David
   Watson.
 
-- Issue #12803: SSLContext.load_cert_chain() now accepts a password argument
-  to be used if the private key is encrypted.  Patch by Adam Simpkins.
+- bpo-12803: SSLContext.load_cert_chain() now accepts a password argument to
+  be used if the private key is encrypted.  Patch by Adam Simpkins.
 
-- Issue #11657: Fix sending file descriptors over 255 over a multiprocessing
+- bpo-11657: Fix sending file descriptors over 255 over a multiprocessing
   Pipe.
 
-- Issue #12811: tabnanny.check() now promptly closes checked files. Patch by
+- bpo-12811: tabnanny.check() now promptly closes checked files. Patch by
   Anthony Briggs.
 
-- Issue #6560: The sendmsg/recvmsg API is now exposed by the socket module
-  when provided by the underlying platform, supporting processing of
-  ancillary data in pure Python code. Patch by David Watson and Heiko Wundram.
+- bpo-6560: The sendmsg/recvmsg API is now exposed by the socket module when
+  provided by the underlying platform, supporting processing of ancillary
+  data in pure Python code. Patch by David Watson and Heiko Wundram.
 
-- Issue #12326: On Linux, sys.platform doesn't contain the major version
-  anymore. It is now always 'linux', instead of 'linux2' or 'linux3' depending
-  on the Linux version used to build Python.
+- bpo-12326: On Linux, sys.platform doesn't contain the major version
+  anymore. It is now always 'linux', instead of 'linux2' or 'linux3'
+  depending on the Linux version used to build Python.
 
-- Issue #12213: Fix a buffering bug with interleaved reads and writes that
+- bpo-12213: Fix a buffering bug with interleaved reads and writes that
   could appear on BufferedRandom streams.
 
-- Issue #12778: Reduce memory consumption when JSON-encoding a large
-  container of many small objects.
+- bpo-12778: Reduce memory consumption when JSON-encoding a large container
+  of many small objects.
 
-- Issue #12650: Fix a race condition where a subprocess.Popen could leak
+- bpo-12650: Fix a race condition where a subprocess.Popen could leak
   resources (FD/zombie) when killed at the wrong time.
 
-- Issue #12744: Fix inefficient representation of integers between 2**31 and
+- bpo-12744: Fix inefficient representation of integers between 2**31 and
   2**63 on systems with a 64-bit C "long".
 
-- Issue #12646: Add an 'eof' attribute to zlib.Decompress, to make it easier to
+- bpo-12646: Add an 'eof' attribute to zlib.Decompress, to make it easier to
   detect truncated input streams.
 
-- Issue #11513: Fix exception handling ``tarfile.TarFile.gzopen()`` when
-  the file cannot be opened.
+- bpo-11513: Fix exception handling ``tarfile.TarFile.gzopen()`` when the
+  file cannot be opened.
 
-- Issue #12687: Fix a possible buffering bug when unpickling text mode
+- bpo-12687: Fix a possible buffering bug when unpickling text mode
   (protocol 0, mostly) pickles.
 
-- Issue #10087: Fix the html output format of the calendar module.
+- bpo-10087: Fix the html output format of the calendar module.
 
-- Issue #13121: add support for inplace math operators to collections.Counter.
+- bpo-13121: add support for inplace math operators to collections.Counter.
 
 - Add support for unary plus and unary minus to collections.Counter.
 
-- Issue #12683: urlparse updated to include svn as schemes that uses relative
+- bpo-12683: urlparse updated to include svn as schemes that uses relative
   paths. (svn from 1.5 onwards support relative path).
 
-- Issue #12655: Expose functions from sched.h in the os module: sched_yield(),
+- bpo-12655: Expose functions from sched.h in the os module: sched_yield(),
   sched_setscheduler(), sched_getscheduler(), sched_setparam(),
-  sched_get_min_priority(), sched_get_max_priority(), sched_rr_get_interval(),
-  sched_getaffinity(), sched_setaffinity().
+  sched_get_min_priority(), sched_get_max_priority(),
+  sched_rr_get_interval(), sched_getaffinity(), sched_setaffinity().
 
 - Add ThreadError to threading.__all__.
 
-- Issues #11104, #8688: Fix the behavior of distutils' sdist command with
-  manually-maintained MANIFEST files.
+- bpo-11104: Fix the behavior of distutils' sdist command with manually-
+  maintained MANIFEST files. (See also: bpo-8688)
 
-- Issue #11281: smtplib.STMP gets source_address parameter, which adds the
+- bpo-11281: smtplib.STMP gets source_address parameter, which adds the
   ability to bind to specific source address on a machine with multiple
   interfaces. Patch by Paulo Scardine.
 
-- Issue #12464: tempfile.TemporaryDirectory.cleanup() should not follow
+- bpo-12464: tempfile.TemporaryDirectory.cleanup() should not follow
   symlinks: fix it. Patch by Petri Lehtinen.
 
-- Issue #8887: "pydoc somebuiltin.somemethod" (or help('somebuiltin.somemethod')
-  in Python code) now finds the doc of the method.
+- bpo-8887: "pydoc somebuiltin.somemethod" (or
+  help('somebuiltin.somemethod') in Python code) now finds the doc of the
+  method.
 
-- Issue #10968: Remove indirection in threading.  The public names (Event,
-  Condition, etc.) used to be factory functions returning instances of hidden
-  classes (_Event, _Condition, etc.), because (if Guido recalls correctly) this
-  code pre-dates the ability to subclass extension types.  It is now possible
-  to inherit from these classes, without having to import the private
-  underscored names like multiprocessing did.
+- bpo-10968: Remove indirection in threading.  The public names (Event,
+  Condition, etc.) used to be factory functions returning instances of
+  hidden classes (_Event, _Condition, etc.), because (if Guido recalls
+  correctly) this code pre-dates the ability to subclass extension types.
+  It is now possible to inherit from these classes, without having to import
+  the private underscored names like multiprocessing did.
 
-- Issue #9723: Add shlex.quote functions, to escape filenames and command
+- bpo-9723: Add shlex.quote functions, to escape filenames and command
   lines.
 
-- Issue #12603: Fix pydoc.synopsis() on files with non-negative st_mtime.
+- bpo-12603: Fix pydoc.synopsis() on files with non-negative st_mtime.
 
-- Issue #12514: Use try/finally to assure the timeit module restores garbage
+- bpo-12514: Use try/finally to assure the timeit module restores garbage
   collections when it is done.
 
-- Issue #12607: In subprocess, fix issue where if stdin, stdout or stderr is
+- bpo-12607: In subprocess, fix issue where if stdin, stdout or stderr is
   given as a low fd, it gets overwritten.
 
-- Issue #12576: Fix urlopen behavior on sites which do not send (or obfuscates)
+- bpo-12576: Fix urlopen behavior on sites which do not send (or obfuscates)
   ``Connection: close`` header.
 
-- Issue #12560: Build libpython.so on OpenBSD. Patch by Stefan Sperling.
+- bpo-12560: Build libpython.so on OpenBSD. Patch by Stefan Sperling.
 
-- Issue #1813: Fix codec lookup under Turkish locales.
+- bpo-1813: Fix codec lookup under Turkish locales.
 
-- Issue #12591: Improve support of "universal newlines" in the subprocess
+- bpo-12591: Improve support of "universal newlines" in the subprocess
   module: the piped streams can now be properly read from or written to.
 
-- Issue #12591: Allow io.TextIOWrapper to work with raw IO objects (without
-  a read1() method), and add a *write_through* parameter to mandate
-  unbuffered writes.
+- bpo-12591: Allow io.TextIOWrapper to work with raw IO objects (without a
+  read1() method), and add a *write_through* parameter to mandate unbuffered
+  writes.
 
-- Issue #10883: Fix socket leaks in urllib.request when using FTP.
+- bpo-10883: Fix socket leaks in urllib.request when using FTP.
 
-- Issue #12592: Make Python build on OpenBSD 5 (and future major releases).
+- bpo-12592: Make Python build on OpenBSD 5 (and future major releases).
 
-- Issue #12372: POSIX semaphores are broken on AIX: don't use them.
+- bpo-12372: POSIX semaphores are broken on AIX: don't use them.
 
-- Issue #12551: Provide a get_channel_binding() method on SSL sockets so as
-  to get channel binding data for the current SSL session (only the
-  "tls-unique" channel binding is implemented).  This allows the implementation
+- bpo-12551: Provide a get_channel_binding() method on SSL sockets so as to
+  get channel binding data for the current SSL session (only the "tls-
+  unique" channel binding is implemented).  This allows the implementation
   of certain authentication mechanisms such as SCRAM-SHA-1-PLUS.  Patch by
   Jacek Konieczny.
 
-- Issue #665194: email.utils now has format_datetime and parsedate_to_datetime
+- bpo-665194: email.utils now has format_datetime and parsedate_to_datetime
   functions, allowing for round tripping of RFC2822 format dates.
 
-- Issue #12571: Add a plat-linux3 directory mirroring the plat-linux2
-  directory, so that "import DLFCN" and other similar imports work on
-  Linux 3.0.
+- bpo-12571: Add a plat-linux3 directory mirroring the plat-linux2
+  directory, so that "import DLFCN" and other similar imports work on Linux
+  3.0.
 
-- Issue #7484: smtplib no longer puts <> around addresses in VRFY and EXPN
-  commands; they aren't required and in fact postfix doesn't support that form.
+- bpo-7484: smtplib no longer puts <> around addresses in VRFY and EXPN
+  commands; they aren't required and in fact postfix doesn't support that
+  form.
 
-- Issue #12273: Remove ast.__version__. AST changes can be accounted for by
+- bpo-12273: Remove ast.__version__. AST changes can be accounted for by
   checking sys.version_info or sys._mercurial.
 
 - Silence spurious "broken pipe" tracebacks when shutting down a
   ProcessPoolExecutor.
 
-- Fix potential resource leaks in concurrent.futures.ProcessPoolExecutor
-  by joining all queues and processes when shutdown() is called.
+- Fix potential resource leaks in concurrent.futures.ProcessPoolExecutor by
+  joining all queues and processes when shutdown() is called.
 
-- Issue #11603: Fix a crash when __str__ is rebound as __repr__.  Patch by
+- bpo-11603: Fix a crash when __str__ is rebound as __repr__.  Patch by
   Andreas Stührk.
 
-- Issue #11321: Fix a crash with multiple imports of the _pickle module when
+- bpo-11321: Fix a crash with multiple imports of the _pickle module when
   embedding Python.  Patch by Andreas Stührk.
 
-- Issue #6755: Add get_wch() method to curses.window class. Patch by Iñigo
+- bpo-6755: Add get_wch() method to curses.window class. Patch by Iñigo
   Serna.
 
 - Add cgi.closelog() function to close the log file.
 
-- Issue #12502: asyncore: fix polling loop with AF_UNIX sockets.
+- bpo-12502: asyncore: fix polling loop with AF_UNIX sockets.
 
-- Issue #4376: ctypes now supports nested structures in a endian different than
+- bpo-4376: ctypes now supports nested structures in a endian different than
   the parent structure. Patch by Vlad Riscutia.
 
 - Raise ValueError when attempting to set the _CHUNK_SIZE attribute of a
   TextIOWrapper to a huge value, not TypeError.
 
-- Issue #12504: Close file handles in a timely manner in packaging.database.
+- bpo-12504: Close file handles in a timely manner in packaging.database.
   This fixes a bug with the remove (uninstall) feature on Windows.
 
-- Issues #12169 and #10510: Factor out code used by various packaging commands
-  to make HTTP POST requests, and make sure it uses CRLF.
+- bpo-12169: Factor out code used by various packaging commands to make HTTP
+  POST requests, and make sure it uses CRLF. (See also: bpo-10510)
 
-- Issue #12016: Multibyte CJK decoders now resynchronize faster. They only
+- bpo-12016: Multibyte CJK decoders now resynchronize faster. They only
   ignore the first byte of an invalid byte sequence. For example,
-  b'\xff\n'.decode('gb2312', 'replace') gives '\ufffd\n' instead of '\ufffd'.
+  b'\xff\n'.decode('gb2312', 'replace') gives '\ufffd\n' instead of
+  '\ufffd'.
 
-- Issue #12459: time.sleep() now raises a ValueError if the sleep length is
+- bpo-12459: time.sleep() now raises a ValueError if the sleep length is
   negative, instead of an infinite sleep on Windows or raising an IOError on
   Linux for example, to have the same behaviour on all platforms.
 
-- Issue #12451: pydoc: html_getfile() now uses tokenize.open() to support
-  Python scripts using a encoding different than UTF-8 (read the coding cookie
-  of the script).
+- bpo-12451: pydoc: html_getfile() now uses tokenize.open() to support
+  Python scripts using a encoding different than UTF-8 (read the coding
+  cookie of the script).
 
-- Issue #12493: subprocess: Popen.communicate() now also handles EINTR errors
+- bpo-12493: subprocess: Popen.communicate() now also handles EINTR errors
   if the process has only one pipe.
 
-- Issue #12467: warnings: fix a race condition if a warning is emitted at
+- bpo-12467: warnings: fix a race condition if a warning is emitted at
   shutdown, if globals()['__file__'] is None.
 
-- Issue #12451: pydoc: importfile() now opens the Python script in binary mode,
+- bpo-12451: pydoc: importfile() now opens the Python script in binary mode,
   instead of text mode using the locale encoding, to avoid encoding issues.
 
-- Issue #12451: runpy: run_path() now opens the Python script in binary mode,
+- bpo-12451: runpy: run_path() now opens the Python script in binary mode,
   instead of text mode using the locale encoding, to support other encodings
   than UTF-8 (scripts using the coding cookie).
 
-- Issue #12451: xml.dom.pulldom: parse() now opens files in binary mode instead
+- bpo-12451: xml.dom.pulldom: parse() now opens files in binary mode instead
   of the text mode (using the locale encoding) to avoid encoding issues.
 
-- Issue #12147: Adjust the new-in-3.2 smtplib.send_message method for better
+- bpo-12147: Adjust the new-in-3.2 smtplib.send_message method for better
   conformance to the RFCs: correctly handle Sender and Resent- headers.
 
-- Issue #12352: Fix a deadlock in multiprocessing.Heap when a block is freed by
+- bpo-12352: Fix a deadlock in multiprocessing.Heap when a block is freed by
   the garbage collector while the Heap lock is held.
 
-- Issue #12462: time.sleep() now immediately calls the (Python) signal handler
+- bpo-12462: time.sleep() now immediately calls the (Python) signal handler
   if it is interrupted by a signal, instead of having to wait until the next
   instruction.
 
-- Issue #12442: new shutil.disk_usage function, providing total, used and free
+- bpo-12442: new shutil.disk_usage function, providing total, used and free
   disk space statistics.
 
-- Issue #12451: The XInclude default loader of xml.etree now decodes files from
-  UTF-8 instead of the locale encoding if the encoding is not specified. It now
-  also opens XML files for the parser in binary mode instead of the text mode
-  to avoid encoding issues.
+- bpo-12451: The XInclude default loader of xml.etree now decodes files from
+  UTF-8 instead of the locale encoding if the encoding is not specified. It
+  now also opens XML files for the parser in binary mode instead of the text
+  mode to avoid encoding issues.
 
-- Issue #12451: doctest.debug_script() doesn't create a temporary file
-  anymore to avoid encoding issues.
+- bpo-12451: doctest.debug_script() doesn't create a temporary file anymore
+  to avoid encoding issues.
 
-- Issue #12451: pydoc.synopsis() now reads the encoding cookie if available,
-  to read the Python script from the right encoding.
+- bpo-12451: pydoc.synopsis() now reads the encoding cookie if available, to
+  read the Python script from the right encoding.
 
-- Issue #12451: distutils now opens the setup script in binary mode to read the
+- bpo-12451: distutils now opens the setup script in binary mode to read the
   encoding cookie, instead of opening it in UTF-8.
 
-- Issue #9516: On Mac OS X, change Distutils to no longer globally attempt to
+- bpo-9516: On Mac OS X, change Distutils to no longer globally attempt to
   check or set the MACOSX_DEPLOYMENT_TARGET environment variable for the
-  interpreter process.  This could cause failures in non-Distutils subprocesses
-  and was unreliable since tests or user programs could modify the interpreter
-  environment after Distutils set it.  Instead, have Distutils set the
-  deployment target only in the environment of each build subprocess.  It is
-  still possible to globally override the default by setting
-  MACOSX_DEPLOYMENT_TARGET before launching the interpreter; its value must be
-  greater or equal to the default value, the value with which the interpreter
-  was built.  Also, implement the same handling in packaging.
-
-- Issue #12422: In the copy module, don't store objects that are their own copy
+  interpreter process.  This could cause failures in non-Distutils
+  subprocesses and was unreliable since tests or user programs could modify
+  the interpreter environment after Distutils set it.  Instead, have
+  Distutils set the deployment target only in the environment of each build
+  subprocess.  It is still possible to globally override the default by
+  setting MACOSX_DEPLOYMENT_TARGET before launching the interpreter; its
+  value must be greater or equal to the default value, the value with which
+  the interpreter was built.  Also, implement the same handling in
+  packaging.
+
+- bpo-12422: In the copy module, don't store objects that are their own copy
   in the memo dict.
 
-- Issue #12303: Add sigwaitinfo() and sigtimedwait() to the signal module.
+- bpo-12303: Add sigwaitinfo() and sigtimedwait() to the signal module.
 
-- Issue #12404: Remove C89 incompatible code from mmap module. Patch by Akira
+- bpo-12404: Remove C89 incompatible code from mmap module. Patch by Akira
   Kitada.
 
-- Issue #1874: email now detects and reports as a defect the presence of
-  any CTE other than 7bit, 8bit, or binary on a multipart.
+- bpo-1874: email now detects and reports as a defect the presence of any
+  CTE other than 7bit, 8bit, or binary on a multipart.
 
-- Issue #12383: Fix subprocess module with env={}: don't copy the environment
+- bpo-12383: Fix subprocess module with env={}: don't copy the environment
   variables, start with an empty environment.
 
-- Issue #11637: Fix support for importing packaging setup hooks from the
+- bpo-11637: Fix support for importing packaging setup hooks from the
   project directory.
 
-- Issue #6771: Moved the curses.wrapper function from the single-function
+- bpo-6771: Moved the curses.wrapper function from the single-function
   wrapper module into __init__, eliminating the module.  Since __init__ was
   already importing the function to curses.wrapper, there is no API change.
 
-- Issue #11584: email.header.decode_header no longer fails if the header
-  passed to it is a Header object, and Header/make_header no longer fail
-  if given binary unknown-8bit input.
+- bpo-11584: email.header.decode_header no longer fails if the header passed
+  to it is a Header object, and Header/make_header no longer fail if given
+  binary unknown-8bit input.
 
-- Issue #11700: mailbox proxy object close methods can now be called multiple
+- bpo-11700: mailbox proxy object close methods can now be called multiple
   times without error.
 
-- Issue #11767: Correct file descriptor leak in mailbox's __getitem__ method.
+- bpo-11767: Correct file descriptor leak in mailbox's __getitem__ method.
 
-- Issue #12133: AbstractHTTPHandler.do_open() of urllib.request closes the HTTP
+- bpo-12133: AbstractHTTPHandler.do_open() of urllib.request closes the HTTP
   connection if its getresponse() method fails with a socket error. Patch
   written by Ezio Melotti.
 
-- Issue #12240: Allow multiple setup hooks in packaging's setup.cfg files.
+- bpo-12240: Allow multiple setup hooks in packaging's setup.cfg files.
   Original patch by Erik Bray.
 
-- Issue #9284: Allow inspect.findsource() to find the source of doctest
+- bpo-9284: Allow inspect.findsource() to find the source of doctest
   functions.
 
-- Issue #11595: Fix assorted bugs in packaging.util.cfg_to_args, a
-  compatibility helper for the distutils-packaging transition.  Original patch
-  by Erik Bray.
+- bpo-11595: Fix assorted bugs in packaging.util.cfg_to_args, a
+  compatibility helper for the distutils-packaging transition.  Original
+  patch by Erik Bray.
 
-- Issue #12287: In ossaudiodev, check that the device isn't closed in several
+- bpo-12287: In ossaudiodev, check that the device isn't closed in several
   methods.
 
-- Issue #12009: Fixed regression in netrc file comment handling.
+- bpo-12009: Fixed regression in netrc file comment handling.
 
-- Issue #12246: Warn and fail when trying to install a third-party project from
+- bpo-12246: Warn and fail when trying to install a third-party project from
   an uninstalled Python (built in a source checkout).  Original patch by
   Tshepang Lekhonkhobe.
 
-- Issue #10694: zipfile now ignores garbage at the end of a zipfile.
+- bpo-10694: zipfile now ignores garbage at the end of a zipfile.
 
-- Issue #12283: Fixed regression in smtplib quoting of leading dots in DATA.
+- bpo-12283: Fixed regression in smtplib quoting of leading dots in DATA.
 
-- Issue #10424: Argparse now includes the names of the missing required
+- bpo-10424: Argparse now includes the names of the missing required
   arguments in the missing arguments error message.
 
-- Issue #12168: SysLogHandler now allows NUL termination to be controlled using
+- bpo-12168: SysLogHandler now allows NUL termination to be controlled using
   a new 'append_nul' attribute on the handler.
 
-- Issue #11583: Speed up os.path.isdir on Windows by using GetFileAttributes
+- bpo-11583: Speed up os.path.isdir on Windows by using GetFileAttributes
   instead of os.stat.
 
-- Issue #12021: Make mmap's read() method argument optional. Patch by Petri
+- bpo-12021: Make mmap's read() method argument optional. Patch by Petri
   Lehtinen.
 
-- Issue #9205: concurrent.futures.ProcessPoolExecutor now detects killed
+- bpo-9205: concurrent.futures.ProcessPoolExecutor now detects killed
   children and raises BrokenProcessPool in such a situation.  Previously it
   would reliably freeze/deadlock.
 
-- Issue #12040: Expose a new attribute ``sentinel`` on instances of
+- bpo-12040: Expose a new attribute ``sentinel`` on instances of
   ``multiprocessing.Process``.  Also, fix Process.join() to not use polling
   anymore, when given a timeout.
 
-- Issue #11893: Remove obsolete internal wrapper class ``SSLFakeFile`` in the
+- bpo-11893: Remove obsolete internal wrapper class ``SSLFakeFile`` in the
   smtplib module.  Patch by Catalin Iacob.
 
-- Issue #12080: Fix a Decimal.power() case that took an unreasonably long time
+- bpo-12080: Fix a Decimal.power() case that took an unreasonably long time
   to compute.
 
-- Issue #12221: Remove __version__ attributes from pyexpat, pickle, tarfile,
+- bpo-12221: Remove __version__ attributes from pyexpat, pickle, tarfile,
   pydoc, tkinter, and xml.parsers.expat. This were useless version constants
   left over from the Mercurial transition
 
 - Named tuples now work correctly with vars().
 
-- Issue #12085: Fix an attribute error in subprocess.Popen destructor if the
-  constructor has failed, e.g. because of an undeclared keyword argument. Patch
-  written by Oleg Oshmyan.
+- bpo-12085: Fix an attribute error in subprocess.Popen destructor if the
+  constructor has failed, e.g. because of an undeclared keyword argument.
+  Patch written by Oleg Oshmyan.
 
-- Issue #12028: Make threading._get_ident() public, rename it to
-  threading.get_ident() and document it. This function was already used using
-  _thread.get_ident().
+- bpo-12028: Make threading._get_ident() public, rename it to
+  threading.get_ident() and document it. This function was already used
+  using _thread.get_ident().
 
-- Issue #12171: IncrementalEncoder.reset() of CJK codecs (multibytecodec) calls
+- bpo-12171: IncrementalEncoder.reset() of CJK codecs (multibytecodec) calls
   encreset() instead of decreset().
 
-- Issue #12218: Removed wsgiref.egg-info.
+- bpo-12218: Removed wsgiref.egg-info.
 
-- Issue #12196: Add pipe2() to the os module.
+- bpo-12196: Add pipe2() to the os module.
 
-- Issue #985064: Make plistlib more resilient to faulty input plists.
-  Patch by Mher Movsisyan.
+- bpo-985064: Make plistlib more resilient to faulty input plists. Patch by
+  Mher Movsisyan.
 
-- Issue #1625: BZ2File and bz2.decompress() now support multi-stream files.
+- bpo-1625: BZ2File and bz2.decompress() now support multi-stream files.
   Initial patch by Nir Aides.
 
-- Issue #12175: BufferedReader.read(-1) now calls raw.readall() if available.
+- bpo-12175: BufferedReader.read(-1) now calls raw.readall() if available.
 
-- Issue #12175: FileIO.readall() now only reads the file position and size
+- bpo-12175: FileIO.readall() now only reads the file position and size
   once.
 
-- Issue #12175: RawIOBase.readall() now returns None if read() returns None.
+- bpo-12175: RawIOBase.readall() now returns None if read() returns None.
 
-- Issue #12175: FileIO.readall() now raises a ValueError instead of an IOError
+- bpo-12175: FileIO.readall() now raises a ValueError instead of an IOError
   if the file is closed.
 
-- Issue #11109: New service_action method for BaseServer, used by ForkingMixin
+- bpo-11109: New service_action method for BaseServer, used by ForkingMixin
   class for cleanup. Initial Patch by Justin Warkentin.
 
-- Issue #12045: Avoid duplicate execution of command in
+- bpo-12045: Avoid duplicate execution of command in
   ctypes.util._get_soname().  Patch by Sijin Joseph.
 
-- Issue #10818: Remove the Tk GUI and the serve() function of the pydoc module,
+- bpo-10818: Remove the Tk GUI and the serve() function of the pydoc module,
   pydoc -g has been deprecated in Python 3.2 and it has a new enhanced web
   server.
 
-- Issue #1441530: In imaplib, read the data in one chunk to speed up large
+- bpo-1441530: In imaplib, read the data in one chunk to speed up large
   reads and simplify code.
 
-- Issue #12070: Fix the Makefile parser of the sysconfig module to handle
+- bpo-12070: Fix the Makefile parser of the sysconfig module to handle
   correctly references to "bogus variable" (e.g. "prefix=$/opt/python").
 
-- Issue #12100: Don't reset incremental encoders of CJK codecs at each call to
-  their encode() method anymore, but continue to call the reset() method if the
-  final argument is True.
+- bpo-12100: Don't reset incremental encoders of CJK codecs at each call to
+  their encode() method anymore, but continue to call the reset() method if
+  the final argument is True.
 
-- Issue #12049: Add RAND_bytes() and RAND_pseudo_bytes() functions to the ssl
+- bpo-12049: Add RAND_bytes() and RAND_pseudo_bytes() functions to the ssl
   module.
 
-- Issue #6501: os.device_encoding() returns None on Windows if the application
+- bpo-6501: os.device_encoding() returns None on Windows if the application
   has no console.
 
-- Issue #12105: Add O_CLOEXEC to the os module.
+- bpo-12105: Add O_CLOEXEC to the os module.
 
-- Issue #12079: Decimal('Infinity').fma(Decimal('0'), (3.91224318126786e+19+0j))
-  now raises TypeError (reflecting the invalid type of the 3rd argument) rather
-  than Decimal.InvalidOperation.
+- bpo-12079: Decimal('Infinity').fma(Decimal('0'),
+  (3.91224318126786e+19+0j)) now raises TypeError (reflecting the invalid
+  type of the 3rd argument) rather than Decimal.InvalidOperation.
 
-- Issue #12124: zipimport doesn't keep a reference to zlib.decompress() anymore
+- bpo-12124: zipimport doesn't keep a reference to zlib.decompress() anymore
   to be able to unload the module.
 
 - Add the packaging module, an improved fork of distutils (also known as
   distutils2).
 
-- Issue #12065: connect_ex() on an SSL socket now returns the original errno
+- bpo-12065: connect_ex() on an SSL socket now returns the original errno
   when the socket's timeout expires (it used to return None).
 
-- Issue #8809: The SMTP_SSL constructor and SMTP.starttls() now support
-  passing a ``context`` argument pointing to an ssl.SSLContext instance.
-  Patch by Kasun Herath.
+- bpo-8809: The SMTP_SSL constructor and SMTP.starttls() now support passing
+  a ``context`` argument pointing to an ssl.SSLContext instance. Patch by
+  Kasun Herath.
 
-- Issue #9516: Issue #9516: avoid errors in sysconfig when MACOSX_DEPLOYMENT_TARGET
-  is set in shell.
+- bpo-9516: avoid errors in sysconfig when MACOSX_DEPLOYMENT_TARGET is set
+  in shell. (See also: bpo-9516)
 
-- Issue #8650: Make zlib module 64-bit clean. compress(), decompress() and
+- bpo-8650: Make zlib module 64-bit clean. compress(), decompress() and
   their incremental counterparts now raise OverflowError if given an input
-  larger than 4GB, instead of silently truncating the input and returning
-  an incorrect result.
+  larger than 4GB, instead of silently truncating the input and returning an
+  incorrect result.
 
-- Issue #12050: zlib.decompressobj().decompress() now clears the unconsumed_tail
-  attribute when called without a max_length argument.
+- bpo-12050: zlib.decompressobj().decompress() now clears the
+  unconsumed_tail attribute when called without a max_length argument.
 
-- Issue #12062: Fix a flushing bug when doing a certain type of I/O sequence
-  on a file opened in read+write mode (namely: reading, seeking a bit forward,
+- bpo-12062: Fix a flushing bug when doing a certain type of I/O sequence on
+  a file opened in read+write mode (namely: reading, seeking a bit forward,
   writing, then seeking before the previous write but still within buffered
   data, and writing again).
 
-- Issue #9971: Write an optimized implementation of BufferedReader.readinto().
+- bpo-9971: Write an optimized implementation of BufferedReader.readinto().
   Patch by John O'Connor.
 
-- Issue #11799: urllib.request Authentication Handlers will raise a ValueError
-  when presented with an unsupported Authentication Scheme. Patch contributed
-  by Yuval Greenfield.
+- bpo-11799: urllib.request Authentication Handlers will raise a ValueError
+  when presented with an unsupported Authentication Scheme. Patch
+  contributed by Yuval Greenfield.
 
-- Issue #10419, #6011: build_scripts command of distutils handles correctly
-  non-ASCII path (path to the Python executable). Open and write the script in
-  binary mode, but ensure that the shebang is decodable from UTF-8 and from the
-  encoding of the script.
+- bpo-10419: build_scripts command of distutils handles correctly non-ASCII
+  path (path to the Python executable). Open and write the script in binary
+  mode, but ensure that the shebang is decodable from UTF-8 and from the
+  encoding of the script. (See also: bpo-6011)
 
-- Issue #8498: In socket.accept(), allow to specify 0 as a backlog value in
+- bpo-8498: In socket.accept(), allow to specify 0 as a backlog value in
   order to accept exactly one connection.  Patch by Daniel Evers.
 
-- Issue #12011: signal.signal() and signal.siginterrupt() raise an OSError,
+- bpo-12011: signal.signal() and signal.siginterrupt() raise an OSError,
   instead of a RuntimeError: OSError has an errno attribute.
 
-- Issue #3709: add a flush_headers method to BaseHTTPRequestHandler, which
+- bpo-3709: add a flush_headers method to BaseHTTPRequestHandler, which
   manages the sending of headers to output stream and flushing the internal
   headers buffer. Patch contribution by Andrew Schaaf
 
-- Issue #11743: Rewrite multiprocessing connection classes in pure Python.
+- bpo-11743: Rewrite multiprocessing connection classes in pure Python.
 
-- Issue #11164: Stop trying to use _xmlplus in the xml module.
+- bpo-11164: Stop trying to use _xmlplus in the xml module.
 
-- Issue #11888: Add log2 function to math module. Patch written by Mark
+- bpo-11888: Add log2 function to math module. Patch written by Mark
   Dickinson.
 
-- Issue #12012: ssl.PROTOCOL_SSLv2 becomes optional.
+- bpo-12012: ssl.PROTOCOL_SSLv2 becomes optional.
 
-- Issue #8407: The signal handler writes the signal number as a single byte
-  instead of a nul byte into the wakeup file descriptor. So it is possible to
-  wait more than one signal and know which signals were raised.
+- bpo-8407: The signal handler writes the signal number as a single byte
+  instead of a nul byte into the wakeup file descriptor. So it is possible
+  to wait more than one signal and know which signals were raised.
 
-- Issue #8407: Add pthread_kill(), sigpending() and sigwait() functions to the
+- bpo-8407: Add pthread_kill(), sigpending() and sigwait() functions to the
   signal module.
 
-- Issue #11927: SMTP_SSL now uses port 465 by default as documented.  Patch
-  by Kasun Herath.
+- bpo-11927: SMTP_SSL now uses port 465 by default as documented.  Patch by
+  Kasun Herath.
 
-- Issue #12002: ftplib's abort() method raises TypeError.
+- bpo-12002: ftplib's abort() method raises TypeError.
 
-- Issue #11916: Add a number of MacOSX specific definitions to the errno module.
-  Patch by Pierre Carrier.
+- bpo-11916: Add a number of MacOSX specific definitions to the errno
+  module. Patch by Pierre Carrier.
 
-- Issue #11999: fixed sporadic sync failure mailbox.Maildir due to its trying to
-  detect mtime changes by comparing to the system clock instead of to the
+- bpo-11999: fixed sporadic sync failure mailbox.Maildir due to its trying
+  to detect mtime changes by comparing to the system clock instead of to the
   previous value of the mtime.
 
-- Issue #11072: added MLSD command (RFC-3659) support to ftplib.
+- bpo-11072: added MLSD command (RFC-3659) support to ftplib.
 
-- Issue #8808: The IMAP4_SSL constructor now allows passing an SSLContext
+- bpo-8808: The IMAP4_SSL constructor now allows passing an SSLContext
   parameter to control parameters of the secure channel.  Patch by Sijin
   Joseph.
 
-- ntpath.samefile failed to notice that "a.txt" and "A.TXT" refer to the same
-  file on Windows XP. As noticed in issue #10684.
+- ntpath.samefile failed to notice that "a.txt" and "A.TXT" refer to the
+  same file on Windows XP. As noticed in issue #10684.
 
-- Issue #12000: When a SSL certificate has a subjectAltName without any
-  dNSName entry, ssl.match_hostname() should use the subject's commonName.
-  Patch by Nicolas Bareil.
+- bpo-12000: When a SSL certificate has a subjectAltName without any dNSName
+  entry, ssl.match_hostname() should use the subject's commonName. Patch by
+  Nicolas Bareil.
 
-- Issue #10775: assertRaises, assertRaisesRegex, assertWarns, and
+- bpo-10775: assertRaises, assertRaisesRegex, assertWarns, and
   assertWarnsRegex now accept a keyword argument 'msg' when used as context
   managers.  Initial patch by Winston Ewert.
 
-- Issue #10684: shutil.move used to delete a folder on case insensitive
-  filesystems when the source and destination name where the same except
-  for the case.
+- bpo-10684: shutil.move used to delete a folder on case insensitive
+  filesystems when the source and destination name where the same except for
+  the case.
 
-- Issue #11647: objects created using contextlib.contextmanager now support
+- bpo-11647: objects created using contextlib.contextmanager now support
   more than one call to the function when used as a decorator. Initial patch
   by Ysj Ray.
 
-- Issue #11930: Removed deprecated time.accept2dyear variable.
-  Removed year >= 1000 restriction from datetime.strftime.
+- bpo-11930: Removed deprecated time.accept2dyear variable. Removed year >=
+  1000 restriction from datetime.strftime.
 
 - logging: don't define QueueListener if Python has no thread support.
 
 - functools.cmp_to_key() now works with collections.Hashable().
 
-- Issue #11277: mmap.mmap() calls fcntl(fd, F_FULLFSYNC) on Mac OS X to get
-  around a mmap bug with sparse files. Patch written by Steffen Daode Nurpmeso.
+- bpo-11277: mmap.mmap() calls fcntl(fd, F_FULLFSYNC) on Mac OS X to get
+  around a mmap bug with sparse files. Patch written by Steffen Daode
+  Nurpmeso.
 
-- Issue #8407: Add signal.pthread_sigmask() function to fetch and/or change the
+- bpo-8407: Add signal.pthread_sigmask() function to fetch and/or change the
   signal mask of the calling thread.
 
-- Issue #11858: configparser.ExtendedInterpolation expected lower-case section
+- bpo-11858: configparser.ExtendedInterpolation expected lower-case section
   names.
 
-- Issue #11324: ConfigParser(interpolation=None) now works correctly.
+- bpo-11324: ConfigParser(interpolation=None) now works correctly.
 
-- Issue #11811: ssl.get_server_certificate() is now IPv6-compatible.  Patch
-  by Charles-François Natali.
+- bpo-11811: ssl.get_server_certificate() is now IPv6-compatible.  Patch by
+  Charles- François Natali.
 
-- Issue #11763: don't use difflib in TestCase.assertMultiLineEqual if the
+- bpo-11763: don't use difflib in TestCase.assertMultiLineEqual if the
   strings are too long.
 
-- Issue #11236: getpass.getpass responds to ctrl-c or ctrl-z on terminal.
+- bpo-11236: getpass.getpass responds to ctrl-c or ctrl-z on terminal.
 
-- Issue #11856: Speed up parsing of JSON numbers.
+- bpo-11856: Speed up parsing of JSON numbers.
 
-- Issue #11005: threading.RLock()._release_save() raises a RuntimeError if the
+- bpo-11005: threading.RLock()._release_save() raises a RuntimeError if the
   lock was not acquired.
 
-- Issue #11258: Speed up ctypes.util.find_library() under Linux by a factor
-  of 5 to 10.  Initial patch by Jonas H.
+- bpo-11258: Speed up ctypes.util.find_library() under Linux by a factor of
+  5 to 10. Initial patch by Jonas H.
 
-- Issue #11382: Trivial system calls, such as dup() or pipe(), needn't
-  release the GIL.  Patch by Charles-François Natali.
+- bpo-11382: Trivial system calls, such as dup() or pipe(), needn't release
+  the GIL. Patch by Charles-François Natali.
 
-- Issue #11223: Add threading._info() function providing informations about
-  the thread implementation.
+- bpo-11223: Add threading._info() function providing informations about the
+  thread implementation.
 
-- Issue #11731: simplify/enhance email parser/generator API by introducing
+- bpo-11731: simplify/enhance email parser/generator API by introducing
   policy objects.
 
-- Issue #11768: The signal handler of the signal module only calls
+- bpo-11768: The signal handler of the signal module only calls
   Py_AddPendingCall() for the first signal to fix a deadlock on reentrant or
   parallel calls. PyErr_SetInterrupt() writes also into the wake up file.
 
-- Issue #11492: fix several issues with header folding in the email package.
+- bpo-11492: fix several issues with header folding in the email package.
 
-- Issue #11852: Add missing imports and update tests.
+- bpo-11852: Add missing imports and update tests.
 
-- Issue #11875: collections.OrderedDict's __reduce__ was temporarily
-  mutating the object instead of just working on a copy.
+- bpo-11875: collections.OrderedDict's __reduce__ was temporarily mutating
+  the object instead of just working on a copy.
 
-- Issue #11467: Fix urlparse behavior when handling urls which contains scheme
+- bpo-11467: Fix urlparse behavior when handling urls which contains scheme
   specific part only digits. Patch by Santoso Wijaya.
 
 - collections.Counter().copy() now works correctly for subclasses.
 
-- Issue #11474: Fix the bug with url2pathname() handling of '/C|/' on Windows.
+- bpo-11474: Fix the bug with url2pathname() handling of '/C|/' on Windows.
   Patch by Santoso Wijaya.
 
-- Issue #11684: complete email.parser bytes API by adding BytesHeaderParser.
+- bpo-11684: complete email.parser bytes API by adding BytesHeaderParser.
 
 - The bz2 module now handles 4GiB+ input buffers correctly.
 
-- Issue #9233: Fix json.loads('{}') to return a dict (instead of a list), when
+- bpo-9233: Fix json.loads('{}') to return a dict (instead of a list), when
   _json is not available.
 
-- Issue #11830: Remove unnecessary introspection code in the decimal module.
+- bpo-11830: Remove unnecessary introspection code in the decimal module.
 
-- Issue #11703: urllib2.geturl() does not return correct url when the original
+- bpo-11703: urllib2.geturl() does not return correct url when the original
   url contains #fragment.
 
-- Issue #10019: Fixed regression in json module where an indent of 0 stopped
+- bpo-10019: Fixed regression in json module where an indent of 0 stopped
   adding newlines and acted instead like 'None'.
 
-- Issue #11186: pydoc ignores a module if its name contains a surrogate
+- bpo-11186: pydoc ignores a module if its name contains a surrogate
   character in the index of modules.
 
-- Issue #11815: Use a light-weight SimpleQueue for the result queue in
+- bpo-11815: Use a light-weight SimpleQueue for the result queue in
   concurrent.futures.ProcessPoolExecutor.
 
-- Issue #5162: Treat services like frozen executables to allow child spawning
+- bpo-5162: Treat services like frozen executables to allow child spawning
   from multiprocessing.forking on Windows.
 
 - logging.basicConfig now supports an optional 'handlers' argument taking an
   iterable of handlers to be added to the root logger. Additional parameter
   checks were also added to basicConfig.
 
-- Issue #11814: Fix likely typo in multiprocessing.Pool._terminate().
+- bpo-11814: Fix likely typo in multiprocessing.Pool._terminate().
 
-- Issue #11747: Fix range formatting in difflib.context_diff() and
+- bpo-11747: Fix range formatting in difflib.context_diff() and
   difflib.unified_diff().
 
-- Issue #8428: Fix a race condition in multiprocessing.Pool when terminating
+- bpo-8428: Fix a race condition in multiprocessing.Pool when terminating
   worker processes: new processes would be spawned while the pool is being
-  shut down.  Patch by Charles-François Natali.
+  shut down. Patch by Charles-François Natali.
 
-- Issue #2650: re.escape() no longer escapes the '_'.
+- bpo-2650: re.escape() no longer escapes the '_'.
 
-- Issue #11757: select.select() now raises ValueError when a negative timeout
+- bpo-11757: select.select() now raises ValueError when a negative timeout
   is passed (previously, a select.error with EINVAL would be raised).  Patch
-  by Charles-François Natali.
+  by Charles- François Natali.
 
-- Issue #7311: fix html.parser to accept non-ASCII attribute values.
+- bpo-7311: fix html.parser to accept non-ASCII attribute values.
 
-- Issue #11605: email.parser.BytesFeedParser was incorrectly converting
-  multipart subparts with an 8-bit CTE into unicode instead of preserving the
-  bytes.
+- bpo-11605: email.parser.BytesFeedParser was incorrectly converting
+  multipart subparts with an 8-bit CTE into unicode instead of preserving
+  the bytes.
 
-- Issue #1690608: email.util.formataddr is now RFC 2047 aware: it now has a
-  charset parameter that defaults to utf-8 and is used as the charset for RFC
-  2047 encoding when the realname contains non-ASCII characters.
+- bpo-1690608: email.util.formataddr is now RFC 2047 aware: it now has a
+  charset parameter that defaults to utf-8 and is used as the charset for
+  RFC 2047 encoding when the realname contains non-ASCII characters.
 
-- Issue #10963: Ensure that subprocess.communicate() never raises EPIPE.
+- bpo-10963: Ensure that subprocess.communicate() never raises EPIPE.
 
-- Issue #10791: Implement missing method GzipFile.read1(), allowing GzipFile
-  to be wrapped in a TextIOWrapper.  Patch by Nadeem Vawda.
+- bpo-10791: Implement missing method GzipFile.read1(), allowing GzipFile to
+  be wrapped in a TextIOWrapper.  Patch by Nadeem Vawda.
 
-- Issue #11707: Added a fast C version of functools.cmp_to_key().
-  Patch by Filip Gruszczyński.
+- bpo-11707: Added a fast C version of functools.cmp_to_key(). Patch by
+  Filip Gruszczyński.
 
-- Issue #11688: Add sqlite3.Connection.set_trace_callback().  Patch by
-  Torsten Landschoff.
+- bpo-11688: Add sqlite3.Connection.set_trace_callback().  Patch by Torsten
+  Landschoff.
 
-- Issue #11746: Fix SSLContext.load_cert_chain() to accept elliptic curve
+- bpo-11746: Fix SSLContext.load_cert_chain() to accept elliptic curve
   private keys.
 
-- Issue #5863: Rewrite BZ2File in pure Python, and allow it to accept
-  file-like objects using a new ``fileobj`` constructor argument.  Patch by
-  Nadeem Vawda.
+- bpo-5863: Rewrite BZ2File in pure Python, and allow it to accept file-like
+  objects using a new ``fileobj`` constructor argument.  Patch by Nadeem
+  Vawda.
 
 - unittest.TestCase.assertSameElements has been removed.
 
-- sys.getfilesystemencoding() raises a RuntimeError if initfsencoding() was not
-  called yet: detect bootstrap (startup) issues earlier.
+- sys.getfilesystemencoding() raises a RuntimeError if initfsencoding() was
+  not called yet: detect bootstrap (startup) issues earlier.
 
-- Issue #11393: Add the new faulthandler module.
+- bpo-11393: Add the new faulthandler module.
 
-- Issue #11618: Fix the timeout logic in threading.Lock.acquire() under Windows.
+- bpo-11618: Fix the timeout logic in threading.Lock.acquire() under
+  Windows.
 
 - Removed the 'strict' argument to email.parser.Parser, which has been
   deprecated since Python 2.4.
 
-- Issue #11256: Fix inspect.getcallargs on functions that take only keyword
+- bpo-11256: Fix inspect.getcallargs on functions that take only keyword
   arguments.
 
-- Issue #11696: Fix ID generation in msilib.
+- bpo-11696: Fix ID generation in msilib.
 
-- itertools.accumulate now supports an optional *func* argument for
-  a user-supplied binary function.
+- itertools.accumulate now supports an optional *func* argument for a user-
+  supplied binary function.
 
-- Issue #11692: Remove unnecessary demo functions in subprocess module.
+- bpo-11692: Remove unnecessary demo functions in subprocess module.
 
-- Issue #9696: Fix exception incorrectly raised by xdrlib.Packer.pack_int when
+- bpo-9696: Fix exception incorrectly raised by xdrlib.Packer.pack_int when
   trying to pack a negative (in-range) integer.
 
-- Issue #11675: multiprocessing.[Raw]Array objects created from an integer size
+- bpo-11675: multiprocessing.[Raw]Array objects created from an integer size
   are now zeroed on creation.  This matches the behaviour specified by the
   documentation.
 
-- Issue #7639: Fix short file name generation in bdist_msi
+- bpo-7639: Fix short file name generation in bdist_msi
 
-- Issue #11635: Don't use polling in worker threads and processes launched by
+- bpo-11635: Don't use polling in worker threads and processes launched by
   concurrent.futures.
 
-- Issue #5845: Automatically read readline configuration to enable completion
+- bpo-5845: Automatically read readline configuration to enable completion
   in interactive mode.
 
-- Issue #6811: Allow importlib to change a code object's co_filename attribute
-  to match the path to where the source code currently is, not where the code
-  object originally came from.
+- bpo-6811: Allow importlib to change a code object's co_filename attribute
+  to match the path to where the source code currently is, not where the
+  code object originally came from.
 
-- Issue #8754: Have importlib use the repr of a module name in error messages.
+- bpo-8754: Have importlib use the repr of a module name in error messages.
 
-- Issue #11591: Prevent "import site" from modifying sys.path when python
-  was started with -S.
+- bpo-11591: Prevent "import site" from modifying sys.path when python was
+  started with -S.
 
 - collections.namedtuple() now adds a _source attribute to the generated
-  class.  This make the source more accessible than the outdated
-  "verbose" option which prints to stdout but doesn't make the source
-  string available.
+  class.  This make the source more accessible than the outdated "verbose"
+  option which prints to stdout but doesn't make the source string
+  available.
 
-- Issue #11371: Mark getopt error messages as localizable.  Patch by Filip
+- bpo-11371: Mark getopt error messages as localizable.  Patch by Filip
   Gruszczyński.
 
-- Issue #11333: Add __slots__ to collections ABCs.
+- bpo-11333: Add __slots__ to collections ABCs.
 
-- Issue #11628: cmp_to_key generated class should use __slots__.
+- bpo-11628: cmp_to_key generated class should use __slots__.
 
-- Issue #11666: let help() display named tuple attributes and methods
-  that start with a leading underscore.
+- bpo-11666: let help() display named tuple attributes and methods that
+  start with a leading underscore.
 
-- Issue #11662: Make urllib and urllib2 ignore redirections if the
-  scheme is not HTTP, HTTPS or FTP (CVE-2011-1521).
+- bpo-11662: Make urllib and urllib2 ignore redirections if the scheme is
+  not HTTP, HTTPS or FTP (CVE-2011-1521).
 
-- Issue #5537: Fix time2isoz() and time2netscape() functions of
+- bpo-5537: Fix time2isoz() and time2netscape() functions of
   httplib.cookiejar for expiration year greater than 2038 on 32-bit systems.
 
-- Issue #4391: Use proper gettext plural forms in optparse.
+- bpo-4391: Use proper gettext plural forms in optparse.
 
-- Issue #11127: Raise a TypeError when trying to pickle a socket object.
+- bpo-11127: Raise a TypeError when trying to pickle a socket object.
 
-- Issue #11563: ``Connection: close`` header is sent by requests using URLOpener
-  class which helps in closing of sockets after connection is over. Patch
-  contributions by Jeff McNeil and Nadeem Vawda.
+- bpo-11563: ``Connection: close`` header is sent by requests using
+  URLOpener class which helps in closing of sockets after connection is
+  over. Patch contributions by Jeff McNeil and Nadeem Vawda.
 
-- Issue #11459: A ``bufsize`` value of 0 in subprocess.Popen() really creates
+- bpo-11459: A ``bufsize`` value of 0 in subprocess.Popen() really creates
   unbuffered pipes, such that select() works properly on them.
 
-- Issue #5421: Fix misleading error message when one of socket.sendto()'s
+- bpo-5421: Fix misleading error message when one of socket.sendto()'s
   arguments has the wrong type.  Patch by Nikita Vetoshkin.
 
-- Issue #10812: Add some extra posix functions to the os module.
+- bpo-10812: Add some extra posix functions to the os module.
 
-- Issue #10979: unittest stdout buffering now works with class and module
-  setup and teardown.
+- bpo-10979: unittest stdout buffering now works with class and module setup
+  and teardown.
 
-- Issue #11243: fix the parameter querying methods of Message to work if
-  the headers contain un-encoded non-ASCII data.
+- bpo-11243: fix the parameter querying methods of Message to work if the
+  headers contain un-encoded non-ASCII data.
 
-- Issue #11401: fix handling of headers with no value; this fixes a regression
+- bpo-11401: fix handling of headers with no value; this fixes a regression
   relative to Python2 and the result is now the same as it was in Python2.
 
-- Issue #9298: base64 bodies weren't being folded to line lengths less than 78,
+- bpo-9298: base64 bodies weren't being folded to line lengths less than 78,
   which was a regression relative to Python2.  Unlike Python2, the last line
   of the folded body now ends with a carriage return.
 
-- Issue #11560: shutil.unpack_archive now correctly handles the format
+- bpo-11560: shutil.unpack_archive now correctly handles the format
   parameter. Patch by Evan Dandrea.
 
-- Issue #5870: Add `subprocess.DEVNULL` constant.
+- bpo-5870: Add `subprocess.DEVNULL` constant.
 
-- Issue #11133: fix two cases where inspect.getattr_static can trigger code
+- bpo-11133: fix two cases where inspect.getattr_static can trigger code
   execution. Patch by Andreas Stührk.
 
-- Issue #11569: use absolute path to the sysctl command in multiprocessing to
+- bpo-11569: use absolute path to the sysctl command in multiprocessing to
   ensure that it will be found regardless of the shell PATH. This ensures
   that multiprocessing.cpu_count works on default installs of MacOSX.
 
-- Issue #11501: disutils.archive_utils.make_zipfile no longer fails if zlib is
-  not installed. Instead, the zipfile.ZIP_STORED compression is used to create
-  the ZipFile. Patch by Natalia B. Bidart.
+- bpo-11501: disutils.archive_utils.make_zipfile no longer fails if zlib is
+  not installed. Instead, the zipfile.ZIP_STORED compression is used to
+  create the ZipFile. Patch by Natalia B. Bidart.
 
-- Issue #11289: `smtp.SMTP` class is now a context manager so it can be used
-  in a `with` statement.  Contributed by Giampaolo Rodola.
+- bpo-11289: `smtp.SMTP` class is now a context manager so it can be used in
+  a `with` statement.  Contributed by Giampaolo Rodola.
 
-- Issue #11554: Fixed support for Japanese codecs; previously the body output
+- bpo-11554: Fixed support for Japanese codecs; previously the body output
   encoding was not done if euc-jp or shift-jis was specified as the charset.
 
-- Issue #11407: `TestCase.run` returns the result object used or created.
+- bpo-11407: `TestCase.run` returns the result object used or created.
   Contributed by Janathan Hartley.
 
-- Issue #11500: Fixed a bug in the OS X proxy bypass code for fully qualified
+- bpo-11500: Fixed a bug in the OS X proxy bypass code for fully qualified
   IP addresses in the proxy exception list.
 
-- Issue #11491: dbm.error is no longer raised when dbm.open is called with
-  the "n" as the flag argument and the file exists. The behavior matches
-  the documentation and general logic.
+- bpo-11491: dbm.error is no longer raised when dbm.open is called with the
+  "n" as the flag argument and the file exists. The behavior matches the
+  documentation and general logic.
 
-- Issue #1162477: Postel Principle adjustment to email date parsing: handle the
+- bpo-1162477: Postel Principle adjustment to email date parsing: handle the
   fact that some non-compliant MUAs use '.' instead of ':' in time specs.
 
-- Issue #11131: Fix sign of zero in decimal.Decimal plus and minus
-  operations when the rounding mode is ROUND_FLOOR.
+- bpo-11131: Fix sign of zero in decimal.Decimal plus and minus operations
+  when the rounding mode is ROUND_FLOOR.
 
-- Issue #9935: Speed up pickling of instances of user-defined classes.
+- bpo-9935: Speed up pickling of instances of user-defined classes.
 
-- Issue #5622: Fix curses.wrapper to raise correct exception if curses
+- bpo-5622: Fix curses.wrapper to raise correct exception if curses
   initialization fails.
 
-- Issue #11408: In threading.Lock.acquire(), only call gettimeofday() when
-  really necessary.  Patch by Charles-François Natali.
+- bpo-11408: In threading.Lock.acquire(), only call gettimeofday() when
+  really necessary. Patch by Charles-François Natali.
 
-- Issue #11391: Writing to a mmap object created with
+- bpo-11391: Writing to a mmap object created with
   ``mmap.PROT_READ|mmap.PROT_EXEC`` would segfault instead of raising a
   TypeError.  Patch by Charles-François Natali.
 
-- Issue #9795: add context manager protocol support for nntplib.NNTP class.
+- bpo-9795: add context manager protocol support for nntplib.NNTP class.
 
-- Issue #11306: mailbox in certain cases adapts to an inability to open
-  certain files in read-write mode.  Previously it detected this by
-  checking for EACCES, now it also checks for EROFS.
+- bpo-11306: mailbox in certain cases adapts to an inability to open certain
+  files in read-write mode.  Previously it detected this by checking for
+  EACCES, now it also checks for EROFS.
 
-- Issue #11265: asyncore now correctly handles EPIPE, EBADF and EAGAIN errors
+- bpo-11265: asyncore now correctly handles EPIPE, EBADF and EAGAIN errors
   on accept(), send() and recv().
 
-- Issue #11377: Deprecate platform.popen() and reimplement it with os.popen().
+- bpo-11377: Deprecate platform.popen() and reimplement it with os.popen().
 
-- Issue #8513: On UNIX, subprocess supports bytes command string.
+- bpo-8513: On UNIX, subprocess supports bytes command string.
 
-- Issue #10866: Add socket.sethostname().  Initial patch by Ross Lagerwall.
+- bpo-10866: Add socket.sethostname().  Initial patch by Ross Lagerwall.
 
-- Issue #11140: Lock.release() now raises a RuntimeError when attempting
-  to release an unacquired lock, as claimed in the threading documentation.
-  The _thread.error exception is now an alias of RuntimeError.  Patch by
-  Filip Gruszczyński.  Patch for _dummy_thread by Aymeric Augustin.
+- bpo-11140: Lock.release() now raises a RuntimeError when attempting to
+  release an unacquired lock, as claimed in the threading documentation. The
+  _thread.error exception is now an alias of RuntimeError.  Patch by Filip
+  Gruszczyński.  Patch for _dummy_thread by Aymeric Augustin.
 
-- Issue #8594: ftplib now provides a source_address parameter to specify which
+- bpo-8594: ftplib now provides a source_address parameter to specify which
   (address, port) to bind to before connecting.
 
-- Issue #11326: Add the missing connect_ex() implementation for SSL sockets,
+- bpo-11326: Add the missing connect_ex() implementation for SSL sockets,
   and make it work for non-blocking connects.
 
-- Issue #11297: Add collections.ChainMap().
+- bpo-11297: Add collections.ChainMap().
 
-- Issue #10755: Add the posix.flistdir() function.  Patch by Ross Lagerwall.
+- bpo-10755: Add the posix.flistdir() function.  Patch by Ross Lagerwall.
 
-- Issue #4761: Add the ``*at()`` family of functions (openat(), etc.) to the
-  posix module.  Patch by Ross Lagerwall.
+- bpo-4761: Add the ``*at()`` family of functions (openat(), etc.) to the
+  posix module. Patch by Ross Lagerwall.
 
-- Issue #7322: Trying to read from a socket's file-like object after a timeout
+- bpo-7322: Trying to read from a socket's file-like object after a timeout
   occurred now raises an error instead of silently losing data.
 
-- Issue #11291: poplib.POP no longer suppresses errors on quit().
+- bpo-11291: poplib.POP no longer suppresses errors on quit().
 
-- Issue #11177: asyncore's create_socket() arguments can now be omitted.
+- bpo-11177: asyncore's create_socket() arguments can now be omitted.
 
-- Issue #6064: Add a ``daemon`` keyword argument to the threading.Thread
-  and multiprocessing.Process constructors in order to override the
-  default behaviour of inheriting the daemonic property from the current
+- bpo-6064: Add a ``daemon`` keyword argument to the threading.Thread and
+  multiprocessing.Process constructors in order to override the default
+  behaviour of inheriting the daemonic property from the current
   thread/process.
 
-- Issue #10956: Buffered I/O classes retry reading or writing after a signal
+- bpo-10956: Buffered I/O classes retry reading or writing after a signal
   has arrived and the handler returned successfully.
 
-- Issue #10784: New os.getpriority() and os.setpriority() functions.
+- bpo-10784: New os.getpriority() and os.setpriority() functions.
 
-- Issue #11114: Fix catastrophic performance of tell() on text files (up
-  to 1000x faster in some cases).  It is still one to two order of magnitudes
+- bpo-11114: Fix catastrophic performance of tell() on text files (up to
+  1000x faster in some cases).  It is still one to two order of magnitudes
   slower than binary tell().
 
-- Issue #10882: Add os.sendfile function.
+- bpo-10882: Add os.sendfile function.
 
-- Issue #10868: Allow usage of the register method of an ABC as a class
+- bpo-10868: Allow usage of the register method of an ABC as a class
   decorator.
 
-- Issue #11224: Fixed a regression in tarfile that affected the file-like
+- bpo-11224: Fixed a regression in tarfile that affected the file-like
   objects returned by TarFile.extractfile() regarding performance, memory
   consumption and failures with the stream interface.
 
-- Issue #10924: Adding salt and Modular Crypt Format to crypt library.
-  Moved old C wrapper to _crypt, and added a Python wrapper with
-  enhanced salt generation and simpler API for password generation.
+- bpo-10924: Adding salt and Modular Crypt Format to crypt library. Moved
+  old C wrapper to _crypt, and added a Python wrapper with enhanced salt
+  generation and simpler API for password generation.
 
-- Issue #11074: Make 'tokenize' so it can be reloaded.
+- bpo-11074: Make 'tokenize' so it can be reloaded.
 
-- Issue #11085: Moved collections abstract base classes into a separate
-  module called collections.abc, following the pattern used by importlib.abc.
-  For backwards compatibility, the names are imported into the collections
+- bpo-11085: Moved collections abstract base classes into a separate module
+  called collections.abc, following the pattern used by importlib.abc. For
+  backwards compatibility, the names are imported into the collections
   module.
 
-- Issue #4681: Allow mmap() to work on file sizes and offsets larger than
-  4GB, even on 32-bit builds.  Initial patch by Ross Lagerwall, adapted for
+- bpo-4681: Allow mmap() to work on file sizes and offsets larger than 4GB,
+  even on 32-bit builds.  Initial patch by Ross Lagerwall, adapted for
   32-bit Windows.
 
-- Issue #11169: compileall module uses repr() to format filenames and paths to
+- bpo-11169: compileall module uses repr() to format filenames and paths to
   escape surrogate characters and show spaces.
 
-- Issue #11089: Fix performance issue limiting the use of ConfigParser()
-  with large config files.
+- bpo-11089: Fix performance issue limiting the use of ConfigParser() with
+  large config files.
 
-- Issue #10276: Fix the results of zlib.crc32() and zlib.adler32() on buffers
+- bpo-10276: Fix the results of zlib.crc32() and zlib.adler32() on buffers
   larger than 4GB.  Patch by Nadeem Vawda.
 
-- Issue #11388: Added a clear() method to MutableSequence
+- bpo-11388: Added a clear() method to MutableSequence
 
-- Issue #11174: Add argparse.MetavarTypeHelpFormatter, which uses type names
+- bpo-11174: Add argparse.MetavarTypeHelpFormatter, which uses type names
   for the names of optional and positional arguments in help messages.
 
-- Issue #9348: Raise an early error if argparse nargs and metavar don't match.
+- bpo-9348: Raise an early error if argparse nargs and metavar don't match.
 
-- Issue #9026: Fix order of argparse sub-commands in help messages.
+- bpo-9026: Fix order of argparse sub-commands in help messages.
 
-- Issue #9347: Fix formatting for tuples in argparse type= error messages.
+- bpo-9347: Fix formatting for tuples in argparse type= error messages.
 
-- Issue #12191: Added shutil.chown() to change user and/or group owner of a
+- bpo-12191: Added shutil.chown() to change user and/or group owner of a
   given path also specifying their names.
 
-- Issue #13988: The _elementtree accelerator is used whenever available.
-  Now xml.etree.cElementTree becomes a deprecated alias to ElementTree.
+- bpo-13988: The _elementtree accelerator is used whenever available. Now
+  xml.etree.cElementTree becomes a deprecated alias to ElementTree.
 
 Build
 -----
 
-- Issue #6807: Run msisupport.mak earlier.
+- bpo-6807: Run msisupport.mak earlier.
 
-- Issue #10580: Minor grammar change in Windows installer.
+- bpo-10580: Minor grammar change in Windows installer.
 
-- Issue #13326: Clean __pycache__ directories correctly on OpenBSD.
+- bpo-13326: Clean __pycache__ directories correctly on OpenBSD.
 
 - PEP 393: the configure option --with-wide-unicode is removed.
 
-- Issue #12852: Set _XOPEN_SOURCE to 700, instead of 600, to get POSIX 2008
+- bpo-12852: Set _XOPEN_SOURCE to 700, instead of 600, to get POSIX 2008
   functions on OpenBSD (e.g. fdopendir).
 
-- Issue #11863: Remove support for legacy systems deprecated in Python 3.2
-  (following PEP 11).  These systems are systems using Mach C Threads,
-  SunOS lightweight processes, GNU pth threads and IRIX threads.
+- bpo-11863: Remove support for legacy systems deprecated in Python 3.2
+  (following PEP 11).  These systems are systems using Mach C Threads, SunOS
+  lightweight processes, GNU pth threads and IRIX threads.
 
-- Issue #8746: Correct faulty configure checks so that os.chflags() and
-  os.lchflags() are once again built on systems that support these
-  functions (BSD and OS X).  Also add new stat file flags for OS X
-  (UF_HIDDEN and UF_COMPRESSED).
+- bpo-8746: Correct faulty configure checks so that os.chflags() and
+  os.lchflags() are once again built on systems that support these functions
+  (BSD and OS X). Also add new stat file flags for OS X (UF_HIDDEN and
+  UF_COMPRESSED).
 
-- Issue #10645: Installing Python no longer creates a
-  Python-X.Y.Z-pyX.Y.egg-info file in the lib-dynload directory.
+- bpo-10645: Installing Python no longer creates a Python-X.Y.Z-pyX.Y.egg-
+  info file in the lib-dynload directory.
 
 - Do not accidentally include the directory containing sqlite.h twice when
   building sqlite3.
 
-- Issue #11217: For 64-bit/32-bit Mac OS X universal framework builds,
-  ensure "make install" creates symlinks in --prefix bin for the "-32"
-  files in the framework bin directory like the installer does.
+- bpo-11217: For 64-bit/32-bit Mac OS X universal framework builds, ensure
+  "make install" creates symlinks in --prefix bin for the "-32" files in the
+  framework bin directory like the installer does.
 
-- Issue #11347: Use --no-as-needed when linking libpython3.so.
+- bpo-11347: Use --no-as-needed when linking libpython3.so.
 
-- Issue #11411: Fix 'make DESTDIR=' with a relative destination.
+- bpo-11411: Fix 'make DESTDIR=' with a relative destination.
 
-- Issue #11268: Prevent Mac OS X Installer failure if Documentation
-  package had previously been installed.
+- bpo-11268: Prevent Mac OS X Installer failure if Documentation package had
+  previously been installed.
 
-- Issue #11495: OSF support is eliminated. It was deprecated in Python 3.2.
+- bpo-11495: OSF support is eliminated. It was deprecated in Python 3.2.
 
 IDLE
 ----
 
-- Issue #14409: IDLE now properly executes commands in the Shell window
-  when it cannot read the normal config files on startup and
-  has to use the built-in default key bindings.
-  There was previously a bug in one of the defaults.
+- bpo-14409: IDLE now properly executes commands in the Shell window when it
+  cannot read the normal config files on startup and has to use the built-in
+  default key bindings. There was previously a bug in one of the defaults.
 
 - IDLE can be launched as python -m idlelib
 
-- Issue #3573: IDLE hangs when passing invalid command line args
+- bpo-3573: IDLE hangs when passing invalid command line args
   (directory(ies) instead of file(s)) (Patch by Guilherme Polo)
 
-- Issue #14200: IDLE shell crash on printing non-BMP unicode character.
+- bpo-14200: IDLE shell crash on printing non-BMP unicode character.
 
-- Issue #5219: Prevent event handler cascade in IDLE.
+- bpo-5219: Prevent event handler cascade in IDLE.
 
-- Issue #964437: Make IDLE help window non-modal.
-  Patch by Guilherme Polo and Roger Serwy.
+- bpo-964437: Make IDLE help window non-modal. Patch by Guilherme Polo and
+  Roger Serwy.
 
-- Issue #13933: IDLE auto-complete did not work with some imported
-  module, like hashlib.  (Patch by Roger Serwy)
+- bpo-13933: IDLE auto-complete did not work with some imported module, like
+  hashlib. (Patch by Roger Serwy)
 
-- Issue #13506: Add '' to path for IDLE Shell when started and restarted with Restart Shell.
-  Original patches by Marco Scataglini and Roger Serwy.
+- bpo-13506: Add '' to path for IDLE Shell when started and restarted with
+  Restart Shell. Original patches by Marco Scataglini and Roger Serwy.
 
-- Issue #4625: If IDLE cannot write to its recent file or breakpoint files,
+- bpo-4625: If IDLE cannot write to its recent file or breakpoint files,
   display a message popup and continue rather than crash.  Original patch by
   Roger Serwy.
 
-- Issue #8641: Update IDLE 3 syntax coloring to recognize b".." and not u"..".
+- bpo-8641: Update IDLE 3 syntax coloring to recognize b".." and not u"..".
   Patch by Tal Einat.
 
-- Issue #13296: Fix IDLE to clear compile __future__ flags on shell restart.
+- bpo-13296: Fix IDLE to clear compile __future__ flags on shell restart.
   (Patch by Roger Serwy)
 
-- Issue #9871: Prevent IDLE 3 crash when given byte stings
-  with invalid hex escape sequences, like b'\x0'.
-  (Original patch by Claudiu Popa.)
+- bpo-9871: Prevent IDLE 3 crash when given byte stings with invalid hex
+  escape sequences, like b'\x0'. (Original patch by Claudiu Popa.)
 
-- Issue #12636: IDLE reads the coding cookie when executing a Python script.
+- bpo-12636: IDLE reads the coding cookie when executing a Python script.
 
-- Issue #12540: Prevent zombie IDLE processes on Windows due to changes
-  in os.kill().
+- bpo-12540: Prevent zombie IDLE processes on Windows due to changes in
+  os.kill().
 
-- Issue #12590: IDLE editor window now always displays the first line
-  when opening a long file.  With Tk 8.5, the first line was hidden.
+- bpo-12590: IDLE editor window now always displays the first line when
+  opening a long file.  With Tk 8.5, the first line was hidden.
 
-- Issue #11088: don't crash when using F5 to run a script in IDLE on MacOSX
+- bpo-11088: don't crash when using F5 to run a script in IDLE on MacOSX
   with Tk 8.5.
 
-- Issue #1028: Tk returns invalid Unicode null in %A: UnicodeDecodeError.
-  With Tk < 8.5 _tkinter.c:PythonCmd() raised UnicodeDecodeError, caused
-  IDLE to exit.  Converted to valid Unicode null in PythonCmd().
+- bpo-1028: Tk returns invalid Unicode null in %A: UnicodeDecodeError. With
+  Tk < 8.5 _tkinter.c:PythonCmd() raised UnicodeDecodeError, caused IDLE to
+  exit. Converted to valid Unicode null in PythonCmd().
 
-- Issue #11718: IDLE's open module dialog couldn't find the __init__.py
-  file in a package.
+- bpo-11718: IDLE's open module dialog couldn't find the __init__.py file in
+  a package.
 
 Tools/Demos
 -----------
 
-- Issue #14053: patchcheck.py ("make patchcheck") now works with MQ patches.
+- bpo-14053: patchcheck.py ("make patchcheck") now works with MQ patches.
   Patch by Francisco Martín Brugué.
 
-- Issue #13930: 2to3 is now able to write its converted output files to another
+- bpo-13930: 2to3 is now able to write its converted output files to another
   directory tree as well as copying unchanged files and altering the file
   suffix.  See its new -o, -W and --add-suffix options.  This makes it more
   useful in many automated code translation workflows.
 
-- Issue #13628: python-gdb.py is now able to retrieve more frames in the Python
+- bpo-13628: python-gdb.py is now able to retrieve more frames in the Python
   traceback if Python is optimized.
 
-- Issue #11996: libpython (gdb), replace "py-bt" command by "py-bt-full" and
+- bpo-11996: libpython (gdb), replace "py-bt" command by "py-bt-full" and
   add a smarter "py-bt" command printing a classic Python traceback.
 
-- Issue #11179: Make ccbench work under Python 3.1 and 2.7 again.
+- bpo-11179: Make ccbench work under Python 3.1 and 2.7 again.
 
-- Issue #10639: reindent.py no longer converts newlines and will raise
-  an error if attempting to convert a file with mixed newlines.
-  "--newline" option added to specify new line character.
+- bpo-10639: reindent.py no longer converts newlines and will raise an error
+  if attempting to convert a file with mixed newlines. "--newline" option
+  added to specify new line character.
 
-Extension Modules
------------------
+Library
+-------
 
-- Issue #16847: Fixed improper use of _PyUnicode_CheckConsistency() in
-  non-pydebug builds. Several extension modules now compile cleanly when
+- bpo-16847: Fixed improper use of _PyUnicode_CheckConsistency() in non-
+  pydebug builds. Several extension modules now compile cleanly when
   assert()s are enabled in standard builds (-DDEBUG flag).
 
-- Issue #13840: The error message produced by ctypes.create_string_buffer
-  when given a Unicode string has been fixed.
+- bpo-13840: The error message produced by ctypes.create_string_buffer when
+  given a Unicode string has been fixed.
 
-- Issue #9975: socket: Fix incorrect use of flowinfo and scope_id. Patch by
+- bpo-9975: socket: Fix incorrect use of flowinfo and scope_id. Patch by
   Vilmos Nebehaj.
 
-- Issue #7777: socket: Add Reliable Datagram Sockets (PF_RDS) support.
+- bpo-7777: socket: Add Reliable Datagram Sockets (PF_RDS) support.
 
-- Issue #13159: FileIO and BZ2Compressor/BZ2Decompressor now use a linear-time
+- bpo-13159: FileIO and BZ2Compressor/BZ2Decompressor now use a linear-time
   buffer growth strategy instead of a quadratic-time one.
 
-- Issue #10141: socket: Add SocketCAN (PF_CAN) support. Initial patch by
+- bpo-10141: socket: Add SocketCAN (PF_CAN) support. Initial patch by
   Matthias Fuchs, updated by Tiago Gonçalves.
 
-- Issue #13070: Fix a crash when a TextIOWrapper caught in a reference cycle
+- bpo-13070: Fix a crash when a TextIOWrapper caught in a reference cycle
   would be finalized after the reference to its underlying BufferedRWPair's
   writer got cleared by the GC.
 
-- Issue #12881: ctypes: Fix segfault with large structure field names.
+- bpo-12881: ctypes: Fix segfault with large structure field names.
 
-- Issue #13058: ossaudiodev: fix a file descriptor leak on error. Patch by
+- bpo-13058: ossaudiodev: fix a file descriptor leak on error. Patch by
   Thomas Jarosch.
 
-- Issue #13013: ctypes: Fix a reference leak in PyCArrayType_from_ctype.
-  Thanks to Suman Saha for finding the bug and providing a patch.
+- bpo-13013: ctypes: Fix a reference leak in PyCArrayType_from_ctype. Thanks
+  to Suman Saha for finding the bug and providing a patch.
 
-- Issue #13022: Fix: _multiprocessing.recvfd() doesn't check that
-  file descriptor was actually received.
+- bpo-13022: Fix: _multiprocessing.recvfd() doesn't check that file
+  descriptor was actually received.
 
-- Issue #1172711: Add 'long long' support to the array module.
-  Initial patch by Oren Tirosh and Hirokazu Yamamoto.
+- bpo-1172711: Add 'long long' support to the array module. Initial patch by
+  Oren Tirosh and Hirokazu Yamamoto.
 
-- Issue #12483: ctypes: Fix a crash when the destruction of a callback
-  object triggers the garbage collector.
+- bpo-12483: ctypes: Fix a crash when the destruction of a callback object
+  triggers the garbage collector.
 
-- Issue #12950: Fix passing file descriptors in multiprocessing, under
+- bpo-12950: Fix passing file descriptors in multiprocessing, under
   OpenIndiana/Illumos.
 
-- Issue #12764: Fix a crash in ctypes when the name of a Structure field is not
+- bpo-12764: Fix a crash in ctypes when the name of a Structure field is not
   a string.
 
-- Issue #11241: subclasses of ctypes.Array can now be subclassed.
+- bpo-11241: subclasses of ctypes.Array can now be subclassed.
 
-- Issue #9651: Fix a crash when ctypes.create_string_buffer(0) was passed to
+- bpo-9651: Fix a crash when ctypes.create_string_buffer(0) was passed to
   some functions like file.write().
 
-- Issue #10309: Define _GNU_SOURCE so that mremap() gets the proper
-  signature.  Without this, architectures where sizeof void* != sizeof int are
-  broken.  Patch given by Hallvard B Furuseth.
+- bpo-10309: Define _GNU_SOURCE so that mremap() gets the proper signature.
+  Without this, architectures where sizeof void* != sizeof int are broken.
+  Patch given by Hallvard B Furuseth.
 
-- Issue #12051: Fix segfault in json.dumps() while encoding highly-nested
+- bpo-12051: Fix segfault in json.dumps() while encoding highly-nested
   objects using the C accelerations.
 
-- Issue #12017: Fix segfault in json.loads() while decoding highly-nested
+- bpo-12017: Fix segfault in json.loads() while decoding highly-nested
   objects using the C accelerations.
 
-- Issue #1838: Prevent segfault in ctypes, when _as_parameter_ on a class is set
-  to an instance of the class.
+- bpo-1838: Prevent segfault in ctypes, when _as_parameter_ on a class is
+  set to an instance of the class.
 
 Tests
 -----
 
-- Issue #13125: Silence spurious test_lib2to3 output when in non-verbose mode.
+- bpo-13125: Silence spurious test_lib2to3 output when in non-verbose mode.
   Patch by Mikhail Novikov.
 
-- Issue #13447: Add a test file to host regression tests for bugs in the
+- bpo-13447: Add a test file to host regression tests for bugs in the
   scripts found in the Tools directory.
 
-- Issue #10881: Fix test_site failure with OS X framework builds.
+- bpo-10881: Fix test_site failure with OS X framework builds.
 
-- Issue #13901: Prevent test_distutils failures on OS X with --enable-shared.
+- bpo-13901: Prevent test_distutils failures on OS X with --enable-shared.
 
-- Issue #13862: Fix spurious failure in test_zlib due to runtime/compile time
+- bpo-13862: Fix spurious failure in test_zlib due to runtime/compile time
   minor versions not matching.
 
-- Issue #12804: Fix test_socket and test_urllib2net failures when running tests
+- bpo-12804: Fix test_socket and test_urllib2net failures when running tests
   on a system without internet access.
 
-- Issue #13726: Fix the ambiguous -S flag in regrtest. It is -o/--slow for slow
+- bpo-13726: Fix the ambiguous -S flag in regrtest. It is -o/--slow for slow
   tests.
 
-- Issue #11659: Fix ResourceWarning in test_subprocess introduced by #11459.
+- bpo-11659: Fix ResourceWarning in test_subprocess introduced by #11459.
   Patch by Ben Hayden.
 
-- Issue #11577: fix ResourceWarning triggered by improved binhex test coverage
+- bpo-11577: fix ResourceWarning triggered by improved binhex test coverage
 
-- Issue #11509: Significantly increase test coverage of fileinput.
-  Patch by Denver Coneybeare at PyCon 2011 Sprints.
+- bpo-11509: Significantly increase test coverage of fileinput. Patch by
+  Denver Coneybeare at PyCon 2011 Sprints.
 
-- Issue #11689: Fix a variable scoping error in an sqlite3 test
+- bpo-11689: Fix a variable scoping error in an sqlite3 test
 
-- Issue #13786: Remove unimplemented 'trace' long option from regrtest.py.
+- bpo-13786: Remove unimplemented 'trace' long option from regrtest.py.
 
-- Issue #13725: Fix regrtest to recognize the documented -d flag.
-  Patch by Erno Tukia.
+- bpo-13725: Fix regrtest to recognize the documented -d flag. Patch by Erno
+  Tukia.
 
-- Issue #13304: Skip test case if user site-packages disabled (-s or
-  PYTHONNOUSERSITE).  (Patch by Carl Meyer)
+- bpo-13304: Skip test case if user site-packages disabled (-s or
+  PYTHONNOUSERSITE). (Patch by Carl Meyer)
 
-- Issue #5661: Add a test for ECONNRESET/EPIPE handling to test_asyncore. Patch
+- bpo-5661: Add a test for ECONNRESET/EPIPE handling to test_asyncore. Patch
   by Xavier de Gaye.
 
-- Issue #13218: Fix test_ssl failures on Debian/Ubuntu.
+- bpo-13218: Fix test_ssl failures on Debian/Ubuntu.
 
 - Re-enable lib2to3's test_parser.py tests, though with an expected failure
   (see issue #13125).
 
-- Issue #12656: Add tests for IPv6 and Unix sockets to test_asyncore.
+- bpo-12656: Add tests for IPv6 and Unix sockets to test_asyncore.
 
-- Issue #6484: Add unit tests for mailcap module (patch by Gregory Nofi)
+- bpo-6484: Add unit tests for mailcap module (patch by Gregory Nofi)
 
-- Issue #11651: Improve the Makefile test targets to run more of the test suite
-  more quickly. The --multiprocess option is now enabled by default, reducing
-  the amount of time needed to run the tests. "make test" and "make quicktest"
-  now include some resource-intensive tests, but no longer run the test suite
-  twice to check for bugs in .pyc generation. Tools/scripts/run_test.py provides
-  an easy platform-independent way to run test suite with sensible defaults.
+- bpo-11651: Improve the Makefile test targets to run more of the test suite
+  more quickly. The --multiprocess option is now enabled by default,
+  reducing the amount of time needed to run the tests. "make test" and "make
+  quicktest" now include some resource-intensive tests, but no longer run
+  the test suite twice to check for bugs in .pyc generation.
+  Tools/scripts/run_test.py provides an easy platform-independent way to run
+  test suite with sensible defaults.
 
-- Issue #12331: The test suite for the packaging module can now run from an
+- bpo-12331: The test suite for the packaging module can now run from an
   installed Python.
 
-- Issue #12331: The test suite for lib2to3 can now run from an installed
+- bpo-12331: The test suite for lib2to3 can now run from an installed
   Python.
 
-- Issue #12626: In regrtest, allow to filter tests using a glob filter
-  with the ``-m`` (or ``--match``) option.  This works with all test cases
-  using the unittest module.  This is useful with long test suites
-  such as test_io or test_subprocess.
+- bpo-12626: In regrtest, allow to filter tests using a glob filter with the
+  ``-m`` (or ``--match``) option.  This works with all test cases using the
+  unittest module.  This is useful with long test suites such as test_io or
+  test_subprocess.
 
-- Issue #12624: It is now possible to fail after the first failure when
-  running in verbose mode (``-v`` or ``-W``), by using the ``--failfast``
-  (or ``-G``) option to regrtest.  This is useful with long test suites
-  such as test_io or test_subprocess.
+- bpo-12624: It is now possible to fail after the first failure when running
+  in verbose mode (``-v`` or ``-W``), by using the ``--failfast`` (or
+  ``-G``) option to regrtest.  This is useful with long test suites such as
+  test_io or test_subprocess.
 
-- Issue #12587: Correct faulty test file and reference in test_tokenize.
-  (Patch by Robert Xiao)
+- bpo-12587: Correct faulty test file and reference in test_tokenize. (Patch
+  by Robert Xiao)
 
-- Issue #12573: Add resource checks for dangling Thread and Process objects.
+- bpo-12573: Add resource checks for dangling Thread and Process objects.
 
-- Issue #12549: Correct test_platform to not fail when OS X returns 'x86_64'
-  as the processor type on some Mac systems.
+- bpo-12549: Correct test_platform to not fail when OS X returns 'x86_64' as
+  the processor type on some Mac systems.
 
-- Skip network tests when getaddrinfo() returns EAI_AGAIN, meaning a temporary
-  failure in name resolution.
+- Skip network tests when getaddrinfo() returns EAI_AGAIN, meaning a
+  temporary failure in name resolution.
 
-- Issue #11812: Solve transient socket failure to connect to 'localhost'
-  in test_telnetlib.py.
+- bpo-11812: Solve transient socket failure to connect to 'localhost' in
+  test_telnetlib.py.
 
 - Solved a potential deadlock in test_telnetlib.py. Related to issue #11812.
 
-- Avoid failing in test_robotparser when mueblesmoraleda.com is flaky and
-  an overzealous DNS service (e.g. OpenDNS) redirects to a placeholder
-  Web site.
+- Avoid failing in test_robotparser when mueblesmoraleda.com is flaky and an
+  overzealous DNS service (e.g. OpenDNS) redirects to a placeholder Web
+  site.
 
-- Avoid failing in test_urllibnet.test_bad_address when some overzealous
-  DNS service (e.g. OpenDNS) resolves a non-existent domain name.  The test
-  is now skipped instead.
+- Avoid failing in test_urllibnet.test_bad_address when some overzealous DNS
+  service (e.g. OpenDNS) resolves a non-existent domain name.  The test is
+  now skipped instead.
 
-- Issue #12440: When testing whether some bits in SSLContext.options can be
-  reset, check the version of the OpenSSL headers Python was compiled against,
-  rather than the runtime version of the OpenSSL library.
+- bpo-12440: When testing whether some bits in SSLContext.options can be
+  reset, check the version of the OpenSSL headers Python was compiled
+  against, rather than the runtime version of the OpenSSL library.
 
-- Issue #11512: Add a test suite for the cgitb module. Patch by Robbie Clemons.
+- bpo-11512: Add a test suite for the cgitb module. Patch by Robbie Clemons.
 
-- Issue #12497: Install test/data to prevent failures of the various codecmaps
+- bpo-12497: Install test/data to prevent failures of the various codecmaps
   tests.
 
-- Issue #12496: Install test/capath directory to prevent test_connect_capath
+- bpo-12496: Install test/capath directory to prevent test_connect_capath
   testcase failure in test_ssl.
 
-- Issue #12469: Run wakeup and pending signal tests in a subprocess to run the
+- bpo-12469: Run wakeup and pending signal tests in a subprocess to run the
   test in a fresh process with only one thread and to not change signal
   handling of the parent process.
 
-- Issue #8716: Avoid crashes caused by Aqua Tk on OSX when attempting to run
+- bpo-8716: Avoid crashes caused by Aqua Tk on OSX when attempting to run
   test_tk or test_ttk_guionly under a username that is not currently logged
   in to the console windowserver (as may be the case under buildbot or ssh).
 
-- Issue #12407: Explicitly skip test_capi.EmbeddingTest under Windows.
+- bpo-12407: Explicitly skip test_capi.EmbeddingTest under Windows.
 
-- Issue #12400: regrtest -W doesn't rerun the tests twice anymore, but captures
-  the output and displays it on failure instead. regrtest -v doesn't print the
-  error twice anymore if there is only one error.
+- bpo-12400: regrtest -W doesn't rerun the tests twice anymore, but captures
+  the output and displays it on failure instead. regrtest -v doesn't print
+  the error twice anymore if there is only one error.
 
-- Issue #12141: Install copies of template C module file so that
-  test_build_ext of test_distutils and test_command_build_ext of
-  test_packaging are no longer silently skipped when
-  run outside of a build directory.
+- bpo-12141: Install copies of template C module file so that test_build_ext
+  of test_distutils and test_command_build_ext of test_packaging are no
+  longer silently skipped when run outside of a build directory.
 
-- Issue #8746: Add additional tests for os.chflags() and os.lchflags().
-  Patch by Garrett Cooper.
+- bpo-8746: Add additional tests for os.chflags() and os.lchflags(). Patch
+  by Garrett Cooper.
 
-- Issue #10736: Fix test_ttk test_widgets failures with Cocoa Tk 8.5.9
-  2.8+ on Mac OS X.  (Patch by Ronald Oussoren)
+- bpo-10736: Fix test_ttk test_widgets failures with Cocoa Tk 8.5.9 2.8+ on
+  Mac OS X. (Patch by Ronald Oussoren)
 
-- Issue #12057: Add tests for ISO 2022 codecs (iso2022_jp, iso2022_jp_2,
+- bpo-12057: Add tests for ISO 2022 codecs (iso2022_jp, iso2022_jp_2,
   iso2022_kr).
 
-- Issue #12096: Fix a race condition in test_threading.test_waitfor(). Patch
+- bpo-12096: Fix a race condition in test_threading.test_waitfor(). Patch
   written by Charles-François Natali.
 
-- Issue #11614: import __hello__ prints "Hello World!". Patch written by
+- bpo-11614: import __hello__ prints "Hello World!". Patch written by
   Andreas Stührk.
 
-- Issue #5723: Improve json tests to be executed with and without accelerations.
+- bpo-5723: Improve json tests to be executed with and without
+  accelerations.
 
-- Issue #12041: Make test_wait3 more robust.
+- bpo-12041: Make test_wait3 more robust.
 
-- Issue #11873: Change regex in test_compileall to fix occasional failures when
+- bpo-11873: Change regex in test_compileall to fix occasional failures when
   when the randomly generated temporary path happened to match the regex.
 
-- Issue #11958: Fix FTP tests for IPv6, bind to "::1" instead of "localhost".
+- bpo-11958: Fix FTP tests for IPv6, bind to "::1" instead of "localhost".
   Patch written by Charles-Francois Natali.
 
-- Issue #8407, #11859: Fix tests of test_io using threads and an alarm: use
-  pthread_sigmask() to ensure that the SIGALRM signal is received by the main
-  thread.
+- bpo-8407: Fix tests of test_io using threads and an alarm: use
+  pthread_sigmask() to ensure that the SIGALRM signal is received by the
+  main thread. (See also: bpo-11859)
 
-- Issue #11811: Factor out detection of IPv6 support on the current host
-  and make it available as ``test.support.IPV6_ENABLED``.  Patch by
-  Charles-François Natali.
+- bpo-11811: Factor out detection of IPv6 support on the current host and
+  make it available as ``test.support.IPV6_ENABLED``.  Patch by Charles-
+  François Natali.
 
-- Issue #10914: Add a minimal embedding test to test_capi.
+- bpo-10914: Add a minimal embedding test to test_capi.
 
-- Issue #11223: Skip test_lock_acquire_interruption() and
-  test_rlock_acquire_interruption() of test_threadsignals if a thread lock is
-  implemented using a POSIX mutex and a POSIX condition variable. A POSIX
+- bpo-11223: Skip test_lock_acquire_interruption() and
+  test_rlock_acquire_interruption() of test_threadsignals if a thread lock
+  is implemented using a POSIX mutex and a POSIX condition variable. A POSIX
   condition variable cannot be interrupted by a signal (e.g. on Linux, the
   futex system call is restarted).
 
-- Issue #11790: Fix sporadic failures in test_multiprocessing.WithProcessesTestCondition.
+- bpo-11790: Fix sporadic failures in
+  test_multiprocessing.WithProcessesTestCondition.
 
-- Fix possible "file already exists" error when running the tests in parallel.
+- Fix possible "file already exists" error when running the tests in
+  parallel.
 
-- Issue #11719: Fix message about unexpected test_msilib skip on non-Windows
+- bpo-11719: Fix message about unexpected test_msilib skip on non-Windows
   platforms. Patch by Nadeem Vawda.
 
-- Issue #11727: Add a --timeout option to regrtest: if a test takes more than
+- bpo-11727: Add a --timeout option to regrtest: if a test takes more than
   TIMEOUT seconds, dumps the traceback of all threads and exits.
 
-- Issue #11653: fix -W with -j in regrtest.
+- bpo-11653: fix -W with -j in regrtest.
 
-- The email test suite now lives in the Lib/test/test_email package.  The test
-  harness code has also been modernized to allow use of new unittest features.
+- The email test suite now lives in the Lib/test/test_email package.  The
+  test harness code has also been modernized to allow use of new unittest
+  features.
 
 - regrtest now discovers test packages as well as test modules.
 
-- Issue #11577: improve test coverage of binhex.py. Patch by Arkady Koplyarov.
+- bpo-11577: improve test coverage of binhex.py. Patch by Arkady Koplyarov.
 
 - New test_crashers added to exercise the scripts in the Lib/test/crashers
   directory and confirm they fail as expected
 
-- Issue #11578: added test for the timeit module.  Patch by Michael Henry.
+- bpo-11578: added test for the timeit module.  Patch by Michael Henry.
 
-- Issue #11503: improve test coverage of posixpath.py. Patch by Evan Dandrea.
+- bpo-11503: improve test coverage of posixpath.py. Patch by Evan Dandrea.
 
-- Issue #11505: improves test coverage of string.py, increases granularity of
+- bpo-11505: improves test coverage of string.py, increases granularity of
   string.Formatter tests. Initial patch by Alicia Arlen.
 
-- Issue #11548: Improve test coverage of the shutil module. Patch by
-  Evan Dandrea.
+- bpo-11548: Improve test coverage of the shutil module. Patch by Evan
+  Dandrea.
 
-- Issue #11554: Reactivated test_email_codecs.
+- bpo-11554: Reactivated test_email_codecs.
 
-- Issue #11505: improves test coverage of string.py. Patch by Alicia
-  Arlen
+- bpo-11505: improves test coverage of string.py. Patch by Alicia Arlen
 
-- Issue #11490: test_subprocess.test_leaking_fds_on_error no longer gives a
+- bpo-11490: test_subprocess.test_leaking_fds_on_error no longer gives a
   false positive if the last directory in the path is inaccessible.
 
-- Issue #11223: Fix test_threadsignals to fail, not hang, when the
-  non-semaphore implementation of locks is used under POSIX.
+- bpo-11223: Fix test_threadsignals to fail, not hang, when the non-
+  semaphore implementation of locks is used under POSIX.
 
-- Issue #10911: Add tests on CGI with non-ASCII characters. Patch written by
+- bpo-10911: Add tests on CGI with non-ASCII characters. Patch written by
   Pierre Quentel.
 
-- Issue #9931: Fix hangs in GUI tests under Windows in certain conditions.
+- bpo-9931: Fix hangs in GUI tests under Windows in certain conditions.
   Patch by Hirokazu Yamamoto.
 
-- Issue #10512: Properly close sockets under test.test_cgi.
+- bpo-10512: Properly close sockets under test.test_cgi.
 
-- Issue #10992: Make tests pass under coverage.
+- bpo-10992: Make tests pass under coverage.
 
-- Issue #10826: Prevent sporadic failure in test_subprocess on Solaris due
-  to open door files.
+- bpo-10826: Prevent sporadic failure in test_subprocess on Solaris due to
+  open door files.
 
-- Issue #10990: Prevent tests from clobbering a set trace function.
+- bpo-10990: Prevent tests from clobbering a set trace function.
 
-C-API
+C API
 -----
 
-- Issue #13452: PyUnicode_EncodeDecimal() doesn't support error handlers
-  different than "strict" anymore. The caller was unable to compute the
-  size of the output buffer: it depends on the error handler.
+- bpo-13452: PyUnicode_EncodeDecimal() doesn't support error handlers
+  different than "strict" anymore. The caller was unable to compute the size
+  of the output buffer: it depends on the error handler.
 
-- Issue #13560: Add PyUnicode_DecodeLocale(), PyUnicode_DecodeLocaleAndSize()
-  and PyUnicode_EncodeLocale() functions to the C API to decode/encode from/to
-  the current locale encoding.
+- bpo-13560: Add PyUnicode_DecodeLocale(), PyUnicode_DecodeLocaleAndSize()
+  and PyUnicode_EncodeLocale() functions to the C API to decode/encode
+  from/to the current locale encoding.
 
-- Issue #10831: PyUnicode_FromFormat() supports %li, %lli and %zi formats.
+- bpo-10831: PyUnicode_FromFormat() supports %li, %lli and %zi formats.
 
-- Issue #11246: Fix PyUnicode_FromFormat("%V") to decode the byte string from
+- bpo-11246: Fix PyUnicode_FromFormat("%V") to decode the byte string from
   UTF-8 (with replace error handler) instead of ISO-8859-1 (in strict mode).
   Patch written by Ray Allen.
 
-- Issue #10830: Fix PyUnicode_FromFormatV("%c") for non-BMP characters on
+- bpo-10830: Fix PyUnicode_FromFormatV("%c") for non-BMP characters on
   narrow build.
 
 - Add PyObject_GenericGetDict and PyObject_GeneriSetDict. They are generic
-  implementations for the getter and setter of a ``__dict__`` descriptor of C
-  types.
+  implementations for the getter and setter of a ``__dict__`` descriptor of
+  types.
 
-- Issue #13727: Add 3 macros to access PyDateTime_Delta members:
+- bpo-13727: Add 3 macros to access PyDateTime_Delta members:
   PyDateTime_DELTA_GET_DAYS, PyDateTime_DELTA_GET_SECONDS,
   PyDateTime_DELTA_GET_MICROSECONDS.
 
-- Issue #10542: Add 4 macros to work with surrogates: Py_UNICODE_IS_SURROGATE,
+- bpo-10542: Add 4 macros to work with surrogates: Py_UNICODE_IS_SURROGATE,
   Py_UNICODE_IS_HIGH_SURROGATE, Py_UNICODE_IS_LOW_SURROGATE,
   Py_UNICODE_JOIN_SURROGATES.
 
-- Issue #12724: Add Py_RETURN_NOTIMPLEMENTED macro for returning NotImplemented.
+- bpo-12724: Add Py_RETURN_NOTIMPLEMENTED macro for returning
+  NotImplemented.
 
 - PY_PATCHLEVEL_REVISION has been removed, since it's meaningless with
   Mercurial.
 
-- Issue #12173: The first argument of PyImport_ImportModuleLevel is now `const
+- bpo-12173: The first argument of PyImport_ImportModuleLevel is now `const
   char *` instead of `char *`.
 
-- Issue #12380: PyArg_ParseTuple now accepts a bytearray for the 'c' format.
+- bpo-12380: PyArg_ParseTuple now accepts a bytearray for the 'c' format.
 
 Documentation
 -------------
 
-- Issue #23006: Improve the documentation and indexing of dict.__missing__.
-  Add an entry in the language datamodel special methods section.
-  Revise and index its discussion in the stdtypes mapping/dict section.
+- bpo-23006: Improve the documentation and indexing of dict.__missing__. Add
+  an entry in the language datamodel special methods section. Revise and
+  index its discussion in the stdtypes mapping/dict section.
 
-- Issue #13989: Document that GzipFile does not support text mode, and give a
+- bpo-13989: Document that GzipFile does not support text mode, and give a
   more helpful error message when opened with an invalid mode string.
 
-- Issue #13921: Undocument and clean up sqlite3.OptimizedUnicode,
-  which is obsolete in Python 3.x. It's now aliased to str for
-  backwards compatibility.
+- bpo-13921: Undocument and clean up sqlite3.OptimizedUnicode, which is
+  obsolete in Python 3.x. It's now aliased to str for backwards
+  compatibility.
 
-- Issue #12102: Document that buffered files must be flushed before being used
+- bpo-12102: Document that buffered files must be flushed before being used
   with mmap. Patch by Steffen Daode Nurpmeso.
 
-- Issue #8982: Improve the documentation for the argparse Namespace object.
+- bpo-8982: Improve the documentation for the argparse Namespace object.
 
-- Issue #9343: Document that argparse parent parsers must be configured before
+- bpo-9343: Document that argparse parent parsers must be configured before
   their children.
 
-- Issue #13498: Clarify docs of os.makedirs()'s exist_ok argument.  Done with
-  great native-speaker help from R. David Murray.
+- bpo-13498: Clarify docs of os.makedirs()'s exist_ok argument.  Done with
+  great native- speaker help from R. David Murray.
 
-- Issues #13491 and #13995: Fix many errors in sqlite3 documentation.
-  Initial patch for #13491 by Johannes Vogel.
+- bpo-13491: Fix many errors in sqlite3 documentation. Initial patch for
+  #13491 by Johannes Vogel. (See also: bpo-13995)
 
-- Issue #13402: Document absoluteness of sys.executable.
+- bpo-13402: Document absoluteness of sys.executable.
 
-- Issue #13883: PYTHONCASEOK also works on OS X.
+- bpo-13883: PYTHONCASEOK also works on OS X.
 
-- Issue #9021: Add an introduction to the copy module documentation.
+- bpo-9021: Add an introduction to the copy module documentation.
 
-- Issue #6005: Examples in the socket library documentation use sendall, where
+- bpo-6005: Examples in the socket library documentation use sendall, where
   relevant, instead send method.
 
-- Issue #12798: Updated the mimetypes documentation.
+- bpo-12798: Updated the mimetypes documentation.
 
-- Issue #12949: Document the kwonlyargcount argument for the PyCode_New
-  C API function.
+- bpo-12949: Document the kwonlyargcount argument for the PyCode_New C API
+  function.
 
-- Issue #13513: Fix io.IOBase documentation to correctly link to the
+- bpo-13513: Fix io.IOBase documentation to correctly link to the
   io.IOBase.readline method instead of the readline module.
 
-- Issue #13237: Reorganise subprocess documentation to emphasise convenience
+- bpo-13237: Reorganise subprocess documentation to emphasise convenience
   functions and the most commonly needed arguments to Popen.
 
-- Issue #13141: Demonstrate recommended style for socketserver examples.
+- bpo-13141: Demonstrate recommended style for socketserver examples.
 
-- Issue #11818: Fix tempfile examples for Python 3.
+- bpo-11818: Fix tempfile examples for Python 3.
 
 
 **(For information about older versions, consult the HISTORY file.)**
index d472c9e..5ff820f 100644 (file)
@@ -535,6 +535,20 @@ getenvironment(PyObject* environment)
                 "environment can only contain strings");
             goto error;
         }
+        if (PyUnicode_FindChar(key, '\0', 0, PyUnicode_GET_LENGTH(key), 1) != -1 ||
+            PyUnicode_FindChar(value, '\0', 0, PyUnicode_GET_LENGTH(value), 1) != -1)
+        {
+            PyErr_SetString(PyExc_ValueError, "embedded null character");
+            goto error;
+        }
+        /* Search from index 1 because on Windows starting '=' is allowed for
+           defining hidden environment variables. */
+        if (PyUnicode_GET_LENGTH(key) == 0 ||
+            PyUnicode_FindChar(key, '=', 1, PyUnicode_GET_LENGTH(key), 1) != -1)
+        {
+            PyErr_SetString(PyExc_ValueError, "illegal environment variable name");
+            goto error;
+        }
         if (totalsize > PY_SSIZE_T_MAX - PyUnicode_GET_LENGTH(key) - 1) {
             PyErr_SetString(PyExc_OverflowError, "environment too long");
             goto error;
@@ -643,12 +657,13 @@ winapi_CreateProcess(PyObject* self, PyObject* args)
 
     if (env_mapping != Py_None) {
         environment = getenvironment(env_mapping);
-        if (! environment)
+        if (environment == NULL) {
             return NULL;
+        }
+        /* contains embedded null characters */
         wenvironment = PyUnicode_AsUnicode(environment);
-        if (wenvironment == NULL)
-        {
-            Py_XDECREF(environment);
+        if (wenvironment == NULL) {
+            Py_DECREF(environment);
             return NULL;
         }
     }
index dcb4506..8d288f0 100644 (file)
@@ -1,6 +1,5 @@
-Copyright (c) 1998, 1999, 2000 Thai Open Source Software Center Ltd
-                               and Clark Cooper
-Copyright (c) 2001, 2002, 2003, 2004, 2005, 2006 Expat maintainers.
+Copyright (c) 1998-2000 Thai Open Source Software Center Ltd and Clark Cooper
+Copyright (c) 2001-2017 Expat maintainers
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the
diff --git a/Modules/expat/amigaconfig.h b/Modules/expat/amigaconfig.h
deleted file mode 100644 (file)
index 86c6115..0000000
+++ /dev/null
@@ -1,32 +0,0 @@
-#ifndef AMIGACONFIG_H
-#define AMIGACONFIG_H
-
-/* 1234 = LIL_ENDIAN, 4321 = BIGENDIAN */
-#define BYTEORDER 4321
-
-/* Define to 1 if you have the `bcopy' function. */
-#define HAVE_BCOPY 1
-
-/* Define to 1 if you have the <check.h> header file. */
-#undef HAVE_CHECK_H
-
-/* Define to 1 if you have the `memmove' function. */
-#define HAVE_MEMMOVE 1
-
-/* Define to 1 if you have the <unistd.h> header file. */
-#define HAVE_UNISTD_H 1
-
-/* whether byteorder is bigendian */
-#define WORDS_BIGENDIAN
-
-/* Define to specify how much context to retain around the current parse
-   point. */
-#define XML_CONTEXT_BYTES 1024
-
-/* Define to make parameter entity parsing functionality available. */
-#define XML_DTD
-
-/* Define to make XML Namespaces functionality available. */
-#define XML_NS
-
-#endif  /* AMIGACONFIG_H */
index e8eefdd..28b0f95 100644 (file)
@@ -95,7 +95,9 @@ enum XML_Error {
   /* Added in 2.0. */
   XML_ERROR_RESERVED_PREFIX_XML,
   XML_ERROR_RESERVED_PREFIX_XMLNS,
-  XML_ERROR_RESERVED_NAMESPACE_URI
+  XML_ERROR_RESERVED_NAMESPACE_URI,
+  /* Added in 2.2.1. */
+  XML_ERROR_INVALID_ARGUMENT
 };
 
 enum XML_Content_Type {
@@ -342,7 +344,7 @@ XML_SetEntityDeclHandler(XML_Parser parser,
                          XML_EntityDeclHandler handler);
 
 /* OBSOLETE -- OBSOLETE -- OBSOLETE
-   This handler has been superceded by the EntityDeclHandler above.
+   This handler has been superseded by the EntityDeclHandler above.
    It is provided here for backward compatibility.
 
    This is called for a declaration of an unparsed (NDATA) entity.
@@ -706,6 +708,7 @@ XML_UseParserAsHandlerArg(XML_Parser parser);
      be called, despite an external subset being parsed.
    Note: If XML_DTD is not defined when Expat is compiled, returns
      XML_ERROR_FEATURE_REQUIRES_XML_DTD.
+   Note: If parser == NULL, returns XML_ERROR_INVALID_ARGUMENT.
 */
 XMLPARSEAPI(enum XML_Error)
 XML_UseForeignDTD(XML_Parser parser, XML_Bool useDTD);
@@ -729,15 +732,16 @@ XML_GetBase(XML_Parser parser);
    to the XML_StartElementHandler that were specified in the start-tag
    rather than defaulted. Each attribute/value pair counts as 2; thus
    this correspondds to an index into the atts array passed to the
-   XML_StartElementHandler.
+   XML_StartElementHandler.  Returns -1 if parser == NULL.
 */
 XMLPARSEAPI(int)
 XML_GetSpecifiedAttributeCount(XML_Parser parser);
 
 /* Returns the index of the ID attribute passed in the last call to
-   XML_StartElementHandler, or -1 if there is no ID attribute.  Each
-   attribute/value pair counts as 2; thus this correspondds to an
-   index into the atts array passed to the XML_StartElementHandler.
+   XML_StartElementHandler, or -1 if there is no ID attribute or
+   parser == NULL.  Each attribute/value pair counts as 2; thus this
+   correspondds to an index into the atts array passed to the
+   XML_StartElementHandler.
 */
 XMLPARSEAPI(int)
 XML_GetIdAttributeIndex(XML_Parser parser);
@@ -901,6 +905,7 @@ enum XML_ParamEntityParsing {
    entities is requested; otherwise it will return non-zero.
    Note: If XML_SetParamEntityParsing is called after XML_Parse or
       XML_ParseBuffer, then it has no effect and will always return 0.
+   Note: If parser == NULL, the function will do nothing and return 0.
 */
 XMLPARSEAPI(int)
 XML_SetParamEntityParsing(XML_Parser parser,
@@ -910,13 +915,12 @@ XML_SetParamEntityParsing(XML_Parser parser,
    Helps in preventing DoS attacks based on predicting hash
    function behavior. This must be called before parsing is started.
    Returns 1 if successful, 0 when called after parsing has started.
+   Note: If parser == NULL, the function will do nothing and return 0.
 */
 XMLPARSEAPI(int)
 XML_SetHashSalt(XML_Parser parser,
                 unsigned long hash_salt);
 
-#define XML_HAS_SET_HASH_SALT  /* Python Only: Defined for pyexpat.c. */
-
 /* If XML_Parse or XML_ParseBuffer have returned XML_STATUS_ERROR, then
    XML_GetErrorCode returns information about the error.
 */
@@ -938,6 +942,10 @@ XML_GetErrorCode(XML_Parser parser);
    the location is the location of the character at which the error
    was detected; otherwise the location is the location of the last
    parse event, as described above.
+
+   Note: XML_GetCurrentLineNumber and XML_GetCurrentColumnNumber
+   return 0 to indicate an error.
+   Note: XML_GetCurrentByteIndex returns -1 to indicate an error.
 */
 XMLPARSEAPI(XML_Size) XML_GetCurrentLineNumber(XML_Parser parser);
 XMLPARSEAPI(XML_Size) XML_GetCurrentColumnNumber(XML_Parser parser);
@@ -975,9 +983,12 @@ XML_FreeContentModel(XML_Parser parser, XML_Content *model);
 
 /* Exposing the memory handling functions used in Expat */
 XMLPARSEAPI(void *)
+XML_ATTR_MALLOC
+XML_ATTR_ALLOC_SIZE(2)
 XML_MemMalloc(XML_Parser parser, size_t size);
 
 XMLPARSEAPI(void *)
+XML_ATTR_ALLOC_SIZE(3)
 XML_MemRealloc(XML_Parser parser, void *ptr, size_t size);
 
 XMLPARSEAPI(void)
@@ -1033,13 +1044,11 @@ XMLPARSEAPI(const XML_Feature *)
 XML_GetFeatureList(void);
 
 
-/* Expat follows the GNU/Linux convention of odd number minor version for
-   beta/development releases and even number minor version for stable
-   releases. Micro is bumped with each release, and set to 0 with each
-   change to major or minor version.
+/* Expat follows the semantic versioning convention.
+   See http://semver.org.
 */
 #define XML_MAJOR_VERSION 2
-#define XML_MINOR_VERSION 1
+#define XML_MINOR_VERSION 2
 #define XML_MICRO_VERSION 1
 
 #ifdef __cplusplus
index f337e1c..4c9e5ea 100644 (file)
 #endif
 #endif  /* not defined XML_STATIC */
 
+#if !defined(XMLIMPORT) && defined(__GNUC__) && (__GNUC__ >= 4)
+#define XMLIMPORT __attribute__ ((visibility ("default")))
+#endif
 
 /* If we didn't define it above, define it away: */
 #ifndef XMLIMPORT
 #define XMLIMPORT
 #endif
 
+#if defined(__GNUC__) && (__GNUC__ > 2 || (__GNUC__ == 2 && __GNUC_MINOR__ >= 96))
+#define XML_ATTR_MALLOC __attribute__((__malloc__))
+#else
+#define XML_ATTR_MALLOC
+#endif
+
+#if defined(__GNUC__) && ((__GNUC__ > 4) || (__GNUC__ == 4 && __GNUC_MINOR__ >= 3))
+#define XML_ATTR_ALLOC_SIZE(x)  __attribute__((__alloc_size__(x)))
+#else
+#define XML_ATTR_ALLOC_SIZE(x)
+#endif
 
 #define XMLPARSEAPI(type) XMLIMPORT type XMLCALL
 
@@ -83,7 +97,10 @@ extern "C" {
 #endif
 
 #ifdef XML_UNICODE_WCHAR_T
-#define XML_UNICODE
+# define XML_UNICODE
+# if defined(__SIZEOF_WCHAR_T__) && (__SIZEOF_WCHAR_T__ != 2)
+#  error "sizeof(wchar_t) != 2; Need -fshort-wchar for both Expat and libc"
+# endif
 #endif
 
 #ifdef XML_UNICODE     /* Information is UTF-16 encoded. */
index dd54548..94cb98e 100644 (file)
 #define inline
 #endif
 #endif
+
+#ifndef UNUSED_P
+# ifdef __GNUC__
+#  define UNUSED_P(p) UNUSED_ ## p __attribute__((__unused__))
+# else
+#  define UNUSED_P(p) UNUSED_ ## p
+# endif
+#endif
+
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+
+void
+align_limit_to_full_utf8_characters(const char * from, const char ** fromLimRef);
+
+
+#ifdef __cplusplus
+}
+#endif
diff --git a/Modules/expat/macconfig.h b/Modules/expat/macconfig.h
deleted file mode 100644 (file)
index 2725caa..0000000
+++ /dev/null
@@ -1,53 +0,0 @@
-/*================================================================
-** Copyright 2000, Clark Cooper
-** All rights reserved.
-**
-** This is free software. You are permitted to copy, distribute, or modify
-** it under the terms of the MIT/X license (contained in the COPYING file
-** with this distribution.)
-**
-*/
-
-#ifndef MACCONFIG_H
-#define MACCONFIG_H
-
-
-/* 1234 = LIL_ENDIAN, 4321 = BIGENDIAN */
-#define BYTEORDER  4321
-
-/* Define to 1 if you have the `bcopy' function. */
-#undef HAVE_BCOPY
-
-/* Define to 1 if you have the `memmove' function. */
-#define HAVE_MEMMOVE
-
-/* Define to 1 if you have a working `mmap' system call. */
-#undef HAVE_MMAP
-
-/* Define to 1 if you have the <unistd.h> header file. */
-#undef HAVE_UNISTD_H
-
-/* whether byteorder is bigendian */
-#define WORDS_BIGENDIAN
-
-/* Define to specify how much context to retain around the current parse
-   point. */
-#undef XML_CONTEXT_BYTES
-
-/* Define to make parameter entity parsing functionality available. */
-#define XML_DTD
-
-/* Define to make XML Namespaces functionality available. */
-#define XML_NS
-
-/* Define to empty if `const' does not conform to ANSI C. */
-#undef const
-
-/* Define to `long' if <sys/types.h> does not define. */
-#define off_t  long
-
-/* Define to `unsigned' if <sys/types.h> does not define. */
-#undef size_t
-
-
-#endif /* ifndef MACCONFIG_H */
diff --git a/Modules/expat/siphash.h b/Modules/expat/siphash.h
new file mode 100644 (file)
index 0000000..23b56d2
--- /dev/null
@@ -0,0 +1,344 @@
+/* ==========================================================================
+ * siphash.h - SipHash-2-4 in a single header file
+ * --------------------------------------------------------------------------
+ * Derived by William Ahern from the reference implementation[1] published[2]
+ * by Jean-Philippe Aumasson and Daniel J. Berstein. Licensed in kind.
+ * by Jean-Philippe Aumasson and Daniel J. Berstein.
+ * Minimal changes by Sebastian Pipping on top, details below.
+ * Licensed under the CC0 Public Domain Dedication license.
+ *
+ * 1. https://www.131002.net/siphash/siphash24.c
+ * 2. https://www.131002.net/siphash/
+ * --------------------------------------------------------------------------
+ * HISTORY:
+ *
+ * 2017-06-10  (Sebastian Pipping)
+ *   - Clarify license note in the header
+ *   - Address C89 issues:
+ *     - Stop using inline keyword (and let compiler decide)
+ *     - Turn integer suffix ULL to UL
+ *     - Replace _Bool by int
+ *     - Turn macro siphash24 into a function
+ *     - Address invalid conversion (void pointer) by explicit cast
+ *   - Always expose sip24_valid (for self-tests)
+ *
+ * 2012-11-04 - Born.  (William Ahern)
+ * --------------------------------------------------------------------------
+ * USAGE:
+ *
+ * SipHash-2-4 takes as input two 64-bit words as the key, some number of
+ * message bytes, and outputs a 64-bit word as the message digest. This
+ * implementation employs two data structures: a struct sipkey for
+ * representing the key, and a struct siphash for representing the hash
+ * state.
+ *
+ * For converting a 16-byte unsigned char array to a key, use either the
+ * macro sip_keyof or the routine sip_tokey. The former instantiates a
+ * compound literal key, while the latter requires a key object as a
+ * parameter.
+ *
+ *     unsigned char secret[16];
+ *     arc4random_buf(secret, sizeof secret);
+ *     struct sipkey *key = sip_keyof(secret);
+ *
+ * For hashing a message, use either the convenience macro siphash24 or the
+ * routines sip24_init, sip24_update, and sip24_final.
+ *
+ *     struct siphash state;
+ *     void *msg;
+ *     size_t len;
+ *     uint64_t hash;
+ *
+ *     sip24_init(&state, key);
+ *     sip24_update(&state, msg, len);
+ *     hash = sip24_final(&state);
+ *
+ * or
+ *
+ *     hash = siphash24(msg, len, key);
+ *
+ * To convert the 64-bit hash value to a canonical 8-byte little-endian
+ * binary representation, use either the macro sip_binof or the routine
+ * sip_tobin. The former instantiates and returns a compound literal array,
+ * while the latter requires an array object as a parameter.
+ * --------------------------------------------------------------------------
+ * NOTES:
+ *
+ * o Neither sip_keyof, sip_binof, nor siphash24 will work with compilers
+ *   lacking compound literal support. Instead, you must use the lower-level
+ *   interfaces which take as parameters the temporary state objects.
+ *
+ * o Uppercase macros may evaluate parameters more than once. Lowercase
+ *   macros should not exhibit any such side effects.
+ * ==========================================================================
+ */
+#ifndef SIPHASH_H
+#define SIPHASH_H
+
+#include <stddef.h> /* size_t */
+#include <stdint.h> /* uint64_t uint32_t uint8_t */
+
+
+#define SIP_ROTL(x, b) (uint64_t)(((x) << (b)) | ( (x) >> (64 - (b))))
+
+#define SIP_U32TO8_LE(p, v) \
+       (p)[0] = (uint8_t)((v) >>  0); (p)[1] = (uint8_t)((v) >>  8); \
+       (p)[2] = (uint8_t)((v) >> 16); (p)[3] = (uint8_t)((v) >> 24);
+
+#define SIP_U64TO8_LE(p, v) \
+       SIP_U32TO8_LE((p) + 0, (uint32_t)((v) >>  0)); \
+       SIP_U32TO8_LE((p) + 4, (uint32_t)((v) >> 32));
+
+#define SIP_U8TO64_LE(p) \
+       (((uint64_t)((p)[0]) <<  0) | \
+        ((uint64_t)((p)[1]) <<  8) | \
+        ((uint64_t)((p)[2]) << 16) | \
+        ((uint64_t)((p)[3]) << 24) | \
+        ((uint64_t)((p)[4]) << 32) | \
+        ((uint64_t)((p)[5]) << 40) | \
+        ((uint64_t)((p)[6]) << 48) | \
+        ((uint64_t)((p)[7]) << 56))
+
+
+#define SIPHASH_INITIALIZER { 0, 0, 0, 0, { 0 }, 0, 0 }
+
+struct siphash {
+       uint64_t v0, v1, v2, v3;
+
+       unsigned char buf[8], *p;
+       uint64_t c;
+}; /* struct siphash */
+
+
+#define SIP_KEYLEN 16
+
+struct sipkey {
+       uint64_t k[2];
+}; /* struct sipkey */
+
+#define sip_keyof(k) sip_tokey(&(struct sipkey){ { 0 } }, (k))
+
+static struct sipkey *sip_tokey(struct sipkey *key, const void *src) {
+       key->k[0] = SIP_U8TO64_LE((const unsigned char *)src);
+       key->k[1] = SIP_U8TO64_LE((const unsigned char *)src + 8);
+       return key;
+} /* sip_tokey() */
+
+
+#define sip_binof(v) sip_tobin((unsigned char[8]){ 0 }, (v))
+
+static void *sip_tobin(void *dst, uint64_t u64) {
+       SIP_U64TO8_LE((unsigned char *)dst, u64);
+       return dst;
+} /* sip_tobin() */
+
+
+static void sip_round(struct siphash *H, const int rounds) {
+       int i;
+
+       for (i = 0; i < rounds; i++) {
+               H->v0 += H->v1;
+               H->v1 = SIP_ROTL(H->v1, 13);
+               H->v1 ^= H->v0;
+               H->v0 = SIP_ROTL(H->v0, 32);
+
+               H->v2 += H->v3;
+               H->v3 = SIP_ROTL(H->v3, 16);
+               H->v3 ^= H->v2;
+
+               H->v0 += H->v3;
+               H->v3 = SIP_ROTL(H->v3, 21);
+               H->v3 ^= H->v0;
+
+               H->v2 += H->v1;
+               H->v1 = SIP_ROTL(H->v1, 17);
+               H->v1 ^= H->v2;
+               H->v2 = SIP_ROTL(H->v2, 32);
+       }
+} /* sip_round() */
+
+
+static struct siphash *sip24_init(struct siphash *H, const struct sipkey *key) {
+       H->v0 = 0x736f6d6570736575UL ^ key->k[0];
+       H->v1 = 0x646f72616e646f6dUL ^ key->k[1];
+       H->v2 = 0x6c7967656e657261UL ^ key->k[0];
+       H->v3 = 0x7465646279746573UL ^ key->k[1];
+
+       H->p = H->buf;
+       H->c = 0;
+
+       return H;
+} /* sip24_init() */
+
+
+#define sip_endof(a) (&(a)[sizeof (a) / sizeof *(a)])
+
+static struct siphash *sip24_update(struct siphash *H, const void *src, size_t len) {
+       const unsigned char *p = (const unsigned char *)src, *pe = p + len;
+       uint64_t m;
+
+       do {
+               while (p < pe && H->p < sip_endof(H->buf))
+                       *H->p++ = *p++;
+
+               if (H->p < sip_endof(H->buf))
+                       break;
+
+               m = SIP_U8TO64_LE(H->buf);
+               H->v3 ^= m;
+               sip_round(H, 2);
+               H->v0 ^= m;
+
+               H->p = H->buf;
+               H->c += 8;
+       } while (p < pe);
+
+       return H;
+} /* sip24_update() */
+
+
+static uint64_t sip24_final(struct siphash *H) {
+       char left = H->p - H->buf;
+       uint64_t b = (H->c + left) << 56;
+
+       switch (left) {
+       case 7: b |= (uint64_t)H->buf[6] << 48;
+       case 6: b |= (uint64_t)H->buf[5] << 40;
+       case 5: b |= (uint64_t)H->buf[4] << 32;
+       case 4: b |= (uint64_t)H->buf[3] << 24;
+       case 3: b |= (uint64_t)H->buf[2] << 16;
+       case 2: b |= (uint64_t)H->buf[1] << 8;
+       case 1: b |= (uint64_t)H->buf[0] << 0;
+       case 0: break;
+       }
+
+       H->v3 ^= b;
+       sip_round(H, 2);
+       H->v0 ^= b;
+       H->v2 ^= 0xff;
+       sip_round(H, 4);
+
+       return H->v0 ^ H->v1 ^ H->v2  ^ H->v3;
+} /* sip24_final() */
+
+
+static uint64_t siphash24(const void *src, size_t len, const struct sipkey *key) {
+       struct siphash state = SIPHASH_INITIALIZER;
+       return sip24_final(sip24_update(sip24_init(&state, key), src, len));
+} /* siphash24() */
+
+
+/*
+ * SipHash-2-4 output with
+ * k = 00 01 02 ...
+ * and
+ * in = (empty string)
+ * in = 00 (1 byte)
+ * in = 00 01 (2 bytes)
+ * in = 00 01 02 (3 bytes)
+ * ...
+ * in = 00 01 02 ... 3e (63 bytes)
+ */
+static int sip24_valid(void) {
+       static const unsigned char vectors[64][8] = {
+               { 0x31, 0x0e, 0x0e, 0xdd, 0x47, 0xdb, 0x6f, 0x72, },
+               { 0xfd, 0x67, 0xdc, 0x93, 0xc5, 0x39, 0xf8, 0x74, },
+               { 0x5a, 0x4f, 0xa9, 0xd9, 0x09, 0x80, 0x6c, 0x0d, },
+               { 0x2d, 0x7e, 0xfb, 0xd7, 0x96, 0x66, 0x67, 0x85, },
+               { 0xb7, 0x87, 0x71, 0x27, 0xe0, 0x94, 0x27, 0xcf, },
+               { 0x8d, 0xa6, 0x99, 0xcd, 0x64, 0x55, 0x76, 0x18, },
+               { 0xce, 0xe3, 0xfe, 0x58, 0x6e, 0x46, 0xc9, 0xcb, },
+               { 0x37, 0xd1, 0x01, 0x8b, 0xf5, 0x00, 0x02, 0xab, },
+               { 0x62, 0x24, 0x93, 0x9a, 0x79, 0xf5, 0xf5, 0x93, },
+               { 0xb0, 0xe4, 0xa9, 0x0b, 0xdf, 0x82, 0x00, 0x9e, },
+               { 0xf3, 0xb9, 0xdd, 0x94, 0xc5, 0xbb, 0x5d, 0x7a, },
+               { 0xa7, 0xad, 0x6b, 0x22, 0x46, 0x2f, 0xb3, 0xf4, },
+               { 0xfb, 0xe5, 0x0e, 0x86, 0xbc, 0x8f, 0x1e, 0x75, },
+               { 0x90, 0x3d, 0x84, 0xc0, 0x27, 0x56, 0xea, 0x14, },
+               { 0xee, 0xf2, 0x7a, 0x8e, 0x90, 0xca, 0x23, 0xf7, },
+               { 0xe5, 0x45, 0xbe, 0x49, 0x61, 0xca, 0x29, 0xa1, },
+               { 0xdb, 0x9b, 0xc2, 0x57, 0x7f, 0xcc, 0x2a, 0x3f, },
+               { 0x94, 0x47, 0xbe, 0x2c, 0xf5, 0xe9, 0x9a, 0x69, },
+               { 0x9c, 0xd3, 0x8d, 0x96, 0xf0, 0xb3, 0xc1, 0x4b, },
+               { 0xbd, 0x61, 0x79, 0xa7, 0x1d, 0xc9, 0x6d, 0xbb, },
+               { 0x98, 0xee, 0xa2, 0x1a, 0xf2, 0x5c, 0xd6, 0xbe, },
+               { 0xc7, 0x67, 0x3b, 0x2e, 0xb0, 0xcb, 0xf2, 0xd0, },
+               { 0x88, 0x3e, 0xa3, 0xe3, 0x95, 0x67, 0x53, 0x93, },
+               { 0xc8, 0xce, 0x5c, 0xcd, 0x8c, 0x03, 0x0c, 0xa8, },
+               { 0x94, 0xaf, 0x49, 0xf6, 0xc6, 0x50, 0xad, 0xb8, },
+               { 0xea, 0xb8, 0x85, 0x8a, 0xde, 0x92, 0xe1, 0xbc, },
+               { 0xf3, 0x15, 0xbb, 0x5b, 0xb8, 0x35, 0xd8, 0x17, },
+               { 0xad, 0xcf, 0x6b, 0x07, 0x63, 0x61, 0x2e, 0x2f, },
+               { 0xa5, 0xc9, 0x1d, 0xa7, 0xac, 0xaa, 0x4d, 0xde, },
+               { 0x71, 0x65, 0x95, 0x87, 0x66, 0x50, 0xa2, 0xa6, },
+               { 0x28, 0xef, 0x49, 0x5c, 0x53, 0xa3, 0x87, 0xad, },
+               { 0x42, 0xc3, 0x41, 0xd8, 0xfa, 0x92, 0xd8, 0x32, },
+               { 0xce, 0x7c, 0xf2, 0x72, 0x2f, 0x51, 0x27, 0x71, },
+               { 0xe3, 0x78, 0x59, 0xf9, 0x46, 0x23, 0xf3, 0xa7, },
+               { 0x38, 0x12, 0x05, 0xbb, 0x1a, 0xb0, 0xe0, 0x12, },
+               { 0xae, 0x97, 0xa1, 0x0f, 0xd4, 0x34, 0xe0, 0x15, },
+               { 0xb4, 0xa3, 0x15, 0x08, 0xbe, 0xff, 0x4d, 0x31, },
+               { 0x81, 0x39, 0x62, 0x29, 0xf0, 0x90, 0x79, 0x02, },
+               { 0x4d, 0x0c, 0xf4, 0x9e, 0xe5, 0xd4, 0xdc, 0xca, },
+               { 0x5c, 0x73, 0x33, 0x6a, 0x76, 0xd8, 0xbf, 0x9a, },
+               { 0xd0, 0xa7, 0x04, 0x53, 0x6b, 0xa9, 0x3e, 0x0e, },
+               { 0x92, 0x59, 0x58, 0xfc, 0xd6, 0x42, 0x0c, 0xad, },
+               { 0xa9, 0x15, 0xc2, 0x9b, 0xc8, 0x06, 0x73, 0x18, },
+               { 0x95, 0x2b, 0x79, 0xf3, 0xbc, 0x0a, 0xa6, 0xd4, },
+               { 0xf2, 0x1d, 0xf2, 0xe4, 0x1d, 0x45, 0x35, 0xf9, },
+               { 0x87, 0x57, 0x75, 0x19, 0x04, 0x8f, 0x53, 0xa9, },
+               { 0x10, 0xa5, 0x6c, 0xf5, 0xdf, 0xcd, 0x9a, 0xdb, },
+               { 0xeb, 0x75, 0x09, 0x5c, 0xcd, 0x98, 0x6c, 0xd0, },
+               { 0x51, 0xa9, 0xcb, 0x9e, 0xcb, 0xa3, 0x12, 0xe6, },
+               { 0x96, 0xaf, 0xad, 0xfc, 0x2c, 0xe6, 0x66, 0xc7, },
+               { 0x72, 0xfe, 0x52, 0x97, 0x5a, 0x43, 0x64, 0xee, },
+               { 0x5a, 0x16, 0x45, 0xb2, 0x76, 0xd5, 0x92, 0xa1, },
+               { 0xb2, 0x74, 0xcb, 0x8e, 0xbf, 0x87, 0x87, 0x0a, },
+               { 0x6f, 0x9b, 0xb4, 0x20, 0x3d, 0xe7, 0xb3, 0x81, },
+               { 0xea, 0xec, 0xb2, 0xa3, 0x0b, 0x22, 0xa8, 0x7f, },
+               { 0x99, 0x24, 0xa4, 0x3c, 0xc1, 0x31, 0x57, 0x24, },
+               { 0xbd, 0x83, 0x8d, 0x3a, 0xaf, 0xbf, 0x8d, 0xb7, },
+               { 0x0b, 0x1a, 0x2a, 0x32, 0x65, 0xd5, 0x1a, 0xea, },
+               { 0x13, 0x50, 0x79, 0xa3, 0x23, 0x1c, 0xe6, 0x60, },
+               { 0x93, 0x2b, 0x28, 0x46, 0xe4, 0xd7, 0x06, 0x66, },
+               { 0xe1, 0x91, 0x5f, 0x5c, 0xb1, 0xec, 0xa4, 0x6c, },
+               { 0xf3, 0x25, 0x96, 0x5c, 0xa1, 0x6d, 0x62, 0x9f, },
+               { 0x57, 0x5f, 0xf2, 0x8e, 0x60, 0x38, 0x1b, 0xe5, },
+               { 0x72, 0x45, 0x06, 0xeb, 0x4c, 0x32, 0x8a, 0x95, }
+       };
+       unsigned char in[64];
+       struct sipkey k;
+       size_t i;
+
+       sip_tokey(&k, "\000\001\002\003\004\005\006\007\010\011\012\013\014\015\016\017");
+
+       for (i = 0; i < sizeof in; ++i) {
+               in[i] = i;
+
+               if (siphash24(in, i, &k) != SIP_U8TO64_LE(vectors[i]))
+                       return 0;
+       }
+
+       return 1;
+} /* sip24_valid() */
+
+
+#if SIPHASH_MAIN
+
+#include <stdio.h>
+
+int main(void) {
+       int ok = sip24_valid();
+
+       if (ok)
+               puts("OK");
+       else
+               puts("FAIL");
+
+       return !ok;
+} /* main() */
+
+#endif /* SIPHASH_MAIN */
+
+
+#endif /* SIPHASH_H */
diff --git a/Modules/expat/watcomconfig.h b/Modules/expat/watcomconfig.h
deleted file mode 100644 (file)
index 2f05e3f..0000000
+++ /dev/null
@@ -1,47 +0,0 @@
-/* expat_config.h for use with Open Watcom 1.5 and above.  */
-
-#ifndef WATCOMCONFIG_H
-#define WATCOMCONFIG_H
-
-#ifdef __NT__
-#define WIN32_LEAN_AND_MEAN
-#include <windows.h>
-#undef WIN32_LEAN_AND_MEAN
-#endif
-
-/* 1234 = LIL_ENDIAN, 4321 = BIGENDIAN */
-#define BYTEORDER 1234
-
-/* Define to 1 if you have the `memmove' function. */
-#define HAVE_MEMMOVE 1
-
-/* Define to 1 if you have the <unistd.h> header file. */
-#define HAVE_UNISTD_H 1
-
-/* Define to the address where bug reports for this package should be sent. */
-#define PACKAGE_BUGREPORT "expat-bugs@mail.libexpat.org"
-
-/* Define to the full name of this package. */
-#define PACKAGE_NAME "expat"
-
-/* Define to the full name and version of this package. */
-#define PACKAGE_STRING "expat 2.0.0"
-
-/* Define to the one symbol short name of this package. */
-#undef PACKAGE_TARNAME
-
-/* Define to the version of this package. */
-#define PACKAGE_VERSION "2.0.0"
-
-/* Define to specify how much context to retain around the current parse
-   point. */
-#define XML_CONTEXT_BYTES 1024
-
-/* Define to make parameter entity parsing functionality available. */
-#define XML_DTD 1
-
-/* Define to make XML Namespaces functionality available. */
-#define XML_NS 1
-
-#endif
-
index c1b791d..9bf014d 100644 (file)
 #include <memory.h>
 #include <string.h>
 
+
+#if defined(HAVE_EXPAT_CONFIG_H)  /* e.g. MinGW */
+# include <expat_config.h>
+#else  /* !defined(HAVE_EXPAT_CONFIG_H) */
+
+
 #define XML_NS 1
 #define XML_DTD 1
 #define XML_CONTEXT_BYTES 1024
@@ -27,4 +33,8 @@
 /* Windows has memmove() available. */
 #define HAVE_MEMMOVE
 
+
+#endif /* !defined(HAVE_EXPAT_CONFIG_H) */
+
+
 #endif /* ndef WINCONFIG_H */
index 4128387..76f078e 100644 (file)
@@ -1,29 +1,37 @@
 /* Copyright (c) 1998, 1999, 2000 Thai Open Source Software Center Ltd
    See the file COPYING for copying permission.
-*/
 
-#define XML_BUILDING_EXPAT 1
+   77fea421d361dca90041d0040ecf1dca651167fadf2af79e990e35168d70d933 (2.2.1+)
+*/
 
-#ifdef COMPILED_FROM_DSP
-#include "winconfig.h"
-#elif defined(MACOS_CLASSIC)
-#include "macconfig.h"
-#elif defined(__amigaos__)
-#include "amigaconfig.h"
-#elif defined(__WATCOMC__)
-#include "watcomconfig.h"
-#elif defined(HAVE_EXPAT_CONFIG_H)
-#include <expat_config.h>
-#endif /* ndef COMPILED_FROM_DSP */
+#define _GNU_SOURCE                     /* syscall prototype */
 
 #include <stddef.h>
 #include <string.h>                     /* memset(), memcpy() */
 #include <assert.h>
 #include <limits.h>                     /* UINT_MAX */
-#include <time.h>                       /* time() */
+#include <stdio.h>                      /* fprintf */
+#include <stdlib.h>                     /* getenv */
+
+#ifdef _WIN32
+#define getpid GetCurrentProcessId
+#else
+#include <sys/time.h>                   /* gettimeofday() */
+#include <sys/types.h>                  /* getpid() */
+#include <unistd.h>                     /* getpid() */
+#endif
+
+#define XML_BUILDING_EXPAT 1
+
+#ifdef _WIN32
+#include "winconfig.h"
+#elif defined(HAVE_EXPAT_CONFIG_H)
+#include <expat_config.h>
+#endif /* ndef _WIN32 */
 
 #include "ascii.h"
 #include "expat.h"
+#include "siphash.h"
 
 #ifdef XML_UNICODE
 #define XML_ENCODE_MAX XML_UTF16_ENCODE_MAX
@@ -102,17 +110,11 @@ typedef struct {
   const XML_Memory_Handling_Suite *mem;
 } HASH_TABLE;
 
-/* Basic character hash algorithm, taken from Python's string hash:
-   h = h * 1000003 ^ character, the constant being a prime number.
+static size_t
+keylen(KEY s);
 
-*/
-#ifdef XML_UNICODE
-#define CHAR_HASH(h, c) \
-  (((h) * 0xF4243) ^ (unsigned short)(c))
-#else
-#define CHAR_HASH(h, c) \
-  (((h) * 0xF4243) ^ (unsigned char)(c))
-#endif
+static void
+copy_salt_to_sipkey(XML_Parser parser, struct sipkey * key);
 
 /* For probing (after a collision) we need a step size relative prime
    to the hash table size, which is a power of 2. We use double-hashing,
@@ -348,6 +350,8 @@ doIgnoreSection(XML_Parser parser, const ENCODING *, const char **startPtr,
                 const char *end, const char **nextPtr, XML_Bool haveMore);
 #endif /* XML_DTD */
 
+static void
+freeBindings(XML_Parser parser, BINDING *bindings);
 static enum XML_Error
 storeAtts(XML_Parser parser, const ENCODING *, const char *s,
           TAG_NAME *tagNamePtr, BINDING **bindingsPtr);
@@ -432,7 +436,7 @@ static ELEMENT_TYPE *
 getElementType(XML_Parser parser, const ENCODING *enc,
                const char *ptr, const char *end);
 
-static unsigned long generate_hash_secret_salt(void);
+static unsigned long generate_hash_secret_salt(XML_Parser parser);
 static XML_Bool startParsing(XML_Parser parser);
 
 static XML_Parser
@@ -690,12 +694,155 @@ static const XML_Char implicitContext[] = {
   ASCII_s, ASCII_p, ASCII_a, ASCII_c, ASCII_e, '\0'
 };
 
+
+#if defined(HAVE_GETRANDOM) || defined(HAVE_SYSCALL_GETRANDOM)
+# include <errno.h>
+
+# if defined(HAVE_GETRANDOM)
+#  include <sys/random.h>    /* getrandom */
+# else
+#  include <unistd.h>        /* syscall */
+#  include <sys/syscall.h>   /* SYS_getrandom */
+# endif
+
+/* Obtain entropy on Linux 3.17+ */
+static int
+writeRandomBytes_getrandom(void * target, size_t count) {
+  int success = 0;  /* full count bytes written? */
+  size_t bytesWrittenTotal = 0;
+  const unsigned int getrandomFlags = 0;
+
+  do {
+    void * const currentTarget = (void*)((char*)target + bytesWrittenTotal);
+    const size_t bytesToWrite = count - bytesWrittenTotal;
+
+    const int bytesWrittenMore =
+#if defined(HAVE_GETRANDOM)
+        getrandom(currentTarget, bytesToWrite, getrandomFlags);
+#else
+        syscall(SYS_getrandom, currentTarget, bytesToWrite, getrandomFlags);
+#endif
+
+    if (bytesWrittenMore > 0) {
+      bytesWrittenTotal += bytesWrittenMore;
+      if (bytesWrittenTotal >= count)
+        success = 1;
+    }
+  } while (! success && (errno == EINTR || errno == EAGAIN));
+
+  return success;
+}
+
+#endif  /* defined(HAVE_GETRANDOM) || defined(HAVE_SYSCALL_GETRANDOM) */
+
+
+#ifdef _WIN32
+
+typedef BOOLEAN (APIENTRY *RTLGENRANDOM_FUNC)(PVOID, ULONG);
+
+/* Obtain entropy on Windows XP / Windows Server 2003 and later.
+ * Hint on RtlGenRandom and the following article from libsodioum.
+ *
+ * Michael Howard: Cryptographically Secure Random number on Windows without using CryptoAPI
+ * https://blogs.msdn.microsoft.com/michael_howard/2005/01/14/cryptographically-secure-random-number-on-windows-without-using-cryptoapi/
+ */
+static int
+writeRandomBytes_RtlGenRandom(void * target, size_t count) {
+  int success = 0;  /* full count bytes written? */
+  const HMODULE advapi32 = LoadLibrary("ADVAPI32.DLL");
+
+  if (advapi32) {
+    const RTLGENRANDOM_FUNC RtlGenRandom
+        = (RTLGENRANDOM_FUNC)GetProcAddress(advapi32, "SystemFunction036");
+    if (RtlGenRandom) {
+      if (RtlGenRandom((PVOID)target, (ULONG)count) == TRUE) {
+        success = 1;
+      }
+    }
+    FreeLibrary(advapi32);
+  }
+
+  return success;
+}
+
+#endif /* _WIN32 */
+
+
 static unsigned long
-generate_hash_secret_salt(void)
+gather_time_entropy(void)
 {
-  unsigned int seed = time(NULL) % UINT_MAX;
-  srand(seed);
-  return rand();
+#ifdef _WIN32
+  FILETIME ft;
+  GetSystemTimeAsFileTime(&ft); /* never fails */
+  return ft.dwHighDateTime ^ ft.dwLowDateTime;
+#else
+  struct timeval tv;
+  int gettimeofday_res;
+
+  gettimeofday_res = gettimeofday(&tv, NULL);
+  assert (gettimeofday_res == 0);
+
+  /* Microseconds time is <20 bits entropy */
+  return tv.tv_usec;
+#endif
+}
+
+#if defined(HAVE_ARC4RANDOM_BUF) && defined(HAVE_LIBBSD)
+# include <bsd/stdlib.h>
+#endif
+
+static unsigned long
+ENTROPY_DEBUG(const char * label, unsigned long entropy) {
+  const char * const EXPAT_ENTROPY_DEBUG = getenv("EXPAT_ENTROPY_DEBUG");
+  if (EXPAT_ENTROPY_DEBUG && ! strcmp(EXPAT_ENTROPY_DEBUG, "1")) {
+    fprintf(stderr, "Entropy: %s --> 0x%0*lx (%lu bytes)\n",
+        label,
+        (int)sizeof(entropy) * 2, entropy,
+        (unsigned long)sizeof(entropy));
+  }
+  return entropy;
+}
+
+static unsigned long
+generate_hash_secret_salt(XML_Parser parser)
+{
+  unsigned long entropy;
+  (void)parser;
+#if defined(HAVE_ARC4RANDOM_BUF) || defined(__CloudABI__)
+  (void)gather_time_entropy;
+  arc4random_buf(&entropy, sizeof(entropy));
+  return ENTROPY_DEBUG("arc4random_buf", entropy);
+#else
+  /* Try high quality providers first .. */
+#ifdef _WIN32
+  if (writeRandomBytes_RtlGenRandom((void *)&entropy, sizeof(entropy))) {
+    return ENTROPY_DEBUG("RtlGenRandom", entropy);
+  }
+#elif defined(HAVE_GETRANDOM) || defined(HAVE_SYSCALL_GETRANDOM)
+  if (writeRandomBytes_getrandom((void *)&entropy, sizeof(entropy))) {
+    return ENTROPY_DEBUG("getrandom", entropy);
+  }
+#endif
+  /* .. and self-made low quality for backup: */
+
+  /* Process ID is 0 bits entropy if attacker has local access */
+  entropy = gather_time_entropy() ^ getpid();
+
+  /* Factors are 2^31-1 and 2^61-1 (Mersenne primes M31 and M61) */
+  if (sizeof(unsigned long) == 4) {
+    return ENTROPY_DEBUG("fallback(4)", entropy * 2147483647);
+  } else {
+    return ENTROPY_DEBUG("fallback(8)",
+        entropy * (unsigned long)2305843009213693951);
+  }
+#endif
+}
+
+static unsigned long
+get_hash_secret_salt(XML_Parser parser) {
+  if (parser->m_parentParser != NULL)
+    return get_hash_secret_salt(parser->m_parentParser);
+  return parser->m_hash_secret_salt;
 }
 
 static XML_Bool  /* only valid for root parser */
@@ -703,7 +850,7 @@ startParsing(XML_Parser parser)
 {
     /* hash functions must be initialized before setContext() is called */
     if (hash_secret_salt == 0)
-      hash_secret_salt = generate_hash_secret_salt();
+      hash_secret_salt = generate_hash_secret_salt(parser);
     if (ns) {
       /* implicit context only set for root parser, since child
          parsers (i.e. external entity parsers) will inherit it
@@ -926,6 +1073,10 @@ XML_ParserReset(XML_Parser parser, const XML_Char *encodingName)
 {
   TAG *tStk;
   OPEN_INTERNAL_ENTITY *openEntityList;
+
+  if (parser == NULL)
+      return XML_FALSE;
+
   if (parentParser)
     return XML_FALSE;
   /* move tagStack to freeTagList */
@@ -960,6 +1111,8 @@ XML_ParserReset(XML_Parser parser, const XML_Char *encodingName)
 enum XML_Status XMLCALL
 XML_SetEncoding(XML_Parser parser, const XML_Char *encodingName)
 {
+  if (parser == NULL)
+      return XML_STATUS_ERROR;
   /* Block after XML_Parse()/XML_ParseBuffer() has been called.
      XXX There's no way for the caller to determine which of the
      XXX possible error cases caused the XML_STATUS_ERROR return.
@@ -983,52 +1136,88 @@ XML_ExternalEntityParserCreate(XML_Parser oldParser,
 {
   XML_Parser parser = oldParser;
   DTD *newDtd = NULL;
-  DTD *oldDtd = _dtd;
-  XML_StartElementHandler oldStartElementHandler = startElementHandler;
-  XML_EndElementHandler oldEndElementHandler = endElementHandler;
-  XML_CharacterDataHandler oldCharacterDataHandler = characterDataHandler;
-  XML_ProcessingInstructionHandler oldProcessingInstructionHandler
-      = processingInstructionHandler;
-  XML_CommentHandler oldCommentHandler = commentHandler;
-  XML_StartCdataSectionHandler oldStartCdataSectionHandler
-      = startCdataSectionHandler;
-  XML_EndCdataSectionHandler oldEndCdataSectionHandler
-      = endCdataSectionHandler;
-  XML_DefaultHandler oldDefaultHandler = defaultHandler;
-  XML_UnparsedEntityDeclHandler oldUnparsedEntityDeclHandler
-      = unparsedEntityDeclHandler;
-  XML_NotationDeclHandler oldNotationDeclHandler = notationDeclHandler;
-  XML_StartNamespaceDeclHandler oldStartNamespaceDeclHandler
-      = startNamespaceDeclHandler;
-  XML_EndNamespaceDeclHandler oldEndNamespaceDeclHandler
-      = endNamespaceDeclHandler;
-  XML_NotStandaloneHandler oldNotStandaloneHandler = notStandaloneHandler;
-  XML_ExternalEntityRefHandler oldExternalEntityRefHandler
-      = externalEntityRefHandler;
-  XML_SkippedEntityHandler oldSkippedEntityHandler = skippedEntityHandler;
-  XML_UnknownEncodingHandler oldUnknownEncodingHandler
-      = unknownEncodingHandler;
-  XML_ElementDeclHandler oldElementDeclHandler = elementDeclHandler;
-  XML_AttlistDeclHandler oldAttlistDeclHandler = attlistDeclHandler;
-  XML_EntityDeclHandler oldEntityDeclHandler = entityDeclHandler;
-  XML_XmlDeclHandler oldXmlDeclHandler = xmlDeclHandler;
-  ELEMENT_TYPE * oldDeclElementType = declElementType;
-
-  void *oldUserData = userData;
-  void *oldHandlerArg = handlerArg;
-  XML_Bool oldDefaultExpandInternalEntities = defaultExpandInternalEntities;
-  XML_Parser oldExternalEntityRefHandlerArg = externalEntityRefHandlerArg;
+  DTD *oldDtd;
+  XML_StartElementHandler oldStartElementHandler;
+  XML_EndElementHandler oldEndElementHandler;
+  XML_CharacterDataHandler oldCharacterDataHandler;
+  XML_ProcessingInstructionHandler oldProcessingInstructionHandler;
+  XML_CommentHandler oldCommentHandler;
+  XML_StartCdataSectionHandler oldStartCdataSectionHandler;
+  XML_EndCdataSectionHandler oldEndCdataSectionHandler;
+  XML_DefaultHandler oldDefaultHandler;
+  XML_UnparsedEntityDeclHandler oldUnparsedEntityDeclHandler;
+  XML_NotationDeclHandler oldNotationDeclHandler;
+  XML_StartNamespaceDeclHandler oldStartNamespaceDeclHandler;
+  XML_EndNamespaceDeclHandler oldEndNamespaceDeclHandler;
+  XML_NotStandaloneHandler oldNotStandaloneHandler;
+  XML_ExternalEntityRefHandler oldExternalEntityRefHandler;
+  XML_SkippedEntityHandler oldSkippedEntityHandler;
+  XML_UnknownEncodingHandler oldUnknownEncodingHandler;
+  XML_ElementDeclHandler oldElementDeclHandler;
+  XML_AttlistDeclHandler oldAttlistDeclHandler;
+  XML_EntityDeclHandler oldEntityDeclHandler;
+  XML_XmlDeclHandler oldXmlDeclHandler;
+  ELEMENT_TYPE * oldDeclElementType;
+
+  void *oldUserData;
+  void *oldHandlerArg;
+  XML_Bool oldDefaultExpandInternalEntities;
+  XML_Parser oldExternalEntityRefHandlerArg;
 #ifdef XML_DTD
-  enum XML_ParamEntityParsing oldParamEntityParsing = paramEntityParsing;
-  int oldInEntityValue = prologState.inEntityValue;
+  enum XML_ParamEntityParsing oldParamEntityParsing;
+  int oldInEntityValue;
+#endif
+  XML_Bool oldns_triplets;
+  /* Note that the new parser shares the same hash secret as the old
+     parser, so that dtdCopy and copyEntityTable can lookup values
+     from hash tables associated with either parser without us having
+     to worry which hash secrets each table has.
+  */
+  unsigned long oldhash_secret_salt;
+
+  /* Validate the oldParser parameter before we pull everything out of it */
+  if (oldParser == NULL)
+    return NULL;
+
+  /* Stash the original parser contents on the stack */
+  oldDtd = _dtd;
+  oldStartElementHandler = startElementHandler;
+  oldEndElementHandler = endElementHandler;
+  oldCharacterDataHandler = characterDataHandler;
+  oldProcessingInstructionHandler = processingInstructionHandler;
+  oldCommentHandler = commentHandler;
+  oldStartCdataSectionHandler = startCdataSectionHandler;
+  oldEndCdataSectionHandler = endCdataSectionHandler;
+  oldDefaultHandler = defaultHandler;
+  oldUnparsedEntityDeclHandler = unparsedEntityDeclHandler;
+  oldNotationDeclHandler = notationDeclHandler;
+  oldStartNamespaceDeclHandler = startNamespaceDeclHandler;
+  oldEndNamespaceDeclHandler = endNamespaceDeclHandler;
+  oldNotStandaloneHandler = notStandaloneHandler;
+  oldExternalEntityRefHandler = externalEntityRefHandler;
+  oldSkippedEntityHandler = skippedEntityHandler;
+  oldUnknownEncodingHandler = unknownEncodingHandler;
+  oldElementDeclHandler = elementDeclHandler;
+  oldAttlistDeclHandler = attlistDeclHandler;
+  oldEntityDeclHandler = entityDeclHandler;
+  oldXmlDeclHandler = xmlDeclHandler;
+  oldDeclElementType = declElementType;
+
+  oldUserData = userData;
+  oldHandlerArg = handlerArg;
+  oldDefaultExpandInternalEntities = defaultExpandInternalEntities;
+  oldExternalEntityRefHandlerArg = externalEntityRefHandlerArg;
+#ifdef XML_DTD
+  oldParamEntityParsing = paramEntityParsing;
+  oldInEntityValue = prologState.inEntityValue;
 #endif
-  XML_Bool oldns_triplets = ns_triplets;
+  oldns_triplets = ns_triplets;
   /* Note that the new parser shares the same hash secret as the old
      parser, so that dtdCopy and copyEntityTable can lookup values
      from hash tables associated with either parser without us having
      to worry which hash secrets each table has.
   */
-  unsigned long oldhash_secret_salt = hash_secret_salt;
+  oldhash_secret_salt = hash_secret_salt;
 
 #ifdef XML_DTD
   if (!context)
@@ -1194,12 +1383,15 @@ XML_ParserFree(XML_Parser parser)
 void XMLCALL
 XML_UseParserAsHandlerArg(XML_Parser parser)
 {
-  handlerArg = parser;
+  if (parser != NULL)
+    handlerArg = parser;
 }
 
 enum XML_Error XMLCALL
 XML_UseForeignDTD(XML_Parser parser, XML_Bool useDTD)
 {
+  if (parser == NULL)
+    return XML_ERROR_INVALID_ARGUMENT;
 #ifdef XML_DTD
   /* block after XML_Parse()/XML_ParseBuffer() has been called */
   if (ps_parsing == XML_PARSING || ps_parsing == XML_SUSPENDED)
@@ -1214,6 +1406,8 @@ XML_UseForeignDTD(XML_Parser parser, XML_Bool useDTD)
 void XMLCALL
 XML_SetReturnNSTriplet(XML_Parser parser, int do_nst)
 {
+  if (parser == NULL)
+    return;
   /* block after XML_Parse()/XML_ParseBuffer() has been called */
   if (ps_parsing == XML_PARSING || ps_parsing == XML_SUSPENDED)
     return;
@@ -1223,6 +1417,8 @@ XML_SetReturnNSTriplet(XML_Parser parser, int do_nst)
 void XMLCALL
 XML_SetUserData(XML_Parser parser, void *p)
 {
+  if (parser == NULL)
+    return;
   if (handlerArg == userData)
     handlerArg = userData = p;
   else
@@ -1232,6 +1428,8 @@ XML_SetUserData(XML_Parser parser, void *p)
 enum XML_Status XMLCALL
 XML_SetBase(XML_Parser parser, const XML_Char *p)
 {
+  if (parser == NULL)
+    return XML_STATUS_ERROR;
   if (p) {
     p = poolCopyString(&_dtd->pool, p);
     if (!p)
@@ -1246,18 +1444,24 @@ XML_SetBase(XML_Parser parser, const XML_Char *p)
 const XML_Char * XMLCALL
 XML_GetBase(XML_Parser parser)
 {
+  if (parser == NULL)
+    return NULL;
   return curBase;
 }
 
 int XMLCALL
 XML_GetSpecifiedAttributeCount(XML_Parser parser)
 {
+  if (parser == NULL)
+    return -1;
   return nSpecifiedAtts;
 }
 
 int XMLCALL
 XML_GetIdAttributeIndex(XML_Parser parser)
 {
+  if (parser == NULL)
+    return -1;
   return idAttIndex;
 }
 
@@ -1265,6 +1469,8 @@ XML_GetIdAttributeIndex(XML_Parser parser)
 const XML_AttrInfo * XMLCALL
 XML_GetAttributeInfo(XML_Parser parser)
 {
+  if (parser == NULL)
+    return NULL;
   return attInfo;
 }
 #endif
@@ -1274,6 +1480,8 @@ XML_SetElementHandler(XML_Parser parser,
                       XML_StartElementHandler start,
                       XML_EndElementHandler end)
 {
+  if (parser == NULL)
+    return;
   startElementHandler = start;
   endElementHandler = end;
 }
@@ -1281,34 +1489,39 @@ XML_SetElementHandler(XML_Parser parser,
 void XMLCALL
 XML_SetStartElementHandler(XML_Parser parser,
                            XML_StartElementHandler start) {
-  startElementHandler = start;
+  if (parser != NULL)
+    startElementHandler = start;
 }
 
 void XMLCALL
 XML_SetEndElementHandler(XML_Parser parser,
                          XML_EndElementHandler end) {
-  endElementHandler = end;
+  if (parser != NULL)
+    endElementHandler = end;
 }
 
 void XMLCALL
 XML_SetCharacterDataHandler(XML_Parser parser,
                             XML_CharacterDataHandler handler)
 {
-  characterDataHandler = handler;
+  if (parser != NULL)
+    characterDataHandler = handler;
 }
 
 void XMLCALL
 XML_SetProcessingInstructionHandler(XML_Parser parser,
                                     XML_ProcessingInstructionHandler handler)
 {
-  processingInstructionHandler = handler;
+  if (parser != NULL)
+    processingInstructionHandler = handler;
 }
 
 void XMLCALL
 XML_SetCommentHandler(XML_Parser parser,
                       XML_CommentHandler handler)
 {
-  commentHandler = handler;
+  if (parser != NULL)
+    commentHandler = handler;
 }
 
 void XMLCALL
@@ -1316,6 +1529,8 @@ XML_SetCdataSectionHandler(XML_Parser parser,
                            XML_StartCdataSectionHandler start,
                            XML_EndCdataSectionHandler end)
 {
+  if (parser == NULL)
+    return;
   startCdataSectionHandler = start;
   endCdataSectionHandler = end;
 }
@@ -1323,19 +1538,23 @@ XML_SetCdataSectionHandler(XML_Parser parser,
 void XMLCALL
 XML_SetStartCdataSectionHandler(XML_Parser parser,
                                 XML_StartCdataSectionHandler start) {
-  startCdataSectionHandler = start;
+  if (parser != NULL)
+    startCdataSectionHandler = start;
 }
 
 void XMLCALL
 XML_SetEndCdataSectionHandler(XML_Parser parser,
                               XML_EndCdataSectionHandler end) {
-  endCdataSectionHandler = end;
+  if (parser != NULL)
+    endCdataSectionHandler = end;
 }
 
 void XMLCALL
 XML_SetDefaultHandler(XML_Parser parser,
                       XML_DefaultHandler handler)
 {
+  if (parser == NULL)
+    return;
   defaultHandler = handler;
   defaultExpandInternalEntities = XML_FALSE;
 }
@@ -1344,6 +1563,8 @@ void XMLCALL
 XML_SetDefaultHandlerExpand(XML_Parser parser,
                             XML_DefaultHandler handler)
 {
+  if (parser == NULL)
+    return;
   defaultHandler = handler;
   defaultExpandInternalEntities = XML_TRUE;
 }
@@ -1353,6 +1574,8 @@ XML_SetDoctypeDeclHandler(XML_Parser parser,
                           XML_StartDoctypeDeclHandler start,
                           XML_EndDoctypeDeclHandler end)
 {
+  if (parser == NULL)
+    return;
   startDoctypeDeclHandler = start;
   endDoctypeDeclHandler = end;
 }
@@ -1360,27 +1583,31 @@ XML_SetDoctypeDeclHandler(XML_Parser parser,
 void XMLCALL
 XML_SetStartDoctypeDeclHandler(XML_Parser parser,
                                XML_StartDoctypeDeclHandler start) {
-  startDoctypeDeclHandler = start;
+  if (parser != NULL)
+    startDoctypeDeclHandler = start;
 }
 
 void XMLCALL
 XML_SetEndDoctypeDeclHandler(XML_Parser parser,
                              XML_EndDoctypeDeclHandler end) {
-  endDoctypeDeclHandler = end;
+  if (parser != NULL)
+    endDoctypeDeclHandler = end;
 }
 
 void XMLCALL
 XML_SetUnparsedEntityDeclHandler(XML_Parser parser,
                                  XML_UnparsedEntityDeclHandler handler)
 {
-  unparsedEntityDeclHandler = handler;
+  if (parser != NULL)
+    unparsedEntityDeclHandler = handler;
 }
 
 void XMLCALL
 XML_SetNotationDeclHandler(XML_Parser parser,
                            XML_NotationDeclHandler handler)
 {
-  notationDeclHandler = handler;
+  if (parser != NULL)
+    notationDeclHandler = handler;
 }
 
 void XMLCALL
@@ -1388,6 +1615,8 @@ XML_SetNamespaceDeclHandler(XML_Parser parser,
                             XML_StartNamespaceDeclHandler start,
                             XML_EndNamespaceDeclHandler end)
 {
+  if (parser == NULL)
+    return;
   startNamespaceDeclHandler = start;
   endNamespaceDeclHandler = end;
 }
@@ -1395,32 +1624,38 @@ XML_SetNamespaceDeclHandler(XML_Parser parser,
 void XMLCALL
 XML_SetStartNamespaceDeclHandler(XML_Parser parser,
                                  XML_StartNamespaceDeclHandler start) {
-  startNamespaceDeclHandler = start;
+  if (parser != NULL)
+    startNamespaceDeclHandler = start;
 }
 
 void XMLCALL
 XML_SetEndNamespaceDeclHandler(XML_Parser parser,
                                XML_EndNamespaceDeclHandler end) {
-  endNamespaceDeclHandler = end;
+  if (parser != NULL)
+    endNamespaceDeclHandler = end;
 }
 
 void XMLCALL
 XML_SetNotStandaloneHandler(XML_Parser parser,
                             XML_NotStandaloneHandler handler)
 {
-  notStandaloneHandler = handler;
+  if (parser != NULL)
+    notStandaloneHandler = handler;
 }
 
 void XMLCALL
 XML_SetExternalEntityRefHandler(XML_Parser parser,
                                 XML_ExternalEntityRefHandler handler)
 {
-  externalEntityRefHandler = handler;
+  if (parser != NULL)
+    externalEntityRefHandler = handler;
 }
 
 void XMLCALL
 XML_SetExternalEntityRefHandlerArg(XML_Parser parser, void *arg)
 {
+  if (parser == NULL)
+    return;
   if (arg)
     externalEntityRefHandlerArg = (XML_Parser)arg;
   else
@@ -1431,7 +1666,8 @@ void XMLCALL
 XML_SetSkippedEntityHandler(XML_Parser parser,
                             XML_SkippedEntityHandler handler)
 {
-  skippedEntityHandler = handler;
+  if (parser != NULL)
+    skippedEntityHandler = handler;
 }
 
 void XMLCALL
@@ -1439,6 +1675,8 @@ XML_SetUnknownEncodingHandler(XML_Parser parser,
                               XML_UnknownEncodingHandler handler,
                               void *data)
 {
+  if (parser == NULL)
+    return;
   unknownEncodingHandler = handler;
   unknownEncodingHandlerData = data;
 }
@@ -1447,33 +1685,39 @@ void XMLCALL
 XML_SetElementDeclHandler(XML_Parser parser,
                           XML_ElementDeclHandler eldecl)
 {
-  elementDeclHandler = eldecl;
+  if (parser != NULL)
+    elementDeclHandler = eldecl;
 }
 
 void XMLCALL
 XML_SetAttlistDeclHandler(XML_Parser parser,
                           XML_AttlistDeclHandler attdecl)
 {
-  attlistDeclHandler = attdecl;
+  if (parser != NULL)
+    attlistDeclHandler = attdecl;
 }
 
 void XMLCALL
 XML_SetEntityDeclHandler(XML_Parser parser,
                          XML_EntityDeclHandler handler)
 {
-  entityDeclHandler = handler;
+  if (parser != NULL)
+    entityDeclHandler = handler;
 }
 
 void XMLCALL
 XML_SetXmlDeclHandler(XML_Parser parser,
                       XML_XmlDeclHandler handler) {
-  xmlDeclHandler = handler;
+  if (parser != NULL)
+    xmlDeclHandler = handler;
 }
 
 int XMLCALL
 XML_SetParamEntityParsing(XML_Parser parser,
                           enum XML_ParamEntityParsing peParsing)
 {
+  if (parser == NULL)
+    return 0;
   /* block after XML_Parse()/XML_ParseBuffer() has been called */
   if (ps_parsing == XML_PARSING || ps_parsing == XML_SUSPENDED)
     return 0;
@@ -1489,6 +1733,10 @@ int XMLCALL
 XML_SetHashSalt(XML_Parser parser,
                 unsigned long hash_salt)
 {
+  if (parser == NULL)
+    return 0;
+  if (parser->m_parentParser)
+    return XML_SetHashSalt(parser->m_parentParser, hash_salt);
   /* block after XML_Parse()/XML_ParseBuffer() has been called */
   if (ps_parsing == XML_PARSING || ps_parsing == XML_SUSPENDED)
     return 0;
@@ -1499,6 +1747,10 @@ XML_SetHashSalt(XML_Parser parser,
 enum XML_Status XMLCALL
 XML_Parse(XML_Parser parser, const char *s, int len, int isFinal)
 {
+  if ((parser == NULL) || (len < 0) || ((s == NULL) && (len != 0))) {
+    errorCode = XML_ERROR_INVALID_ARGUMENT;
+    return XML_STATUS_ERROR;
+  }
   switch (ps_parsing) {
   case XML_SUSPENDED:
     errorCode = XML_ERROR_SUSPENDED;
@@ -1551,6 +1803,13 @@ XML_Parse(XML_Parser parser, const char *s, int len, int isFinal)
     const char *end;
     int nLeftOver;
     enum XML_Status result;
+    /* Detect overflow (a+b > MAX <==> b > MAX-a) */
+    if (len > ((XML_Size)-1) / 2 - parseEndByteIndex) {
+       errorCode = XML_ERROR_NO_MEMORY;
+       eventPtr = eventEndPtr = NULL;
+       processor = errorProcessor;
+       return XML_STATUS_ERROR;
+    }
     parseEndByteIndex += len;
     positionPtr = s;
     ps_finalBuffer = (XML_Bool)isFinal;
@@ -1583,11 +1842,14 @@ XML_Parse(XML_Parser parser, const char *s, int len, int isFinal)
     nLeftOver = s + len - end;
     if (nLeftOver) {
       if (buffer == NULL || nLeftOver > bufferLim - buffer) {
-        /* FIXME avoid integer overflow */
-        char *temp;
-        temp = (buffer == NULL
-                ? (char *)MALLOC(len * 2)
-                : (char *)REALLOC(buffer, len * 2));
+        /* avoid _signed_ integer overflow */
+        char *temp = NULL;
+        const int bytesToAllocate = (int)((unsigned)len * 2U);
+        if (bytesToAllocate > 0) {
+          temp = (buffer == NULL
+                ? (char *)MALLOC(bytesToAllocate)
+                : (char *)REALLOC(buffer, bytesToAllocate));
+        }
         if (temp == NULL) {
           errorCode = XML_ERROR_NO_MEMORY;
           eventPtr = eventEndPtr = NULL;
@@ -1595,7 +1857,7 @@ XML_Parse(XML_Parser parser, const char *s, int len, int isFinal)
           return XML_STATUS_ERROR;
         }
         buffer = temp;
-        bufferLim = buffer + len * 2;
+        bufferLim = buffer + bytesToAllocate;
       }
       memcpy(buffer, end, nLeftOver);
     }
@@ -1625,6 +1887,8 @@ XML_ParseBuffer(XML_Parser parser, int len, int isFinal)
   const char *start;
   enum XML_Status result = XML_STATUS_OK;
 
+  if (parser == NULL)
+    return XML_STATUS_ERROR;
   switch (ps_parsing) {
   case XML_SUSPENDED:
     errorCode = XML_ERROR_SUSPENDED;
@@ -1678,6 +1942,8 @@ XML_ParseBuffer(XML_Parser parser, int len, int isFinal)
 void * XMLCALL
 XML_GetBuffer(XML_Parser parser, int len)
 {
+  if (parser == NULL)
+    return NULL;
   if (len < 0) {
     errorCode = XML_ERROR_NO_MEMORY;
     return NULL;
@@ -1695,15 +1961,15 @@ XML_GetBuffer(XML_Parser parser, int len)
   if (len > bufferLim - bufferEnd) {
 #ifdef XML_CONTEXT_BYTES
     int keep;
-#endif
-    int neededSize = len + (int)(bufferEnd - bufferPtr);
+#endif  /* defined XML_CONTEXT_BYTES */
+    /* Do not invoke signed arithmetic overflow: */
+    int neededSize = (int) ((unsigned)len + (unsigned)(bufferEnd - bufferPtr));
     if (neededSize < 0) {
       errorCode = XML_ERROR_NO_MEMORY;
       return NULL;
     }
 #ifdef XML_CONTEXT_BYTES
     keep = (int)(bufferPtr - buffer);
-
     if (keep > XML_CONTEXT_BYTES)
       keep = XML_CONTEXT_BYTES;
     neededSize += keep;
@@ -1728,7 +1994,8 @@ XML_GetBuffer(XML_Parser parser, int len)
       if (bufferSize == 0)
         bufferSize = INIT_BUFFER_SIZE;
       do {
-        bufferSize *= 2;
+        /* Do not invoke signed arithmetic overflow: */
+        bufferSize = (int) (2U * (unsigned) bufferSize);
       } while (bufferSize < neededSize && bufferSize > 0);
       if (bufferSize <= 0) {
         errorCode = XML_ERROR_NO_MEMORY;
@@ -1773,6 +2040,8 @@ XML_GetBuffer(XML_Parser parser, int len)
 enum XML_Status XMLCALL
 XML_StopParser(XML_Parser parser, XML_Bool resumable)
 {
+  if (parser == NULL)
+    return XML_STATUS_ERROR;
   switch (ps_parsing) {
   case XML_SUSPENDED:
     if (resumable) {
@@ -1805,6 +2074,8 @@ XML_ResumeParser(XML_Parser parser)
 {
   enum XML_Status result = XML_STATUS_OK;
 
+  if (parser == NULL)
+    return XML_STATUS_ERROR;
   if (ps_parsing != XML_SUSPENDED) {
     errorCode = XML_ERROR_NOT_SUSPENDED;
     return XML_STATUS_ERROR;
@@ -1841,6 +2112,8 @@ XML_ResumeParser(XML_Parser parser)
 void XMLCALL
 XML_GetParsingStatus(XML_Parser parser, XML_ParsingStatus *status)
 {
+  if (parser == NULL)
+    return;
   assert(status != NULL);
   *status = parser->m_parsingStatus;
 }
@@ -1848,20 +2121,26 @@ XML_GetParsingStatus(XML_Parser parser, XML_ParsingStatus *status)
 enum XML_Error XMLCALL
 XML_GetErrorCode(XML_Parser parser)
 {
+  if (parser == NULL)
+    return XML_ERROR_INVALID_ARGUMENT;
   return errorCode;
 }
 
 XML_Index XMLCALL
 XML_GetCurrentByteIndex(XML_Parser parser)
 {
+  if (parser == NULL)
+    return -1;
   if (eventPtr)
-    return parseEndByteIndex - (parseEndPtr - eventPtr);
+    return (XML_Index)(parseEndByteIndex - (parseEndPtr - eventPtr));
   return -1;
 }
 
 int XMLCALL
 XML_GetCurrentByteCount(XML_Parser parser)
 {
+  if (parser == NULL)
+    return 0;
   if (eventEndPtr && eventPtr)
     return (int)(eventEndPtr - eventPtr);
   return 0;
@@ -1871,11 +2150,19 @@ const char * XMLCALL
 XML_GetInputContext(XML_Parser parser, int *offset, int *size)
 {
 #ifdef XML_CONTEXT_BYTES
+  if (parser == NULL)
+    return NULL;
   if (eventPtr && buffer) {
-    *offset = (int)(eventPtr - buffer);
-    *size   = (int)(bufferEnd - buffer);
+    if (offset != NULL)
+      *offset = (int)(eventPtr - buffer);
+    if (size != NULL)
+      *size   = (int)(bufferEnd - buffer);
     return buffer;
   }
+#else
+  (void)parser;
+  (void)offset;
+  (void)size;
 #endif /* defined XML_CONTEXT_BYTES */
   return (char *) 0;
 }
@@ -1883,6 +2170,8 @@ XML_GetInputContext(XML_Parser parser, int *offset, int *size)
 XML_Size XMLCALL
 XML_GetCurrentLineNumber(XML_Parser parser)
 {
+  if (parser == NULL)
+    return 0;
   if (eventPtr && eventPtr >= positionPtr) {
     XmlUpdatePosition(encoding, positionPtr, eventPtr, &position);
     positionPtr = eventPtr;
@@ -1893,6 +2182,8 @@ XML_GetCurrentLineNumber(XML_Parser parser)
 XML_Size XMLCALL
 XML_GetCurrentColumnNumber(XML_Parser parser)
 {
+  if (parser == NULL)
+    return 0;
   if (eventPtr && eventPtr >= positionPtr) {
     XmlUpdatePosition(encoding, positionPtr, eventPtr, &position);
     positionPtr = eventPtr;
@@ -1903,30 +2194,38 @@ XML_GetCurrentColumnNumber(XML_Parser parser)
 void XMLCALL
 XML_FreeContentModel(XML_Parser parser, XML_Content *model)
 {
-  FREE(model);
+  if (parser != NULL)
+    FREE(model);
 }
 
 void * XMLCALL
 XML_MemMalloc(XML_Parser parser, size_t size)
 {
+  if (parser == NULL)
+    return NULL;
   return MALLOC(size);
 }
 
 void * XMLCALL
 XML_MemRealloc(XML_Parser parser, void *ptr, size_t size)
 {
+  if (parser == NULL)
+    return NULL;
   return REALLOC(ptr, size);
 }
 
 void XMLCALL
 XML_MemFree(XML_Parser parser, void *ptr)
 {
-  FREE(ptr);
+  if (parser != NULL)
+    FREE(ptr);
 }
 
 void XMLCALL
 XML_DefaultCurrent(XML_Parser parser)
 {
+  if (parser == NULL)
+    return;
   if (defaultHandler) {
     if (openInternalEntities)
       reportDefault(parser,
@@ -2429,11 +2728,11 @@ doContent(XML_Parser parser,
           for (;;) {
             int bufSize;
             int convLen;
-            XmlConvert(enc,
+            const enum XML_Convert_Result convert_res = XmlConvert(enc,
                        &fromPtr, rawNameEnd,
                        (ICHAR **)&toPtr, (ICHAR *)tag->bufEnd - 1);
             convLen = (int)(toPtr - (XML_Char *)tag->buf);
-            if (fromPtr == rawNameEnd) {
+            if ((fromPtr >= rawNameEnd) || (convert_res == XML_CONVERT_INPUT_INCOMPLETE)) {
               tag->name.strLen = convLen;
               break;
             }
@@ -2476,8 +2775,10 @@ doContent(XML_Parser parser,
           return XML_ERROR_NO_MEMORY;
         poolFinish(&tempPool);
         result = storeAtts(parser, enc, s, &name, &bindings);
-        if (result)
+        if (result != XML_ERROR_NONE) {
+          freeBindings(parser, bindings);
           return result;
+        }
         poolFinish(&tempPool);
         if (startElementHandler) {
           startElementHandler(handlerArg, name.str, (const XML_Char **)atts);
@@ -2492,15 +2793,7 @@ doContent(XML_Parser parser,
         if (noElmHandlers && defaultHandler)
           reportDefault(parser, enc, s, next);
         poolClear(&tempPool);
-        while (bindings) {
-          BINDING *b = bindings;
-          if (endNamespaceDeclHandler)
-            endNamespaceDeclHandler(handlerArg, b->prefix->name);
-          bindings = bindings->nextTagBinding;
-          b->nextTagBinding = freeBindingList;
-          freeBindingList = b;
-          b->prefix->binding = b->prevPrefixBinding;
-        }
+        freeBindings(parser, bindings);
       }
       if (tagLevel == 0)
         return epilogProcessor(parser, next, end, nextPtr);
@@ -2654,11 +2947,11 @@ doContent(XML_Parser parser,
           if (MUST_CONVERT(enc, s)) {
             for (;;) {
               ICHAR *dataPtr = (ICHAR *)dataBuf;
-              XmlConvert(enc, &s, next, &dataPtr, (ICHAR *)dataBufEnd);
+              const enum XML_Convert_Result convert_res = XmlConvert(enc, &s, next, &dataPtr, (ICHAR *)dataBufEnd);
               *eventEndPP = s;
               charDataHandler(handlerArg, dataBuf,
                               (int)(dataPtr - (ICHAR *)dataBuf));
-              if (s == next)
+              if ((convert_res == XML_CONVERT_COMPLETED) || (convert_res == XML_CONVERT_INPUT_INCOMPLETE))
                 break;
               *eventPP = s;
             }
@@ -2698,6 +2991,29 @@ doContent(XML_Parser parser,
   /* not reached */
 }
 
+/* This function does not call free() on the allocated memory, merely
+ * moving it to the parser's freeBindingList where it can be freed or
+ * reused as appropriate.
+ */
+static void
+freeBindings(XML_Parser parser, BINDING *bindings)
+{
+  while (bindings) {
+    BINDING *b = bindings;
+
+    /* startNamespaceDeclHandler will have been called for this
+     * binding in addBindings(), so call the end handler now.
+     */
+    if (endNamespaceDeclHandler)
+        endNamespaceDeclHandler(handlerArg, b->prefix->name);
+
+    bindings = bindings->nextTagBinding;
+    b->nextTagBinding = freeBindingList;
+    freeBindingList = b;
+    b->prefix->binding = b->prevPrefixBinding;
+  }
+}
+
 /* Precondition: all arguments must be non-NULL;
    Purpose:
    - normalize attributes
@@ -2922,7 +3238,13 @@ storeAtts(XML_Parser parser, const ENCODING *enc,
       if (s[-1] == 2) {  /* prefixed */
         ATTRIBUTE_ID *id;
         const BINDING *b;
-        unsigned long uriHash = hash_secret_salt;
+        unsigned long uriHash;
+        struct siphash sip_state;
+        struct sipkey sip_key;
+
+        copy_salt_to_sipkey(parser, &sip_key);
+        sip24_init(&sip_state, &sip_key);
+
         ((XML_Char *)s)[-1] = 0;  /* clear flag */
         id = (ATTRIBUTE_ID *)lookup(parser, &dtd->attributeIds, s, 0);
         if (!id || !id->prefix)
@@ -2931,22 +3253,26 @@ storeAtts(XML_Parser parser, const ENCODING *enc,
         if (!b)
           return XML_ERROR_UNBOUND_PREFIX;
 
-        /* as we expand the name we also calculate its hash value */
         for (j = 0; j < b->uriLen; j++) {
           const XML_Char c = b->uri[j];
           if (!poolAppendChar(&tempPool, c))
             return XML_ERROR_NO_MEMORY;
-          uriHash = CHAR_HASH(uriHash, c);
         }
+
+        sip24_update(&sip_state, b->uri, b->uriLen * sizeof(XML_Char));
+
         while (*s++ != XML_T(ASCII_COLON))
           ;
+
+        sip24_update(&sip_state, s, keylen(s) * sizeof(XML_Char));
+
         do {  /* copies null terminator */
-          const XML_Char c = *s;
           if (!poolAppendChar(&tempPool, *s))
             return XML_ERROR_NO_MEMORY;
-          uriHash = CHAR_HASH(uriHash, c);
         } while (*s++);
 
+        uriHash = (unsigned long)sip24_final(&sip_state);
+
         { /* Check hash table for duplicate of expanded name (uriName).
              Derived from code in lookup(parser, HASH_TABLE *table, ...).
           */
@@ -3264,11 +3590,11 @@ doCdataSection(XML_Parser parser,
           if (MUST_CONVERT(enc, s)) {
             for (;;) {
               ICHAR *dataPtr = (ICHAR *)dataBuf;
-              XmlConvert(enc, &s, next, &dataPtr, (ICHAR *)dataBufEnd);
+              const enum XML_Convert_Result convert_res = XmlConvert(enc, &s, next, &dataPtr, (ICHAR *)dataBufEnd);
               *eventEndPP = next;
               charDataHandler(handlerArg, dataBuf,
                               (int)(dataPtr - (ICHAR *)dataBuf));
-              if (s == next)
+              if ((convert_res == XML_CONVERT_COMPLETED) || (convert_res == XML_CONVERT_INPUT_INCOMPLETE))
                 break;
               *eventPP = s;
             }
@@ -3660,6 +3986,14 @@ entityValueInitProcessor(XML_Parser parser,
       *nextPtr = next;
       return XML_ERROR_NONE;
     }
+    /* If we get this token, we have the start of what might be a
+       normal tag, but not a declaration (i.e. it doesn't begin with
+       "<!").  In a DTD context, that isn't legal.
+    */
+    else if (tok == XML_TOK_INSTANCE_START) {
+      *nextPtr = next;
+      return XML_ERROR_SYNTAX;
+    }
     start = next;
     eventPtr = start;
   }
@@ -4836,6 +5170,8 @@ processInternalEntity(XML_Parser parser, ENTITY *entity,
   openEntity->internalEventEndPtr = NULL;
   textStart = (char *)entity->textPtr;
   textEnd = (char *)(entity->textPtr + entity->textLen);
+  /* Set a safe default value in case 'next' does not get set */
+  next = textStart;
 
 #ifdef XML_DTD
   if (entity->is_param) {
@@ -4881,6 +5217,8 @@ internalEntityProcessor(XML_Parser parser,
   entity = openEntity->entity;
   textStart = ((char *)entity->textPtr) + entity->processed;
   textEnd = (char *)(entity->textPtr + entity->textLen);
+  /* Set a safe default value in case 'next' does not get set */
+  next = textStart;
 
 #ifdef XML_DTD
   if (entity->is_param) {
@@ -4927,9 +5265,9 @@ internalEntityProcessor(XML_Parser parser,
 
 static enum XML_Error PTRCALL
 errorProcessor(XML_Parser parser,
-               const char *s,
-               const char *end,
-               const char **nextPtr)
+               const char *UNUSED_P(s),
+               const char *UNUSED_P(end),
+               const char **UNUSED_P(nextPtr))
 {
   return errorCode;
 }
@@ -5345,6 +5683,7 @@ reportDefault(XML_Parser parser, const ENCODING *enc,
               const char *s, const char *end)
 {
   if (MUST_CONVERT(enc, s)) {
+    enum XML_Convert_Result convert_res;
     const char **eventPP;
     const char **eventEndPP;
     if (enc == encoding) {
@@ -5357,11 +5696,11 @@ reportDefault(XML_Parser parser, const ENCODING *enc,
     }
     do {
       ICHAR *dataPtr = (ICHAR *)dataBuf;
-      XmlConvert(enc, &s, end, &dataPtr, (ICHAR *)dataBufEnd);
+      convert_res = XmlConvert(enc, &s, end, &dataPtr, (ICHAR *)dataBufEnd);
       *eventEndPP = s;
       defaultHandler(handlerArg, dataBuf, (int)(dataPtr - (ICHAR *)dataBuf));
       *eventPP = s;
-    } while (s != end);
+    } while ((convert_res != XML_CONVERT_COMPLETED) && (convert_res != XML_CONVERT_INPUT_INCOMPLETE));
   }
   else
     defaultHandler(handlerArg, (XML_Char *)s, (int)((XML_Char *)end - (XML_Char *)s));
@@ -5840,7 +6179,6 @@ dtdCopy(XML_Parser oldParser, DTD *newDtd, const DTD *oldDtd, const XML_Memory_H
       newE->defaultAtts = (DEFAULT_ATTRIBUTE *)
           ms->malloc_fcn(oldE->nDefaultAtts * sizeof(DEFAULT_ATTRIBUTE));
       if (!newE->defaultAtts) {
-        ms->free_fcn(newE);
         return 0;
       }
     }
@@ -5975,13 +6313,32 @@ keyeq(KEY s1, KEY s2)
   return XML_FALSE;
 }
 
+static size_t
+keylen(KEY s)
+{
+  size_t len = 0;
+  for (; *s; s++, len++);
+  return len;
+}
+
+static void
+copy_salt_to_sipkey(XML_Parser parser, struct sipkey * key)
+{
+  key->k[0] = 0;
+  key->k[1] = get_hash_secret_salt(parser);
+}
+
 static unsigned long FASTCALL
 hash(XML_Parser parser, KEY s)
 {
-  unsigned long h = hash_secret_salt;
-  while (*s)
-    h = CHAR_HASH(h, *s++);
-  return h;
+  struct siphash state;
+  struct sipkey key;
+  (void)sip_tobin;
+  (void)sip24_valid;
+  copy_salt_to_sipkey(parser, &key);
+  sip24_init(&state, &key);
+  sip24_update(&state, s, keylen(s) * sizeof(XML_Char));
+  return (unsigned long)sip24_final(&state);
 }
 
 static NAMED *
@@ -6166,8 +6523,8 @@ poolAppend(STRING_POOL *pool, const ENCODING *enc,
   if (!pool->ptr && !poolGrow(pool))
     return NULL;
   for (;;) {
-    XmlConvert(enc, &ptr, end, (ICHAR **)&(pool->ptr), (ICHAR *)pool->end);
-    if (ptr == end)
+    const enum XML_Convert_Result convert_res = XmlConvert(enc, &ptr, end, (ICHAR **)&(pool->ptr), (ICHAR *)pool->end);
+    if ((convert_res == XML_CONVERT_COMPLETED) || (convert_res == XML_CONVERT_INPUT_INCOMPLETE))
       break;
     if (!poolGrow(pool))
       return NULL;
@@ -6224,6 +6581,35 @@ poolStoreString(STRING_POOL *pool, const ENCODING *enc,
   return pool->start;
 }
 
+static size_t
+poolBytesToAllocateFor(int blockSize)
+{
+  /* Unprotected math would be:
+  ** return offsetof(BLOCK, s) + blockSize * sizeof(XML_Char);
+  **
+  ** Detect overflow, avoiding _signed_ overflow undefined behavior
+  ** For a + b * c we check b * c in isolation first, so that addition of a
+  ** on top has no chance of making us accept a small non-negative number
+  */
+  const size_t stretch = sizeof(XML_Char);  /* can be 4 bytes */
+
+  if (blockSize <= 0)
+    return 0;
+
+  if (blockSize > (int)(INT_MAX / stretch))
+    return 0;
+
+  {
+    const int stretchedBlockSize = blockSize * (int)stretch;
+    const int bytesToAllocate = (int)(
+        offsetof(BLOCK, s) + (unsigned)stretchedBlockSize);
+    if (bytesToAllocate < 0)
+      return 0;
+
+    return (size_t)bytesToAllocate;
+  }
+}
+
 static XML_Bool FASTCALL
 poolGrow(STRING_POOL *pool)
 {
@@ -6251,11 +6637,19 @@ poolGrow(STRING_POOL *pool)
     }
   }
   if (pool->blocks && pool->start == pool->blocks->s) {
-    int blockSize = (int)(pool->end - pool->start)*2;
-    BLOCK *temp = (BLOCK *)
-      pool->mem->realloc_fcn(pool->blocks,
-                             (offsetof(BLOCK, s)
-                              + blockSize * sizeof(XML_Char)));
+    BLOCK *temp;
+    int blockSize = (int)((unsigned)(pool->end - pool->start)*2U);
+    size_t bytesToAllocate;
+
+    if (blockSize < 0)
+      return XML_FALSE;
+
+    bytesToAllocate = poolBytesToAllocateFor(blockSize);
+    if (bytesToAllocate == 0)
+      return XML_FALSE;
+
+    temp = (BLOCK *)
+      pool->mem->realloc_fcn(pool->blocks, (unsigned)bytesToAllocate);
     if (temp == NULL)
       return XML_FALSE;
     pool->blocks = temp;
@@ -6267,12 +6661,26 @@ poolGrow(STRING_POOL *pool)
   else {
     BLOCK *tem;
     int blockSize = (int)(pool->end - pool->start);
+    size_t bytesToAllocate;
+
+    if (blockSize < 0)
+      return XML_FALSE;
+
     if (blockSize < INIT_BLOCK_SIZE)
       blockSize = INIT_BLOCK_SIZE;
-    else
+    else {
+      /* Detect overflow, avoiding _signed_ overflow undefined behavior */
+      if ((int)((unsigned)blockSize * 2U) < 0) {
+        return XML_FALSE;
+      }
       blockSize *= 2;
-    tem = (BLOCK *)pool->mem->malloc_fcn(offsetof(BLOCK, s)
-                                        + blockSize * sizeof(XML_Char));
+    }
+
+    bytesToAllocate = poolBytesToAllocateFor(blockSize);
+    if (bytesToAllocate == 0)
+      return XML_FALSE;
+
+    tem = (BLOCK *)pool->mem->malloc_fcn(bytesToAllocate);
     if (!tem)
       return XML_FALSE;
     tem->size = blockSize;
index 44772e2..a7c5630 100644 (file)
@@ -4,19 +4,13 @@
 
 #include <stddef.h>
 
-#ifdef COMPILED_FROM_DSP
+#ifdef _WIN32
 #include "winconfig.h"
-#elif defined(MACOS_CLASSIC)
-#include "macconfig.h"
-#elif defined(__amigaos__)
-#include "amigaconfig.h"
-#elif defined(__WATCOMC__)
-#include "watcomconfig.h"
 #else
 #ifdef HAVE_EXPAT_CONFIG_H
 #include <expat_config.h>
 #endif
-#endif /* ndef COMPILED_FROM_DSP */
+#endif /* ndef _WIN32 */
 
 #include "expat_external.h"
 #include "internal.h"
@@ -195,9 +189,9 @@ prolog1(PROLOG_STATE *state,
 static int PTRCALL
 prolog2(PROLOG_STATE *state,
         int tok,
-        const char *ptr,
-        const char *end,
-        const ENCODING *enc)
+        const char *UNUSED_P(ptr),
+        const char *UNUSED_P(end),
+        const ENCODING *UNUSED_P(enc))
 {
   switch (tok) {
   case XML_TOK_PROLOG_S:
@@ -216,9 +210,9 @@ prolog2(PROLOG_STATE *state,
 static int PTRCALL
 doctype0(PROLOG_STATE *state,
          int tok,
-         const char *ptr,
-         const char *end,
-         const ENCODING *enc)
+         const char *UNUSED_P(ptr),
+         const char *UNUSED_P(end),
+         const ENCODING *UNUSED_P(enc))
 {
   switch (tok) {
   case XML_TOK_PROLOG_S:
@@ -264,9 +258,9 @@ doctype1(PROLOG_STATE *state,
 static int PTRCALL
 doctype2(PROLOG_STATE *state,
          int tok,
-         const char *ptr,
-         const char *end,
-         const ENCODING *enc)
+         const char *UNUSED_P(ptr),
+         const char *UNUSED_P(end),
+         const ENCODING *UNUSED_P(enc))
 {
   switch (tok) {
   case XML_TOK_PROLOG_S:
@@ -281,9 +275,9 @@ doctype2(PROLOG_STATE *state,
 static int PTRCALL
 doctype3(PROLOG_STATE *state,
          int tok,
-         const char *ptr,
-         const char *end,
-         const ENCODING *enc)
+         const char *UNUSED_P(ptr),
+         const char *UNUSED_P(end),
+         const ENCODING *UNUSED_P(enc))
 {
   switch (tok) {
   case XML_TOK_PROLOG_S:
@@ -298,9 +292,9 @@ doctype3(PROLOG_STATE *state,
 static int PTRCALL
 doctype4(PROLOG_STATE *state,
          int tok,
-         const char *ptr,
-         const char *end,
-         const ENCODING *enc)
+         const char *UNUSED_P(ptr),
+         const char *UNUSED_P(end),
+         const ENCODING *UNUSED_P(enc))
 {
   switch (tok) {
   case XML_TOK_PROLOG_S:
@@ -318,9 +312,9 @@ doctype4(PROLOG_STATE *state,
 static int PTRCALL
 doctype5(PROLOG_STATE *state,
          int tok,
-         const char *ptr,
-         const char *end,
-         const ENCODING *enc)
+         const char *UNUSED_P(ptr),
+         const char *UNUSED_P(end),
+         const ENCODING *UNUSED_P(enc))
 {
   switch (tok) {
   case XML_TOK_PROLOG_S:
@@ -437,9 +431,9 @@ externalSubset1(PROLOG_STATE *state,
 static int PTRCALL
 entity0(PROLOG_STATE *state,
         int tok,
-        const char *ptr,
-        const char *end,
-        const ENCODING *enc)
+        const char *UNUSED_P(ptr),
+        const char *UNUSED_P(end),
+        const ENCODING *UNUSED_P(enc))
 {
   switch (tok) {
   case XML_TOK_PROLOG_S:
@@ -457,9 +451,9 @@ entity0(PROLOG_STATE *state,
 static int PTRCALL
 entity1(PROLOG_STATE *state,
         int tok,
-        const char *ptr,
-        const char *end,
-        const ENCODING *enc)
+        const char *UNUSED_P(ptr),
+        const char *UNUSED_P(end),
+        const ENCODING *UNUSED_P(enc))
 {
   switch (tok) {
   case XML_TOK_PROLOG_S:
@@ -502,9 +496,9 @@ entity2(PROLOG_STATE *state,
 static int PTRCALL
 entity3(PROLOG_STATE *state,
         int tok,
-        const char *ptr,
-        const char *end,
-        const ENCODING *enc)
+        const char *UNUSED_P(ptr),
+        const char *UNUSED_P(end),
+        const ENCODING *UNUSED_P(enc))
 {
   switch (tok) {
   case XML_TOK_PROLOG_S:
@@ -519,9 +513,9 @@ entity3(PROLOG_STATE *state,
 static int PTRCALL
 entity4(PROLOG_STATE *state,
         int tok,
-        const char *ptr,
-        const char *end,
-        const ENCODING *enc)
+        const char *UNUSED_P(ptr),
+        const char *UNUSED_P(end),
+        const ENCODING *UNUSED_P(enc))
 {
   switch (tok) {
   case XML_TOK_PROLOG_S:
@@ -559,9 +553,9 @@ entity5(PROLOG_STATE *state,
 static int PTRCALL
 entity6(PROLOG_STATE *state,
         int tok,
-        const char *ptr,
-        const char *end,
-        const ENCODING *enc)
+        const char *UNUSED_P(ptr),
+        const char *UNUSED_P(end),
+        const ENCODING *UNUSED_P(enc))
 {
   switch (tok) {
   case XML_TOK_PROLOG_S:
@@ -605,9 +599,9 @@ entity7(PROLOG_STATE *state,
 static int PTRCALL
 entity8(PROLOG_STATE *state,
         int tok,
-        const char *ptr,
-        const char *end,
-        const ENCODING *enc)
+        const char *UNUSED_P(ptr),
+        const char *UNUSED_P(end),
+        const ENCODING *UNUSED_P(enc))
 {
   switch (tok) {
   case XML_TOK_PROLOG_S:
@@ -622,9 +616,9 @@ entity8(PROLOG_STATE *state,
 static int PTRCALL
 entity9(PROLOG_STATE *state,
         int tok,
-        const char *ptr,
-        const char *end,
-        const ENCODING *enc)
+        const char *UNUSED_P(ptr),
+        const char *UNUSED_P(end),
+        const ENCODING *UNUSED_P(enc))
 {
   switch (tok) {
   case XML_TOK_PROLOG_S:
@@ -639,9 +633,9 @@ entity9(PROLOG_STATE *state,
 static int PTRCALL
 entity10(PROLOG_STATE *state,
          int tok,
-         const char *ptr,
-         const char *end,
-         const ENCODING *enc)
+         const char *UNUSED_P(ptr),
+         const char *UNUSED_P(end),
+         const ENCODING *UNUSED_P(enc))
 {
   switch (tok) {
   case XML_TOK_PROLOG_S:
@@ -656,9 +650,9 @@ entity10(PROLOG_STATE *state,
 static int PTRCALL
 notation0(PROLOG_STATE *state,
           int tok,
-          const char *ptr,
-          const char *end,
-          const ENCODING *enc)
+          const char *UNUSED_P(ptr),
+          const char *UNUSED_P(end),
+          const ENCODING *UNUSED_P(enc))
 {
   switch (tok) {
   case XML_TOK_PROLOG_S:
@@ -697,9 +691,9 @@ notation1(PROLOG_STATE *state,
 static int PTRCALL
 notation2(PROLOG_STATE *state,
           int tok,
-          const char *ptr,
-          const char *end,
-          const ENCODING *enc)
+          const char *UNUSED_P(ptr),
+          const char *UNUSED_P(end),
+          const ENCODING *UNUSED_P(enc))
 {
   switch (tok) {
   case XML_TOK_PROLOG_S:
@@ -714,9 +708,9 @@ notation2(PROLOG_STATE *state,
 static int PTRCALL
 notation3(PROLOG_STATE *state,
           int tok,
-          const char *ptr,
-          const char *end,
-          const ENCODING *enc)
+          const char *UNUSED_P(ptr),
+          const char *UNUSED_P(end),
+          const ENCODING *UNUSED_P(enc))
 {
   switch (tok) {
   case XML_TOK_PROLOG_S:
@@ -732,9 +726,9 @@ notation3(PROLOG_STATE *state,
 static int PTRCALL
 notation4(PROLOG_STATE *state,
           int tok,
-          const char *ptr,
-          const char *end,
-          const ENCODING *enc)
+          const char *UNUSED_P(ptr),
+          const char *UNUSED_P(end),
+          const ENCODING *UNUSED_P(enc))
 {
   switch (tok) {
   case XML_TOK_PROLOG_S:
@@ -753,9 +747,9 @@ notation4(PROLOG_STATE *state,
 static int PTRCALL
 attlist0(PROLOG_STATE *state,
          int tok,
-         const char *ptr,
-         const char *end,
-         const ENCODING *enc)
+         const char *UNUSED_P(ptr),
+         const char *UNUSED_P(end),
+         const ENCODING *UNUSED_P(enc))
 {
   switch (tok) {
   case XML_TOK_PROLOG_S:
@@ -771,9 +765,9 @@ attlist0(PROLOG_STATE *state,
 static int PTRCALL
 attlist1(PROLOG_STATE *state,
          int tok,
-         const char *ptr,
-         const char *end,
-         const ENCODING *enc)
+         const char *UNUSED_P(ptr),
+         const char *UNUSED_P(end),
+         const ENCODING *UNUSED_P(enc))
 {
   switch (tok) {
   case XML_TOK_PROLOG_S:
@@ -833,9 +827,9 @@ attlist2(PROLOG_STATE *state,
 static int PTRCALL
 attlist3(PROLOG_STATE *state,
          int tok,
-         const char *ptr,
-         const char *end,
-         const ENCODING *enc)
+         const char *UNUSED_P(ptr),
+         const char *UNUSED_P(end),
+         const ENCODING *UNUSED_P(enc))
 {
   switch (tok) {
   case XML_TOK_PROLOG_S:
@@ -852,9 +846,9 @@ attlist3(PROLOG_STATE *state,
 static int PTRCALL
 attlist4(PROLOG_STATE *state,
          int tok,
-         const char *ptr,
-         const char *end,
-         const ENCODING *enc)
+         const char *UNUSED_P(ptr),
+         const char *UNUSED_P(end),
+         const ENCODING *UNUSED_P(enc))
 {
   switch (tok) {
   case XML_TOK_PROLOG_S:
@@ -872,9 +866,9 @@ attlist4(PROLOG_STATE *state,
 static int PTRCALL
 attlist5(PROLOG_STATE *state,
          int tok,
-         const char *ptr,
-         const char *end,
-         const ENCODING *enc)
+         const char *UNUSED_P(ptr),
+         const char *UNUSED_P(end),
+         const ENCODING *UNUSED_P(enc))
 {
   switch (tok) {
   case XML_TOK_PROLOG_S:
@@ -889,9 +883,9 @@ attlist5(PROLOG_STATE *state,
 static int PTRCALL
 attlist6(PROLOG_STATE *state,
          int tok,
-         const char *ptr,
-         const char *end,
-         const ENCODING *enc)
+         const char *UNUSED_P(ptr),
+         const char *UNUSED_P(end),
+         const ENCODING *UNUSED_P(enc))
 {
   switch (tok) {
   case XML_TOK_PROLOG_S:
@@ -906,9 +900,9 @@ attlist6(PROLOG_STATE *state,
 static int PTRCALL
 attlist7(PROLOG_STATE *state,
          int tok,
-         const char *ptr,
-         const char *end,
-         const ENCODING *enc)
+         const char *UNUSED_P(ptr),
+         const char *UNUSED_P(end),
+         const ENCODING *UNUSED_P(enc))
 {
   switch (tok) {
   case XML_TOK_PROLOG_S:
@@ -967,9 +961,9 @@ attlist8(PROLOG_STATE *state,
 static int PTRCALL
 attlist9(PROLOG_STATE *state,
          int tok,
-         const char *ptr,
-         const char *end,
-         const ENCODING *enc)
+         const char *UNUSED_P(ptr),
+         const char *UNUSED_P(end),
+         const ENCODING *UNUSED_P(enc))
 {
   switch (tok) {
   case XML_TOK_PROLOG_S:
@@ -984,9 +978,9 @@ attlist9(PROLOG_STATE *state,
 static int PTRCALL
 element0(PROLOG_STATE *state,
          int tok,
-         const char *ptr,
-         const char *end,
-         const ENCODING *enc)
+         const char *UNUSED_P(ptr),
+         const char *UNUSED_P(end),
+         const ENCODING *UNUSED_P(enc))
 {
   switch (tok) {
   case XML_TOK_PROLOG_S:
@@ -1072,9 +1066,9 @@ element2(PROLOG_STATE *state,
 static int PTRCALL
 element3(PROLOG_STATE *state,
          int tok,
-         const char *ptr,
-         const char *end,
-         const ENCODING *enc)
+         const char *UNUSED_P(ptr),
+         const char *UNUSED_P(end),
+         const ENCODING *UNUSED_P(enc))
 {
   switch (tok) {
   case XML_TOK_PROLOG_S:
@@ -1097,9 +1091,9 @@ element3(PROLOG_STATE *state,
 static int PTRCALL
 element4(PROLOG_STATE *state,
          int tok,
-         const char *ptr,
-         const char *end,
-         const ENCODING *enc)
+         const char *UNUSED_P(ptr),
+         const char *UNUSED_P(end),
+         const ENCODING *UNUSED_P(enc))
 {
   switch (tok) {
   case XML_TOK_PROLOG_S:
@@ -1115,9 +1109,9 @@ element4(PROLOG_STATE *state,
 static int PTRCALL
 element5(PROLOG_STATE *state,
          int tok,
-         const char *ptr,
-         const char *end,
-         const ENCODING *enc)
+         const char *UNUSED_P(ptr),
+         const char *UNUSED_P(end),
+         const ENCODING *UNUSED_P(enc))
 {
   switch (tok) {
   case XML_TOK_PROLOG_S:
@@ -1136,9 +1130,9 @@ element5(PROLOG_STATE *state,
 static int PTRCALL
 element6(PROLOG_STATE *state,
          int tok,
-         const char *ptr,
-         const char *end,
-         const ENCODING *enc)
+         const char *UNUSED_P(ptr),
+         const char *UNUSED_P(end),
+         const ENCODING *UNUSED_P(enc))
 {
   switch (tok) {
   case XML_TOK_PROLOG_S:
@@ -1166,9 +1160,9 @@ element6(PROLOG_STATE *state,
 static int PTRCALL
 element7(PROLOG_STATE *state,
          int tok,
-         const char *ptr,
-         const char *end,
-         const ENCODING *enc)
+         const char *UNUSED_P(ptr),
+         const char *UNUSED_P(end),
+         const ENCODING *UNUSED_P(enc))
 {
   switch (tok) {
   case XML_TOK_PROLOG_S:
@@ -1240,9 +1234,9 @@ condSect0(PROLOG_STATE *state,
 static int PTRCALL
 condSect1(PROLOG_STATE *state,
           int tok,
-          const char *ptr,
-          const char *end,
-          const ENCODING *enc)
+          const char *UNUSED_P(ptr),
+          const char *UNUSED_P(end),
+          const ENCODING *UNUSED_P(enc))
 {
   switch (tok) {
   case XML_TOK_PROLOG_S:
@@ -1258,9 +1252,9 @@ condSect1(PROLOG_STATE *state,
 static int PTRCALL
 condSect2(PROLOG_STATE *state,
           int tok,
-          const char *ptr,
-          const char *end,
-          const ENCODING *enc)
+          const char *UNUSED_P(ptr),
+          const char *UNUSED_P(end),
+          const ENCODING *UNUSED_P(enc))
 {
   switch (tok) {
   case XML_TOK_PROLOG_S:
@@ -1277,9 +1271,9 @@ condSect2(PROLOG_STATE *state,
 static int PTRCALL
 declClose(PROLOG_STATE *state,
           int tok,
-          const char *ptr,
-          const char *end,
-          const ENCODING *enc)
+          const char *UNUSED_P(ptr),
+          const char *UNUSED_P(end),
+          const ENCODING *UNUSED_P(enc))
 {
   switch (tok) {
   case XML_TOK_PROLOG_S:
@@ -1292,11 +1286,11 @@ declClose(PROLOG_STATE *state,
 }
 
 static int PTRCALL
-error(PROLOG_STATE *state,
-      int tok,
-      const char *ptr,
-      const char *end,
-      const ENCODING *enc)
+error(PROLOG_STATE *UNUSED_P(state),
+      int UNUSED_P(tok),
+      const char *UNUSED_P(ptr),
+      const char *UNUSED_P(end),
+      const ENCODING *UNUSED_P(enc))
 {
   return XML_ROLE_NONE;
 }
index bf09dfc..cdf0720 100644 (file)
@@ -4,19 +4,13 @@
 
 #include <stddef.h>
 
-#ifdef COMPILED_FROM_DSP
+#ifdef _WIN32
 #include "winconfig.h"
-#elif defined(MACOS_CLASSIC)
-#include "macconfig.h"
-#elif defined(__amigaos__)
-#include "amigaconfig.h"
-#elif defined(__WATCOMC__)
-#include "watcomconfig.h"
 #else
 #ifdef HAVE_EXPAT_CONFIG_H
 #include <expat_config.h>
 #endif
-#endif /* ndef COMPILED_FROM_DSP */
+#endif /* ndef _WIN32 */
 
 #include "expat_external.h"
 #include "internal.h"
@@ -46,7 +40,7 @@
 #define VTABLE VTABLE1, PREFIX(toUtf8), PREFIX(toUtf16)
 
 #define UCS2_GET_NAMING(pages, hi, lo) \
-   (namingBitmap[(pages[hi] << 3) + ((lo) >> 5)] & (1 << ((lo) & 0x1F)))
+   (namingBitmap[(pages[hi] << 3) + ((lo) >> 5)] & (1u << ((lo) & 0x1F)))
 
 /* A 2 byte UTF-8 representation splits the characters 11 bits between
    the bottom 5 and 6 bits of the bytes.  We need 8 bits to index into
@@ -56,7 +50,7 @@
     (namingBitmap[((pages)[(((byte)[0]) >> 2) & 7] << 3) \
                       + ((((byte)[0]) & 3) << 1) \
                       + ((((byte)[1]) >> 5) & 1)] \
-         & (1 << (((byte)[1]) & 0x1F)))
+         & (1u << (((byte)[1]) & 0x1F)))
 
 /* A 3 byte UTF-8 representation splits the characters 16 bits between
    the bottom 4, 6 and 6 bits of the bytes.  We need 8 bits to index
@@ -69,7 +63,7 @@
                        << 3) \
                       + ((((byte)[1]) & 3) << 1) \
                       + ((((byte)[2]) >> 5) & 1)] \
-         & (1 << (((byte)[2]) & 0x1F)))
+         & (1u << (((byte)[2]) & 0x1F)))
 
 #define UTF8_GET_NAMING(pages, p, n) \
   ((n) == 2 \
     ((*p) == 0xF4 ? (p)[1] > 0x8F : ((p)[1] & 0xC0) == 0xC0)))
 
 static int PTRFASTCALL
-isNever(const ENCODING *enc, const char *p)
+isNever(const ENCODING *UNUSED_P(enc), const char *UNUSED_P(p))
 {
   return 0;
 }
 
 static int PTRFASTCALL
-utf8_isName2(const ENCODING *enc, const char *p)
+utf8_isName2(const ENCODING *UNUSED_P(enc), const char *p)
 {
   return UTF8_GET_NAMING2(namePages, (const unsigned char *)p);
 }
 
 static int PTRFASTCALL
-utf8_isName3(const ENCODING *enc, const char *p)
+utf8_isName3(const ENCODING *UNUSED_P(enc), const char *p)
 {
   return UTF8_GET_NAMING3(namePages, (const unsigned char *)p);
 }
@@ -142,13 +136,13 @@ utf8_isName3(const ENCODING *enc, const char *p)
 #define utf8_isName4 isNever
 
 static int PTRFASTCALL
-utf8_isNmstrt2(const ENCODING *enc, const char *p)
+utf8_isNmstrt2(const ENCODING *UNUSED_P(enc), const char *p)
 {
   return UTF8_GET_NAMING2(nmstrtPages, (const unsigned char *)p);
 }
 
 static int PTRFASTCALL
-utf8_isNmstrt3(const ENCODING *enc, const char *p)
+utf8_isNmstrt3(const ENCODING *UNUSED_P(enc), const char *p)
 {
   return UTF8_GET_NAMING3(nmstrtPages, (const unsigned char *)p);
 }
@@ -156,19 +150,19 @@ utf8_isNmstrt3(const ENCODING *enc, const char *p)
 #define utf8_isNmstrt4 isNever
 
 static int PTRFASTCALL
-utf8_isInvalid2(const ENCODING *enc, const char *p)
+utf8_isInvalid2(const ENCODING *UNUSED_P(enc), const char *p)
 {
   return UTF8_INVALID2((const unsigned char *)p);
 }
 
 static int PTRFASTCALL
-utf8_isInvalid3(const ENCODING *enc, const char *p)
+utf8_isInvalid3(const ENCODING *UNUSED_P(enc), const char *p)
 {
   return UTF8_INVALID3((const unsigned char *)p);
 }
 
 static int PTRFASTCALL
-utf8_isInvalid4(const ENCODING *enc, const char *p)
+utf8_isInvalid4(const ENCODING *UNUSED_P(enc), const char *p)
 {
   return UTF8_INVALID4((const unsigned char *)p);
 }
@@ -222,6 +216,17 @@ struct normal_encoding {
  E ## isInvalid3, \
  E ## isInvalid4
 
+#define NULL_VTABLE \
+ /* isName2 */ NULL, \
+ /* isName3 */ NULL, \
+ /* isName4 */ NULL, \
+ /* isNmstrt2 */ NULL, \
+ /* isNmstrt3 */ NULL, \
+ /* isNmstrt4 */ NULL, \
+ /* isInvalid2 */ NULL, \
+ /* isInvalid3 */ NULL, \
+ /* isInvalid4 */ NULL
+
 static int FASTCALL checkCharRefNumber(int);
 
 #include "xmltok_impl.h"
@@ -318,39 +323,89 @@ enum {  /* UTF8_cvalN is value of masked first byte of N byte sequence */
   UTF8_cval4 = 0xf0
 };
 
-static void PTRCALL
-utf8_toUtf8(const ENCODING *enc,
+void
+align_limit_to_full_utf8_characters(const char * from, const char ** fromLimRef)
+{
+  const char * fromLim = *fromLimRef;
+  size_t walked = 0;
+  for (; fromLim > from; fromLim--, walked++) {
+    const unsigned char prev = (unsigned char)fromLim[-1];
+    if ((prev & 0xf8u) == 0xf0u) { /* 4-byte character, lead by 0b11110xxx byte */
+      if (walked + 1 >= 4) {
+        fromLim += 4 - 1;
+        break;
+      } else {
+        walked = 0;
+      }
+    } else if ((prev & 0xf0u) == 0xe0u) { /* 3-byte character, lead by 0b1110xxxx byte */
+      if (walked + 1 >= 3) {
+        fromLim += 3 - 1;
+        break;
+      } else {
+        walked = 0;
+      }
+    } else if ((prev & 0xe0u) == 0xc0u) { /* 2-byte character, lead by 0b110xxxxx byte */
+      if (walked + 1 >= 2) {
+        fromLim += 2 - 1;
+        break;
+      } else {
+        walked = 0;
+      }
+    } else if ((prev & 0x80u) == 0x00u) { /* 1-byte character, matching 0b0xxxxxxx */
+      break;
+    }
+  }
+  *fromLimRef = fromLim;
+}
+
+static enum XML_Convert_Result PTRCALL
+utf8_toUtf8(const ENCODING *UNUSED_P(enc),
             const char **fromP, const char *fromLim,
             char **toP, const char *toLim)
 {
   char *to;
   const char *from;
-  if (fromLim - *fromP > toLim - *toP) {
-    /* Avoid copying partial characters. */
-    for (fromLim = *fromP + (toLim - *toP); fromLim > *fromP; fromLim--)
-      if (((unsigned char)fromLim[-1] & 0xc0) != 0x80)
-        break;
-  }
-  for (to = *toP, from = *fromP; from != fromLim; from++, to++)
+  const char *fromLimInitial = fromLim;
+
+  /* Avoid copying partial characters. */
+  align_limit_to_full_utf8_characters(*fromP, &fromLim);
+
+  for (to = *toP, from = *fromP; (from < fromLim) && (to < toLim); from++, to++)
     *to = *from;
   *fromP = from;
   *toP = to;
+
+  if (fromLim < fromLimInitial)
+    return XML_CONVERT_INPUT_INCOMPLETE;
+  else if ((to == toLim) && (from < fromLim))
+    return XML_CONVERT_OUTPUT_EXHAUSTED;
+  else
+    return XML_CONVERT_COMPLETED;
 }
 
-static void PTRCALL
+static enum XML_Convert_Result PTRCALL
 utf8_toUtf16(const ENCODING *enc,
              const char **fromP, const char *fromLim,
              unsigned short **toP, const unsigned short *toLim)
 {
+  enum XML_Convert_Result res = XML_CONVERT_COMPLETED;
   unsigned short *to = *toP;
   const char *from = *fromP;
-  while (from != fromLim && to != toLim) {
+  while (from < fromLim && to < toLim) {
     switch (((struct normal_encoding *)enc)->type[(unsigned char)*from]) {
     case BT_LEAD2:
+      if (fromLim - from < 2) {
+        res = XML_CONVERT_INPUT_INCOMPLETE;
+        goto after;
+      }
       *to++ = (unsigned short)(((from[0] & 0x1f) << 6) | (from[1] & 0x3f));
       from += 2;
       break;
     case BT_LEAD3:
+      if (fromLim - from < 3) {
+        res = XML_CONVERT_INPUT_INCOMPLETE;
+        goto after;
+      }
       *to++ = (unsigned short)(((from[0] & 0xf) << 12)
                                | ((from[1] & 0x3f) << 6) | (from[2] & 0x3f));
       from += 3;
@@ -358,8 +413,14 @@ utf8_toUtf16(const ENCODING *enc,
     case BT_LEAD4:
       {
         unsigned long n;
-        if (to + 1 == toLim)
+        if (toLim - to < 2) {
+          res = XML_CONVERT_OUTPUT_EXHAUSTED;
+          goto after;
+        }
+        if (fromLim - from < 4) {
+          res = XML_CONVERT_INPUT_INCOMPLETE;
           goto after;
+        }
         n = ((from[0] & 0x7) << 18) | ((from[1] & 0x3f) << 12)
             | ((from[2] & 0x3f) << 6) | (from[3] & 0x3f);
         n -= 0x10000;
@@ -374,9 +435,12 @@ utf8_toUtf16(const ENCODING *enc,
       break;
     }
   }
+  if (from < fromLim)
+    res = XML_CONVERT_OUTPUT_EXHAUSTED;
 after:
   *fromP = from;
   *toP = to;
+  return res;
 }
 
 #ifdef XML_NS
@@ -425,38 +489,43 @@ static const struct normal_encoding internal_utf8_encoding = {
   STANDARD_VTABLE(sb_) NORMAL_VTABLE(utf8_)
 };
 
-static void PTRCALL
-latin1_toUtf8(const ENCODING *enc,
+static enum XML_Convert_Result PTRCALL
+latin1_toUtf8(const ENCODING *UNUSED_P(enc),
               const char **fromP, const char *fromLim,
               char **toP, const char *toLim)
 {
   for (;;) {
     unsigned char c;
     if (*fromP == fromLim)
-      break;
+      return XML_CONVERT_COMPLETED;
     c = (unsigned char)**fromP;
     if (c & 0x80) {
       if (toLim - *toP < 2)
-        break;
+        return XML_CONVERT_OUTPUT_EXHAUSTED;
       *(*toP)++ = (char)((c >> 6) | UTF8_cval2);
       *(*toP)++ = (char)((c & 0x3f) | 0x80);
       (*fromP)++;
     }
     else {
       if (*toP == toLim)
-        break;
+        return XML_CONVERT_OUTPUT_EXHAUSTED;
       *(*toP)++ = *(*fromP)++;
     }
   }
 }
 
-static void PTRCALL
-latin1_toUtf16(const ENCODING *enc,
+static enum XML_Convert_Result PTRCALL
+latin1_toUtf16(const ENCODING *UNUSED_P(enc),
                const char **fromP, const char *fromLim,
                unsigned short **toP, const unsigned short *toLim)
 {
-  while (*fromP != fromLim && *toP != toLim)
+  while (*fromP < fromLim && *toP < toLim)
     *(*toP)++ = (unsigned char)*(*fromP)++;
+
+  if ((*toP == toLim) && (*fromP < fromLim))
+    return XML_CONVERT_OUTPUT_EXHAUSTED;
+  else
+    return XML_CONVERT_COMPLETED;
 }
 
 #ifdef XML_NS
@@ -467,7 +536,7 @@ static const struct normal_encoding latin1_encoding_ns = {
 #include "asciitab.h"
 #include "latin1tab.h"
   },
-  STANDARD_VTABLE(sb_)
+  STANDARD_VTABLE(sb_) NULL_VTABLE
 };
 
 #endif
@@ -480,16 +549,21 @@ static const struct normal_encoding latin1_encoding = {
 #undef BT_COLON
 #include "latin1tab.h"
   },
-  STANDARD_VTABLE(sb_)
+  STANDARD_VTABLE(sb_) NULL_VTABLE
 };
 
-static void PTRCALL
-ascii_toUtf8(const ENCODING *enc,
+static enum XML_Convert_Result PTRCALL
+ascii_toUtf8(const ENCODING *UNUSED_P(enc),
              const char **fromP, const char *fromLim,
              char **toP, const char *toLim)
 {
-  while (*fromP != fromLim && *toP != toLim)
+  while (*fromP < fromLim && *toP < toLim)
     *(*toP)++ = *(*fromP)++;
+
+  if ((*toP == toLim) && (*fromP < fromLim))
+    return XML_CONVERT_OUTPUT_EXHAUSTED;
+  else
+    return XML_CONVERT_COMPLETED;
 }
 
 #ifdef XML_NS
@@ -500,7 +574,7 @@ static const struct normal_encoding ascii_encoding_ns = {
 #include "asciitab.h"
 /* BT_NONXML == 0 */
   },
-  STANDARD_VTABLE(sb_)
+  STANDARD_VTABLE(sb_) NULL_VTABLE
 };
 
 #endif
@@ -513,7 +587,7 @@ static const struct normal_encoding ascii_encoding = {
 #undef BT_COLON
 /* BT_NONXML == 0 */
   },
-  STANDARD_VTABLE(sb_)
+  STANDARD_VTABLE(sb_) NULL_VTABLE
 };
 
 static int PTRFASTCALL
@@ -536,13 +610,14 @@ unicode_byte_type(char hi, char lo)
 }
 
 #define DEFINE_UTF16_TO_UTF8(E) \
-static void  PTRCALL \
-E ## toUtf8(const ENCODING *enc, \
+static enum XML_Convert_Result  PTRCALL \
+E ## toUtf8(const ENCODING *UNUSED_P(enc), \
             const char **fromP, const char *fromLim, \
             char **toP, const char *toLim) \
 { \
-  const char *from; \
-  for (from = *fromP; from != fromLim; from += 2) { \
+  const char *from = *fromP; \
+  fromLim = from + (((fromLim - from) >> 1) << 1);  /* shrink to even */ \
+  for (; from < fromLim; from += 2) { \
     int plane; \
     unsigned char lo2; \
     unsigned char lo = GET_LO(from); \
@@ -552,7 +627,7 @@ E ## toUtf8(const ENCODING *enc, \
       if (lo < 0x80) { \
         if (*toP == toLim) { \
           *fromP = from; \
-          return; \
+          return XML_CONVERT_OUTPUT_EXHAUSTED; \
         } \
         *(*toP)++ = lo; \
         break; \
@@ -562,7 +637,7 @@ E ## toUtf8(const ENCODING *enc, \
     case 0x4: case 0x5: case 0x6: case 0x7: \
       if (toLim -  *toP < 2) { \
         *fromP = from; \
-        return; \
+        return XML_CONVERT_OUTPUT_EXHAUSTED; \
       } \
       *(*toP)++ = ((lo >> 6) | (hi << 2) |  UTF8_cval2); \
       *(*toP)++ = ((lo & 0x3f) | 0x80); \
@@ -570,7 +645,7 @@ E ## toUtf8(const ENCODING *enc, \
     default: \
       if (toLim -  *toP < 3)  { \
         *fromP = from; \
-        return; \
+        return XML_CONVERT_OUTPUT_EXHAUSTED; \
       } \
       /* 16 bits divided 4, 6, 6 amongst 3 bytes */ \
       *(*toP)++ = ((hi >> 4) | UTF8_cval3); \
@@ -580,7 +655,11 @@ E ## toUtf8(const ENCODING *enc, \
     case 0xD8: case 0xD9: case 0xDA: case 0xDB: \
       if (toLim -  *toP < 4) { \
         *fromP = from; \
-        return; \
+        return XML_CONVERT_OUTPUT_EXHAUSTED; \
+      } \
+      if (fromLim - from < 4) { \
+        *fromP = from; \
+        return XML_CONVERT_INPUT_INCOMPLETE; \
       } \
       plane = (((hi & 0x3) << 2) | ((lo >> 6) & 0x3)) + 1; \
       *(*toP)++ = ((plane >> 2) | UTF8_cval4); \
@@ -596,20 +675,32 @@ E ## toUtf8(const ENCODING *enc, \
     } \
   } \
   *fromP = from; \
+  if (from < fromLim) \
+    return XML_CONVERT_INPUT_INCOMPLETE; \
+  else \
+    return XML_CONVERT_COMPLETED; \
 }
 
 #define DEFINE_UTF16_TO_UTF16(E) \
-static void  PTRCALL \
-E ## toUtf16(const ENCODING *enc, \
+static enum XML_Convert_Result  PTRCALL \
+E ## toUtf16(const ENCODING *UNUSED_P(enc), \
              const char **fromP, const char *fromLim, \
              unsigned short **toP, const unsigned short *toLim) \
 { \
+  enum XML_Convert_Result res = XML_CONVERT_COMPLETED; \
+  fromLim = *fromP + (((fromLim - *fromP) >> 1) << 1);  /* shrink to even */ \
   /* Avoid copying first half only of surrogate */ \
   if (fromLim - *fromP > ((toLim - *toP) << 1) \
-      && (GET_HI(fromLim - 2) & 0xF8) == 0xD8) \
+      && (GET_HI(fromLim - 2) & 0xF8) == 0xD8) \
     fromLim -= 2; \
-  for (; *fromP != fromLim && *toP != toLim; *fromP += 2) \
+    res = XML_CONVERT_INPUT_INCOMPLETE; \
+  } \
+  for (; *fromP < fromLim && *toP < toLim; *fromP += 2) \
     *(*toP)++ = (GET_HI(*fromP) << 8) | GET_LO(*fromP); \
+  if ((*toP == toLim) && (*fromP < fromLim)) \
+    return XML_CONVERT_OUTPUT_EXHAUSTED; \
+  else \
+    return res; \
 }
 
 #define SET2(ptr, ch) \
@@ -726,7 +817,7 @@ static const struct normal_encoding little2_encoding_ns = {
 #include "asciitab.h"
 #include "latin1tab.h"
   },
-  STANDARD_VTABLE(little2_)
+  STANDARD_VTABLE(little2_) NULL_VTABLE
 };
 
 #endif
@@ -745,7 +836,7 @@ static const struct normal_encoding little2_encoding = {
 #undef BT_COLON
 #include "latin1tab.h"
   },
-  STANDARD_VTABLE(little2_)
+  STANDARD_VTABLE(little2_) NULL_VTABLE
 };
 
 #if BYTEORDER != 4321
@@ -758,7 +849,7 @@ static const struct normal_encoding internal_little2_encoding_ns = {
 #include "iasciitab.h"
 #include "latin1tab.h"
   },
-  STANDARD_VTABLE(little2_)
+  STANDARD_VTABLE(little2_) NULL_VTABLE
 };
 
 #endif
@@ -771,7 +862,7 @@ static const struct normal_encoding internal_little2_encoding = {
 #undef BT_COLON
 #include "latin1tab.h"
   },
-  STANDARD_VTABLE(little2_)
+  STANDARD_VTABLE(little2_) NULL_VTABLE
 };
 
 #endif
@@ -867,7 +958,7 @@ static const struct normal_encoding big2_encoding_ns = {
 #include "asciitab.h"
 #include "latin1tab.h"
   },
-  STANDARD_VTABLE(big2_)
+  STANDARD_VTABLE(big2_) NULL_VTABLE
 };
 
 #endif
@@ -886,7 +977,7 @@ static const struct normal_encoding big2_encoding = {
 #undef BT_COLON
 #include "latin1tab.h"
   },
-  STANDARD_VTABLE(big2_)
+  STANDARD_VTABLE(big2_) NULL_VTABLE
 };
 
 #if BYTEORDER != 1234
@@ -899,7 +990,7 @@ static const struct normal_encoding internal_big2_encoding_ns = {
 #include "iasciitab.h"
 #include "latin1tab.h"
   },
-  STANDARD_VTABLE(big2_)
+  STANDARD_VTABLE(big2_) NULL_VTABLE
 };
 
 #endif
@@ -912,7 +1003,7 @@ static const struct normal_encoding internal_big2_encoding = {
 #undef BT_COLON
 #include "latin1tab.h"
   },
-  STANDARD_VTABLE(big2_)
+  STANDARD_VTABLE(big2_) NULL_VTABLE
 };
 
 #endif
@@ -938,7 +1029,7 @@ streqci(const char *s1, const char *s2)
 }
 
 static void PTRCALL
-initUpdatePosition(const ENCODING *enc, const char *ptr,
+initUpdatePosition(const ENCODING *UNUSED_P(enc), const char *ptr,
                    const char *end, POSITION *pos)
 {
   normal_updatePosition(&utf8_encoding.enc, ptr, end, pos);
@@ -1288,7 +1379,7 @@ unknown_isInvalid(const ENCODING *enc, const char *p)
   return (c & ~0xFFFF) || checkCharRefNumber(c) < 0;
 }
 
-static void PTRCALL
+static enum XML_Convert_Result PTRCALL
 unknown_toUtf8(const ENCODING *enc,
                const char **fromP, const char *fromLim,
                char **toP, const char *toLim)
@@ -1299,21 +1390,21 @@ unknown_toUtf8(const ENCODING *enc,
     const char *utf8;
     int n;
     if (*fromP == fromLim)
-      break;
+      return XML_CONVERT_COMPLETED;
     utf8 = uenc->utf8[(unsigned char)**fromP];
     n = *utf8++;
     if (n == 0) {
       int c = uenc->convert(uenc->userData, *fromP);
       n = XmlUtf8Encode(c, buf);
       if (n > toLim - *toP)
-        break;
+        return XML_CONVERT_OUTPUT_EXHAUSTED;
       utf8 = buf;
       *fromP += (AS_NORMAL_ENCODING(enc)->type[(unsigned char)**fromP]
                  - (BT_LEAD2 - 2));
     }
     else {
       if (n > toLim - *toP)
-        break;
+        return XML_CONVERT_OUTPUT_EXHAUSTED;
       (*fromP)++;
     }
     do {
@@ -1322,13 +1413,13 @@ unknown_toUtf8(const ENCODING *enc,
   }
 }
 
-static void PTRCALL
+static enum XML_Convert_Result PTRCALL
 unknown_toUtf16(const ENCODING *enc,
                 const char **fromP, const char *fromLim,
                 unsigned short **toP, const unsigned short *toLim)
 {
   const struct unknown_encoding *uenc = AS_UNKNOWN_ENCODING(enc);
-  while (*fromP != fromLim && *toP != toLim) {
+  while (*fromP < fromLim && *toP < toLim) {
     unsigned short c = uenc->utf16[(unsigned char)**fromP];
     if (c == 0) {
       c = (unsigned short)
@@ -1340,6 +1431,11 @@ unknown_toUtf16(const ENCODING *enc,
       (*fromP)++;
     *(*toP)++ = c;
   }
+
+  if ((*toP == toLim) && (*fromP < fromLim))
+    return XML_CONVERT_OUTPUT_EXHAUSTED;
+  else
+    return XML_CONVERT_COMPLETED;
 }
 
 ENCODING *
@@ -1503,7 +1599,7 @@ initScan(const ENCODING * const *encodingTable,
 {
   const ENCODING **encPtr;
 
-  if (ptr == end)
+  if (ptr >= end)
     return XML_TOK_NONE;
   encPtr = enc->encPtr;
   if (ptr + 1 == end) {
index ca867aa..752007e 100644 (file)
@@ -130,6 +130,12 @@ typedef int (PTRCALL *SCANNER)(const ENCODING *,
                                const char *,
                                const char **);
 
+enum XML_Convert_Result {
+  XML_CONVERT_COMPLETED = 0,
+  XML_CONVERT_INPUT_INCOMPLETE = 1,
+  XML_CONVERT_OUTPUT_EXHAUSTED = 2  /* and therefore potentially input remaining as well */
+};
+
 struct encoding {
   SCANNER scanners[XML_N_STATES];
   SCANNER literalScanners[XML_N_LITERAL_TYPES];
@@ -158,12 +164,12 @@ struct encoding {
                             const char *ptr,
                             const char *end,
                             const char **badPtr);
-  void (PTRCALL *utf8Convert)(const ENCODING *enc,
+  enum XML_Convert_Result (PTRCALL *utf8Convert)(const ENCODING *enc,
                               const char **fromP,
                               const char *fromLim,
                               char **toP,
                               const char *toLim);
-  void (PTRCALL *utf16Convert)(const ENCODING *enc,
+  enum XML_Convert_Result (PTRCALL *utf16Convert)(const ENCODING *enc,
                                const char **fromP,
                                const char *fromLim,
                                unsigned short **toP,
index 9c2895b..5f779c0 100644 (file)
 #define PREFIX(ident) ident
 #endif
 
+
+#define HAS_CHARS(enc, ptr, end, count) \
+    (end - ptr >= count * MINBPC(enc))
+
+#define HAS_CHAR(enc, ptr, end) \
+    HAS_CHARS(enc, ptr, end, 1)
+
+#define REQUIRE_CHARS(enc, ptr, end, count) \
+    { \
+      if (! HAS_CHARS(enc, ptr, end, count)) { \
+        return XML_TOK_PARTIAL; \
+      } \
+    }
+
+#define REQUIRE_CHAR(enc, ptr, end) \
+    REQUIRE_CHARS(enc, ptr, end, 1)
+
+
 /* ptr points to character following "<!-" */
 
 static int PTRCALL
 PREFIX(scanComment)(const ENCODING *enc, const char *ptr,
                     const char *end, const char **nextTokPtr)
 {
-  if (ptr != end) {
+  if (HAS_CHAR(enc, ptr, end)) {
     if (!CHAR_MATCHES(enc, ptr, ASCII_MINUS)) {
       *nextTokPtr = ptr;
       return XML_TOK_INVALID;
     }
     ptr += MINBPC(enc);
-    while (ptr != end) {
+    while (HAS_CHAR(enc, ptr, end)) {
       switch (BYTE_TYPE(enc, ptr)) {
       INVALID_CASES(ptr, nextTokPtr)
       case BT_MINUS:
-        if ((ptr += MINBPC(enc)) == end)
-          return XML_TOK_PARTIAL;
+        ptr += MINBPC(enc);
+        REQUIRE_CHAR(enc, ptr, end);
         if (CHAR_MATCHES(enc, ptr, ASCII_MINUS)) {
-          if ((ptr += MINBPC(enc)) == end)
-            return XML_TOK_PARTIAL;
+          ptr += MINBPC(enc);
+          REQUIRE_CHAR(enc, ptr, end);
           if (!CHAR_MATCHES(enc, ptr, ASCII_GT)) {
             *nextTokPtr = ptr;
             return XML_TOK_INVALID;
@@ -131,8 +149,7 @@ static int PTRCALL
 PREFIX(scanDecl)(const ENCODING *enc, const char *ptr,
                  const char *end, const char **nextTokPtr)
 {
-  if (ptr == end)
-    return XML_TOK_PARTIAL;
+  REQUIRE_CHAR(enc, ptr, end);
   switch (BYTE_TYPE(enc, ptr)) {
   case BT_MINUS:
     return PREFIX(scanComment)(enc, ptr + MINBPC(enc), end, nextTokPtr);
@@ -147,11 +164,10 @@ PREFIX(scanDecl)(const ENCODING *enc, const char *ptr,
     *nextTokPtr = ptr;
     return XML_TOK_INVALID;
   }
-  while (ptr != end) {
+  while (HAS_CHAR(enc, ptr, end)) {
     switch (BYTE_TYPE(enc, ptr)) {
     case BT_PERCNT:
-      if (ptr + MINBPC(enc) == end)
-        return XML_TOK_PARTIAL;
+      REQUIRE_CHARS(enc, ptr, end, 2);
       /* don't allow <!ENTITY% foo "whatever"> */
       switch (BYTE_TYPE(enc, ptr + MINBPC(enc))) {
       case BT_S: case BT_CR: case BT_LF: case BT_PERCNT:
@@ -175,7 +191,7 @@ PREFIX(scanDecl)(const ENCODING *enc, const char *ptr,
 }
 
 static int PTRCALL
-PREFIX(checkPiTarget)(const ENCODING *enc, const char *ptr,
+PREFIX(checkPiTarget)(const ENCODING *UNUSED_P(enc), const char *ptr,
                       const char *end, int *tokPtr)
 {
   int upper = 0;
@@ -225,15 +241,14 @@ PREFIX(scanPi)(const ENCODING *enc, const char *ptr,
 {
   int tok;
   const char *target = ptr;
-  if (ptr == end)
-    return XML_TOK_PARTIAL;
+  REQUIRE_CHAR(enc, ptr, end);
   switch (BYTE_TYPE(enc, ptr)) {
   CHECK_NMSTRT_CASES(enc, ptr, end, nextTokPtr)
   default:
     *nextTokPtr = ptr;
     return XML_TOK_INVALID;
   }
-  while (ptr != end) {
+  while (HAS_CHAR(enc, ptr, end)) {
     switch (BYTE_TYPE(enc, ptr)) {
     CHECK_NAME_CASES(enc, ptr, end, nextTokPtr)
     case BT_S: case BT_CR: case BT_LF:
@@ -242,13 +257,12 @@ PREFIX(scanPi)(const ENCODING *enc, const char *ptr,
         return XML_TOK_INVALID;
       }
       ptr += MINBPC(enc);
-      while (ptr != end) {
+      while (HAS_CHAR(enc, ptr, end)) {
         switch (BYTE_TYPE(enc, ptr)) {
         INVALID_CASES(ptr, nextTokPtr)
         case BT_QUEST:
           ptr += MINBPC(enc);
-          if (ptr == end)
-            return XML_TOK_PARTIAL;
+          REQUIRE_CHAR(enc, ptr, end);
           if (CHAR_MATCHES(enc, ptr, ASCII_GT)) {
             *nextTokPtr = ptr + MINBPC(enc);
             return tok;
@@ -266,8 +280,7 @@ PREFIX(scanPi)(const ENCODING *enc, const char *ptr,
         return XML_TOK_INVALID;
       }
       ptr += MINBPC(enc);
-      if (ptr == end)
-        return XML_TOK_PARTIAL;
+      REQUIRE_CHAR(enc, ptr, end);
       if (CHAR_MATCHES(enc, ptr, ASCII_GT)) {
         *nextTokPtr = ptr + MINBPC(enc);
         return tok;
@@ -282,15 +295,14 @@ PREFIX(scanPi)(const ENCODING *enc, const char *ptr,
 }
 
 static int PTRCALL
-PREFIX(scanCdataSection)(const ENCODING *enc, const char *ptr,
+PREFIX(scanCdataSection)(const ENCODING *UNUSED_P(enc), const char *ptr,
                          const char *end, const char **nextTokPtr)
 {
   static const char CDATA_LSQB[] = { ASCII_C, ASCII_D, ASCII_A,
                                      ASCII_T, ASCII_A, ASCII_LSQB };
   int i;
   /* CDATA[ */
-  if (end - ptr < 6 * MINBPC(enc))
-    return XML_TOK_PARTIAL;
+  REQUIRE_CHARS(enc, ptr, end, 6);
   for (i = 0; i < 6; i++, ptr += MINBPC(enc)) {
     if (!CHAR_MATCHES(enc, ptr, CDATA_LSQB[i])) {
       *nextTokPtr = ptr;
@@ -305,7 +317,7 @@ static int PTRCALL
 PREFIX(cdataSectionTok)(const ENCODING *enc, const char *ptr,
                         const char *end, const char **nextTokPtr)
 {
-  if (ptr == end)
+  if (ptr >= end)
     return XML_TOK_NONE;
   if (MINBPC(enc) > 1) {
     size_t n = end - ptr;
@@ -319,13 +331,11 @@ PREFIX(cdataSectionTok)(const ENCODING *enc, const char *ptr,
   switch (BYTE_TYPE(enc, ptr)) {
   case BT_RSQB:
     ptr += MINBPC(enc);
-    if (ptr == end)
-      return XML_TOK_PARTIAL;
+    REQUIRE_CHAR(enc, ptr, end);
     if (!CHAR_MATCHES(enc, ptr, ASCII_RSQB))
       break;
     ptr += MINBPC(enc);
-    if (ptr == end)
-      return XML_TOK_PARTIAL;
+    REQUIRE_CHAR(enc, ptr, end);
     if (!CHAR_MATCHES(enc, ptr, ASCII_GT)) {
       ptr -= MINBPC(enc);
       break;
@@ -334,8 +344,7 @@ PREFIX(cdataSectionTok)(const ENCODING *enc, const char *ptr,
     return XML_TOK_CDATA_SECT_CLOSE;
   case BT_CR:
     ptr += MINBPC(enc);
-    if (ptr == end)
-      return XML_TOK_PARTIAL;
+    REQUIRE_CHAR(enc, ptr, end);
     if (BYTE_TYPE(enc, ptr) == BT_LF)
       ptr += MINBPC(enc);
     *nextTokPtr = ptr;
@@ -348,7 +357,7 @@ PREFIX(cdataSectionTok)(const ENCODING *enc, const char *ptr,
     ptr += MINBPC(enc);
     break;
   }
-  while (ptr != end) {
+  while (HAS_CHAR(enc, ptr, end)) {
     switch (BYTE_TYPE(enc, ptr)) {
 #define LEAD_CASE(n) \
     case BT_LEAD ## n: \
@@ -383,19 +392,18 @@ static int PTRCALL
 PREFIX(scanEndTag)(const ENCODING *enc, const char *ptr,
                    const char *end, const char **nextTokPtr)
 {
-  if (ptr == end)
-    return XML_TOK_PARTIAL;
+  REQUIRE_CHAR(enc, ptr, end);
   switch (BYTE_TYPE(enc, ptr)) {
   CHECK_NMSTRT_CASES(enc, ptr, end, nextTokPtr)
   default:
     *nextTokPtr = ptr;
     return XML_TOK_INVALID;
   }
-  while (ptr != end) {
+  while (HAS_CHAR(enc, ptr, end)) {
     switch (BYTE_TYPE(enc, ptr)) {
     CHECK_NAME_CASES(enc, ptr, end, nextTokPtr)
     case BT_S: case BT_CR: case BT_LF:
-      for (ptr += MINBPC(enc); ptr != end; ptr += MINBPC(enc)) {
+      for (ptr += MINBPC(enc); HAS_CHAR(enc, ptr, end); ptr += MINBPC(enc)) {
         switch (BYTE_TYPE(enc, ptr)) {
         case BT_S: case BT_CR: case BT_LF:
           break;
@@ -432,7 +440,7 @@ static int PTRCALL
 PREFIX(scanHexCharRef)(const ENCODING *enc, const char *ptr,
                        const char *end, const char **nextTokPtr)
 {
-  if (ptr != end) {
+  if (HAS_CHAR(enc, ptr, end)) {
     switch (BYTE_TYPE(enc, ptr)) {
     case BT_DIGIT:
     case BT_HEX:
@@ -441,7 +449,7 @@ PREFIX(scanHexCharRef)(const ENCODING *enc, const char *ptr,
       *nextTokPtr = ptr;
       return XML_TOK_INVALID;
     }
-    for (ptr += MINBPC(enc); ptr != end; ptr += MINBPC(enc)) {
+    for (ptr += MINBPC(enc); HAS_CHAR(enc, ptr, end); ptr += MINBPC(enc)) {
       switch (BYTE_TYPE(enc, ptr)) {
       case BT_DIGIT:
       case BT_HEX:
@@ -464,7 +472,7 @@ static int PTRCALL
 PREFIX(scanCharRef)(const ENCODING *enc, const char *ptr,
                     const char *end, const char **nextTokPtr)
 {
-  if (ptr != end) {
+  if (HAS_CHAR(enc, ptr, end)) {
     if (CHAR_MATCHES(enc, ptr, ASCII_x))
       return PREFIX(scanHexCharRef)(enc, ptr + MINBPC(enc), end, nextTokPtr);
     switch (BYTE_TYPE(enc, ptr)) {
@@ -474,7 +482,7 @@ PREFIX(scanCharRef)(const ENCODING *enc, const char *ptr,
       *nextTokPtr = ptr;
       return XML_TOK_INVALID;
     }
-    for (ptr += MINBPC(enc); ptr != end; ptr += MINBPC(enc)) {
+    for (ptr += MINBPC(enc); HAS_CHAR(enc, ptr, end); ptr += MINBPC(enc)) {
       switch (BYTE_TYPE(enc, ptr)) {
       case BT_DIGIT:
         break;
@@ -496,8 +504,7 @@ static int PTRCALL
 PREFIX(scanRef)(const ENCODING *enc, const char *ptr, const char *end,
                 const char **nextTokPtr)
 {
-  if (ptr == end)
-    return XML_TOK_PARTIAL;
+  REQUIRE_CHAR(enc, ptr, end);
   switch (BYTE_TYPE(enc, ptr)) {
   CHECK_NMSTRT_CASES(enc, ptr, end, nextTokPtr)
   case BT_NUM:
@@ -506,7 +513,7 @@ PREFIX(scanRef)(const ENCODING *enc, const char *ptr, const char *end,
     *nextTokPtr = ptr;
     return XML_TOK_INVALID;
   }
-  while (ptr != end) {
+  while (HAS_CHAR(enc, ptr, end)) {
     switch (BYTE_TYPE(enc, ptr)) {
     CHECK_NAME_CASES(enc, ptr, end, nextTokPtr)
     case BT_SEMI:
@@ -529,7 +536,7 @@ PREFIX(scanAtts)(const ENCODING *enc, const char *ptr, const char *end,
 #ifdef XML_NS
   int hadColon = 0;
 #endif
-  while (ptr != end) {
+  while (HAS_CHAR(enc, ptr, end)) {
     switch (BYTE_TYPE(enc, ptr)) {
     CHECK_NAME_CASES(enc, ptr, end, nextTokPtr)
 #ifdef XML_NS
@@ -540,8 +547,7 @@ PREFIX(scanAtts)(const ENCODING *enc, const char *ptr, const char *end,
       }
       hadColon = 1;
       ptr += MINBPC(enc);
-      if (ptr == end)
-        return XML_TOK_PARTIAL;
+      REQUIRE_CHAR(enc, ptr, end);
       switch (BYTE_TYPE(enc, ptr)) {
       CHECK_NMSTRT_CASES(enc, ptr, end, nextTokPtr)
       default:
@@ -555,8 +561,7 @@ PREFIX(scanAtts)(const ENCODING *enc, const char *ptr, const char *end,
         int t;
 
         ptr += MINBPC(enc);
-        if (ptr == end)
-          return XML_TOK_PARTIAL;
+        REQUIRE_CHAR(enc, ptr, end);
         t = BYTE_TYPE(enc, ptr);
         if (t == BT_EQUALS)
           break;
@@ -579,8 +584,7 @@ PREFIX(scanAtts)(const ENCODING *enc, const char *ptr, const char *end,
 #endif
         for (;;) {
           ptr += MINBPC(enc);
-          if (ptr == end)
-            return XML_TOK_PARTIAL;
+          REQUIRE_CHAR(enc, ptr, end);
           open = BYTE_TYPE(enc, ptr);
           if (open == BT_QUOT || open == BT_APOS)
             break;
@@ -598,8 +602,7 @@ PREFIX(scanAtts)(const ENCODING *enc, const char *ptr, const char *end,
         /* in attribute value */
         for (;;) {
           int t;
-          if (ptr == end)
-            return XML_TOK_PARTIAL;
+          REQUIRE_CHAR(enc, ptr, end);
           t = BYTE_TYPE(enc, ptr);
           if (t == open)
             break;
@@ -624,8 +627,7 @@ PREFIX(scanAtts)(const ENCODING *enc, const char *ptr, const char *end,
           }
         }
         ptr += MINBPC(enc);
-        if (ptr == end)
-          return XML_TOK_PARTIAL;
+        REQUIRE_CHAR(enc, ptr, end);
         switch (BYTE_TYPE(enc, ptr)) {
         case BT_S:
         case BT_CR:
@@ -642,8 +644,7 @@ PREFIX(scanAtts)(const ENCODING *enc, const char *ptr, const char *end,
         /* ptr points to closing quote */
         for (;;) {
           ptr += MINBPC(enc);
-          if (ptr == end)
-            return XML_TOK_PARTIAL;
+          REQUIRE_CHAR(enc, ptr, end);
           switch (BYTE_TYPE(enc, ptr)) {
           CHECK_NMSTRT_CASES(enc, ptr, end, nextTokPtr)
           case BT_S: case BT_CR: case BT_LF:
@@ -655,8 +656,7 @@ PREFIX(scanAtts)(const ENCODING *enc, const char *ptr, const char *end,
           case BT_SOL:
           sol:
             ptr += MINBPC(enc);
-            if (ptr == end)
-              return XML_TOK_PARTIAL;
+            REQUIRE_CHAR(enc, ptr, end);
             if (!CHAR_MATCHES(enc, ptr, ASCII_GT)) {
               *nextTokPtr = ptr;
               return XML_TOK_INVALID;
@@ -688,13 +688,12 @@ PREFIX(scanLt)(const ENCODING *enc, const char *ptr, const char *end,
 #ifdef XML_NS
   int hadColon;
 #endif
-  if (ptr == end)
-    return XML_TOK_PARTIAL;
+  REQUIRE_CHAR(enc, ptr, end);
   switch (BYTE_TYPE(enc, ptr)) {
   CHECK_NMSTRT_CASES(enc, ptr, end, nextTokPtr)
   case BT_EXCL:
-    if ((ptr += MINBPC(enc)) == end)
-      return XML_TOK_PARTIAL;
+    ptr += MINBPC(enc);
+    REQUIRE_CHAR(enc, ptr, end);
     switch (BYTE_TYPE(enc, ptr)) {
     case BT_MINUS:
       return PREFIX(scanComment)(enc, ptr + MINBPC(enc), end, nextTokPtr);
@@ -716,7 +715,7 @@ PREFIX(scanLt)(const ENCODING *enc, const char *ptr, const char *end,
   hadColon = 0;
 #endif
   /* we have a start-tag */
-  while (ptr != end) {
+  while (HAS_CHAR(enc, ptr, end)) {
     switch (BYTE_TYPE(enc, ptr)) {
     CHECK_NAME_CASES(enc, ptr, end, nextTokPtr)
 #ifdef XML_NS
@@ -727,8 +726,7 @@ PREFIX(scanLt)(const ENCODING *enc, const char *ptr, const char *end,
       }
       hadColon = 1;
       ptr += MINBPC(enc);
-      if (ptr == end)
-        return XML_TOK_PARTIAL;
+      REQUIRE_CHAR(enc, ptr, end);
       switch (BYTE_TYPE(enc, ptr)) {
       CHECK_NMSTRT_CASES(enc, ptr, end, nextTokPtr)
       default:
@@ -740,7 +738,7 @@ PREFIX(scanLt)(const ENCODING *enc, const char *ptr, const char *end,
     case BT_S: case BT_CR: case BT_LF:
       {
         ptr += MINBPC(enc);
-        while (ptr != end) {
+        while (HAS_CHAR(enc, ptr, end)) {
           switch (BYTE_TYPE(enc, ptr)) {
           CHECK_NMSTRT_CASES(enc, ptr, end, nextTokPtr)
           case BT_GT:
@@ -765,8 +763,7 @@ PREFIX(scanLt)(const ENCODING *enc, const char *ptr, const char *end,
     case BT_SOL:
     sol:
       ptr += MINBPC(enc);
-      if (ptr == end)
-        return XML_TOK_PARTIAL;
+      REQUIRE_CHAR(enc, ptr, end);
       if (!CHAR_MATCHES(enc, ptr, ASCII_GT)) {
         *nextTokPtr = ptr;
         return XML_TOK_INVALID;
@@ -785,7 +782,7 @@ static int PTRCALL
 PREFIX(contentTok)(const ENCODING *enc, const char *ptr, const char *end,
                    const char **nextTokPtr)
 {
-  if (ptr == end)
+  if (ptr >= end)
     return XML_TOK_NONE;
   if (MINBPC(enc) > 1) {
     size_t n = end - ptr;
@@ -803,7 +800,7 @@ PREFIX(contentTok)(const ENCODING *enc, const char *ptr, const char *end,
     return PREFIX(scanRef)(enc, ptr + MINBPC(enc), end, nextTokPtr);
   case BT_CR:
     ptr += MINBPC(enc);
-    if (ptr == end)
+    if (! HAS_CHAR(enc, ptr, end))
       return XML_TOK_TRAILING_CR;
     if (BYTE_TYPE(enc, ptr) == BT_LF)
       ptr += MINBPC(enc);
@@ -814,12 +811,12 @@ PREFIX(contentTok)(const ENCODING *enc, const char *ptr, const char *end,
     return XML_TOK_DATA_NEWLINE;
   case BT_RSQB:
     ptr += MINBPC(enc);
-    if (ptr == end)
+    if (! HAS_CHAR(enc, ptr, end))
       return XML_TOK_TRAILING_RSQB;
     if (!CHAR_MATCHES(enc, ptr, ASCII_RSQB))
       break;
     ptr += MINBPC(enc);
-    if (ptr == end)
+    if (! HAS_CHAR(enc, ptr, end))
       return XML_TOK_TRAILING_RSQB;
     if (!CHAR_MATCHES(enc, ptr, ASCII_GT)) {
       ptr -= MINBPC(enc);
@@ -832,7 +829,7 @@ PREFIX(contentTok)(const ENCODING *enc, const char *ptr, const char *end,
     ptr += MINBPC(enc);
     break;
   }
-  while (ptr != end) {
+  while (HAS_CHAR(enc, ptr, end)) {
     switch (BYTE_TYPE(enc, ptr)) {
 #define LEAD_CASE(n) \
     case BT_LEAD ## n: \
@@ -845,12 +842,12 @@ PREFIX(contentTok)(const ENCODING *enc, const char *ptr, const char *end,
     LEAD_CASE(2) LEAD_CASE(3) LEAD_CASE(4)
 #undef LEAD_CASE
     case BT_RSQB:
-      if (ptr + MINBPC(enc) != end) {
+      if (HAS_CHARS(enc, ptr, end, 2)) {
          if (!CHAR_MATCHES(enc, ptr + MINBPC(enc), ASCII_RSQB)) {
            ptr += MINBPC(enc);
            break;
          }
-         if (ptr + 2*MINBPC(enc) != end) {
+         if (HAS_CHARS(enc, ptr, end, 3)) {
            if (!CHAR_MATCHES(enc, ptr + 2*MINBPC(enc), ASCII_GT)) {
              ptr += MINBPC(enc);
              break;
@@ -884,8 +881,7 @@ static int PTRCALL
 PREFIX(scanPercent)(const ENCODING *enc, const char *ptr, const char *end,
                     const char **nextTokPtr)
 {
-  if (ptr == end)
-    return XML_TOK_PARTIAL;
+  REQUIRE_CHAR(enc, ptr, end);
   switch (BYTE_TYPE(enc, ptr)) {
   CHECK_NMSTRT_CASES(enc, ptr, end, nextTokPtr)
   case BT_S: case BT_LF: case BT_CR: case BT_PERCNT:
@@ -895,7 +891,7 @@ PREFIX(scanPercent)(const ENCODING *enc, const char *ptr, const char *end,
     *nextTokPtr = ptr;
     return XML_TOK_INVALID;
   }
-  while (ptr != end) {
+  while (HAS_CHAR(enc, ptr, end)) {
     switch (BYTE_TYPE(enc, ptr)) {
     CHECK_NAME_CASES(enc, ptr, end, nextTokPtr)
     case BT_SEMI:
@@ -913,15 +909,14 @@ static int PTRCALL
 PREFIX(scanPoundName)(const ENCODING *enc, const char *ptr, const char *end,
                       const char **nextTokPtr)
 {
-  if (ptr == end)
-    return XML_TOK_PARTIAL;
+  REQUIRE_CHAR(enc, ptr, end);
   switch (BYTE_TYPE(enc, ptr)) {
   CHECK_NMSTRT_CASES(enc, ptr, end, nextTokPtr)
   default:
     *nextTokPtr = ptr;
     return XML_TOK_INVALID;
   }
-  while (ptr != end) {
+  while (HAS_CHAR(enc, ptr, end)) {
     switch (BYTE_TYPE(enc, ptr)) {
     CHECK_NAME_CASES(enc, ptr, end, nextTokPtr)
     case BT_CR: case BT_LF: case BT_S:
@@ -941,7 +936,7 @@ PREFIX(scanLit)(int open, const ENCODING *enc,
                 const char *ptr, const char *end,
                 const char **nextTokPtr)
 {
-  while (ptr != end) {
+  while (HAS_CHAR(enc, ptr, end)) {
     int t = BYTE_TYPE(enc, ptr);
     switch (t) {
     INVALID_CASES(ptr, nextTokPtr)
@@ -950,7 +945,7 @@ PREFIX(scanLit)(int open, const ENCODING *enc,
       ptr += MINBPC(enc);
       if (t != open)
         break;
-      if (ptr == end)
+      if (! HAS_CHAR(enc, ptr, end))
         return -XML_TOK_LITERAL;
       *nextTokPtr = ptr;
       switch (BYTE_TYPE(enc, ptr)) {
@@ -973,7 +968,7 @@ PREFIX(prologTok)(const ENCODING *enc, const char *ptr, const char *end,
                   const char **nextTokPtr)
 {
   int tok;
-  if (ptr == end)
+  if (ptr >= end)
     return XML_TOK_NONE;
   if (MINBPC(enc) > 1) {
     size_t n = end - ptr;
@@ -992,8 +987,7 @@ PREFIX(prologTok)(const ENCODING *enc, const char *ptr, const char *end,
   case BT_LT:
     {
       ptr += MINBPC(enc);
-      if (ptr == end)
-        return XML_TOK_PARTIAL;
+      REQUIRE_CHAR(enc, ptr, end);
       switch (BYTE_TYPE(enc, ptr)) {
       case BT_EXCL:
         return PREFIX(scanDecl)(enc, ptr + MINBPC(enc), end, nextTokPtr);
@@ -1021,7 +1015,7 @@ PREFIX(prologTok)(const ENCODING *enc, const char *ptr, const char *end,
   case BT_S: case BT_LF:
     for (;;) {
       ptr += MINBPC(enc);
-      if (ptr == end)
+      if (! HAS_CHAR(enc, ptr, end))
         break;
       switch (BYTE_TYPE(enc, ptr)) {
       case BT_S: case BT_LF:
@@ -1048,11 +1042,10 @@ PREFIX(prologTok)(const ENCODING *enc, const char *ptr, const char *end,
     return XML_TOK_OPEN_BRACKET;
   case BT_RSQB:
     ptr += MINBPC(enc);
-    if (ptr == end)
+    if (! HAS_CHAR(enc, ptr, end))
       return -XML_TOK_CLOSE_BRACKET;
     if (CHAR_MATCHES(enc, ptr, ASCII_RSQB)) {
-      if (ptr + MINBPC(enc) == end)
-        return XML_TOK_PARTIAL;
+      REQUIRE_CHARS(enc, ptr, end, 2);
       if (CHAR_MATCHES(enc, ptr + MINBPC(enc), ASCII_GT)) {
         *nextTokPtr = ptr + 2*MINBPC(enc);
         return XML_TOK_COND_SECT_CLOSE;
@@ -1065,7 +1058,7 @@ PREFIX(prologTok)(const ENCODING *enc, const char *ptr, const char *end,
     return XML_TOK_OPEN_PAREN;
   case BT_RPAR:
     ptr += MINBPC(enc);
-    if (ptr == end)
+    if (! HAS_CHAR(enc, ptr, end))
       return -XML_TOK_CLOSE_PAREN;
     switch (BYTE_TYPE(enc, ptr)) {
     case BT_AST:
@@ -1141,7 +1134,7 @@ PREFIX(prologTok)(const ENCODING *enc, const char *ptr, const char *end,
     *nextTokPtr = ptr;
     return XML_TOK_INVALID;
   }
-  while (ptr != end) {
+  while (HAS_CHAR(enc, ptr, end)) {
     switch (BYTE_TYPE(enc, ptr)) {
     CHECK_NAME_CASES(enc, ptr, end, nextTokPtr)
     case BT_GT: case BT_RPAR: case BT_COMMA:
@@ -1154,8 +1147,7 @@ PREFIX(prologTok)(const ENCODING *enc, const char *ptr, const char *end,
       ptr += MINBPC(enc);
       switch (tok) {
       case XML_TOK_NAME:
-        if (ptr == end)
-          return XML_TOK_PARTIAL;
+        REQUIRE_CHAR(enc, ptr, end);
         tok = XML_TOK_PREFIXED_NAME;
         switch (BYTE_TYPE(enc, ptr)) {
         CHECK_NAME_CASES(enc, ptr, end, nextTokPtr)
@@ -1204,10 +1196,12 @@ PREFIX(attributeValueTok)(const ENCODING *enc, const char *ptr,
                           const char *end, const char **nextTokPtr)
 {
   const char *start;
-  if (ptr == end)
+  if (ptr >= end)
     return XML_TOK_NONE;
+  else if (! HAS_CHAR(enc, ptr, end))
+    return XML_TOK_PARTIAL;
   start = ptr;
-  while (ptr != end) {
+  while (HAS_CHAR(enc, ptr, end)) {
     switch (BYTE_TYPE(enc, ptr)) {
 #define LEAD_CASE(n) \
     case BT_LEAD ## n: ptr += n; break;
@@ -1232,7 +1226,7 @@ PREFIX(attributeValueTok)(const ENCODING *enc, const char *ptr,
     case BT_CR:
       if (ptr == start) {
         ptr += MINBPC(enc);
-        if (ptr == end)
+        if (! HAS_CHAR(enc, ptr, end))
           return XML_TOK_TRAILING_CR;
         if (BYTE_TYPE(enc, ptr) == BT_LF)
           ptr += MINBPC(enc);
@@ -1262,10 +1256,12 @@ PREFIX(entityValueTok)(const ENCODING *enc, const char *ptr,
                        const char *end, const char **nextTokPtr)
 {
   const char *start;
-  if (ptr == end)
+  if (ptr >= end)
     return XML_TOK_NONE;
+  else if (! HAS_CHAR(enc, ptr, end))
+    return XML_TOK_PARTIAL;
   start = ptr;
-  while (ptr != end) {
+  while (HAS_CHAR(enc, ptr, end)) {
     switch (BYTE_TYPE(enc, ptr)) {
 #define LEAD_CASE(n) \
     case BT_LEAD ## n: ptr += n; break;
@@ -1294,7 +1290,7 @@ PREFIX(entityValueTok)(const ENCODING *enc, const char *ptr,
     case BT_CR:
       if (ptr == start) {
         ptr += MINBPC(enc);
-        if (ptr == end)
+        if (! HAS_CHAR(enc, ptr, end))
           return XML_TOK_TRAILING_CR;
         if (BYTE_TYPE(enc, ptr) == BT_LF)
           ptr += MINBPC(enc);
@@ -1326,15 +1322,15 @@ PREFIX(ignoreSectionTok)(const ENCODING *enc, const char *ptr,
       end = ptr + n;
     }
   }
-  while (ptr != end) {
+  while (HAS_CHAR(enc, ptr, end)) {
     switch (BYTE_TYPE(enc, ptr)) {
     INVALID_CASES(ptr, nextTokPtr)
     case BT_LT:
-      if ((ptr += MINBPC(enc)) == end)
-        return XML_TOK_PARTIAL;
+      ptr += MINBPC(enc);
+      REQUIRE_CHAR(enc, ptr, end);
       if (CHAR_MATCHES(enc, ptr, ASCII_EXCL)) {
-        if ((ptr += MINBPC(enc)) == end)
-          return XML_TOK_PARTIAL;
+        ptr += MINBPC(enc);
+        REQUIRE_CHAR(enc, ptr, end);
         if (CHAR_MATCHES(enc, ptr, ASCII_LSQB)) {
           ++level;
           ptr += MINBPC(enc);
@@ -1342,11 +1338,11 @@ PREFIX(ignoreSectionTok)(const ENCODING *enc, const char *ptr,
       }
       break;
     case BT_RSQB:
-      if ((ptr += MINBPC(enc)) == end)
-        return XML_TOK_PARTIAL;
+      ptr += MINBPC(enc);
+      REQUIRE_CHAR(enc, ptr, end);
       if (CHAR_MATCHES(enc, ptr, ASCII_RSQB)) {
-        if ((ptr += MINBPC(enc)) == end)
-          return XML_TOK_PARTIAL;
+        ptr += MINBPC(enc);
+        REQUIRE_CHAR(enc, ptr, end);
         if (CHAR_MATCHES(enc, ptr, ASCII_GT)) {
           ptr += MINBPC(enc);
           if (level == 0) {
@@ -1373,7 +1369,7 @@ PREFIX(isPublicId)(const ENCODING *enc, const char *ptr, const char *end,
 {
   ptr += MINBPC(enc);
   end -= MINBPC(enc);
-  for (; ptr != end; ptr += MINBPC(enc)) {
+  for (; HAS_CHAR(enc, ptr, end); ptr += MINBPC(enc)) {
     switch (BYTE_TYPE(enc, ptr)) {
     case BT_DIGIT:
     case BT_HEX:
@@ -1521,7 +1517,7 @@ PREFIX(getAtts)(const ENCODING *enc, const char *ptr,
 }
 
 static int PTRFASTCALL
-PREFIX(charRefNumber)(const ENCODING *enc, const char *ptr)
+PREFIX(charRefNumber)(const ENCODING *UNUSED_P(enc), const char *ptr)
 {
   int result = 0;
   /* skip &# */
@@ -1565,7 +1561,7 @@ PREFIX(charRefNumber)(const ENCODING *enc, const char *ptr)
 }
 
 static int PTRCALL
-PREFIX(predefinedEntityName)(const ENCODING *enc, const char *ptr,
+PREFIX(predefinedEntityName)(const ENCODING *UNUSED_P(enc), const char *ptr,
                              const char *end)
 {
   switch ((end - ptr)/MINBPC(enc)) {
@@ -1683,11 +1679,11 @@ PREFIX(sameName)(const ENCODING *enc, const char *ptr1, const char *ptr2)
 }
 
 static int PTRCALL
-PREFIX(nameMatchesAscii)(const ENCODING *enc, const char *ptr1,
+PREFIX(nameMatchesAscii)(const ENCODING *UNUSED_P(enc), const char *ptr1,
                          const char *end1, const char *ptr2)
 {
   for (; *ptr2; ptr1 += MINBPC(enc), ptr2++) {
-    if (ptr1 == end1)
+    if (end1 - ptr1 < MINBPC(enc))
       return 0;
     if (!CHAR_MATCHES(enc, ptr1, *ptr2))
       return 0;
@@ -1744,7 +1740,7 @@ PREFIX(updatePosition)(const ENCODING *enc,
                        const char *end,
                        POSITION *pos)
 {
-  while (ptr < end) {
+  while (HAS_CHAR(enc, ptr, end)) {
     switch (BYTE_TYPE(enc, ptr)) {
 #define LEAD_CASE(n) \
     case BT_LEAD ## n: \
@@ -1760,7 +1756,7 @@ PREFIX(updatePosition)(const ENCODING *enc,
     case BT_CR:
       pos->lineNumber++;
       ptr += MINBPC(enc);
-      if (ptr != end && BYTE_TYPE(enc, ptr) == BT_LF)
+      if (HAS_CHAR(enc, ptr, end) && BYTE_TYPE(enc, ptr) == BT_LF)
         ptr += MINBPC(enc);
       pos->columnNumber = (XML_Size)-1;
       break;
index 6a901f7..53d3445 100644 (file)
@@ -1107,10 +1107,8 @@ newxmlparseobject(char *encoding, char *namespace_separator, PyObject *intern)
         Py_DECREF(self);
         return NULL;
     }
-#if ((XML_MAJOR_VERSION >= 2) && (XML_MINOR_VERSION >= 1)) || defined(XML_HAS_SET_HASH_SALT)
-    /* This feature was added upstream in libexpat 2.1.0.  Our expat copy
-     * has a backport of this feature where we also define XML_HAS_SET_HASH_SALT
-     * to indicate that we can still use it. */
+#if XML_COMBINED_VERSION >= 20100
+    /* This feature was added upstream in libexpat 2.1.0. */
     XML_SetHashSalt(self->itself,
                     (unsigned long)_Py_HashSecret.expat.hashsalt);
 #endif
index 5e96138..e1a1080 100644 (file)
@@ -2714,8 +2714,8 @@ _PySequence_BytesToCharpArray(PyObject* self)
             array[i] = NULL;
             goto fail;
         }
-        data = PyBytes_AsString(item);
-        if (data == NULL) {
+        /* check for embedded null bytes */
+        if (PyBytes_AsStringAndSize(item, &data, NULL) < 0) {
             /* NULL terminate before freeing. */
             array[i] = NULL;
             goto fail;
index 25619c1..5fc698c 100644 (file)
@@ -805,56 +805,61 @@ insertdict(PyDictObject *mp, PyObject *key, Py_hash_t hash, PyObject *value)
     PyDictKeyEntry *ep;
     assert(key != dummy);
 
+    Py_INCREF(key);
+    Py_INCREF(value);
     if (mp->ma_values != NULL && !PyUnicode_CheckExact(key)) {
         if (insertion_resize(mp) < 0)
-            return -1;
+            goto Fail;
     }
 
     ep = mp->ma_keys->dk_lookup(mp, key, hash, &value_addr);
-    if (ep == NULL) {
-        return -1;
-    }
+    if (ep == NULL)
+        goto Fail;
+
     assert(PyUnicode_CheckExact(key) || mp->ma_keys->dk_lookup == lookdict);
-    Py_INCREF(value);
     MAINTAIN_TRACKING(mp, key, value);
     old_value = *value_addr;
     if (old_value != NULL) {
         assert(ep->me_key != NULL && ep->me_key != dummy);
         *value_addr = value;
         Py_DECREF(old_value); /* which **CAN** re-enter (see issue #22653) */
+        Py_DECREF(key);
     }
     else {
         if (ep->me_key == NULL) {
-            Py_INCREF(key);
             if (mp->ma_keys->dk_usable <= 0) {
                 /* Need to resize. */
-                if (insertion_resize(mp) < 0) {
-                    Py_DECREF(key);
-                    Py_DECREF(value);
-                    return -1;
-                }
+                if (insertion_resize(mp) < 0)
+                    goto Fail;
                 ep = find_empty_slot(mp, key, hash, &value_addr);
             }
+            mp->ma_used++;
+            *value_addr = value;
             mp->ma_keys->dk_usable--;
             assert(mp->ma_keys->dk_usable >= 0);
             ep->me_key = key;
             ep->me_hash = hash;
+            assert(ep->me_key != NULL && ep->me_key != dummy);
         }
         else {
+            mp->ma_used++;
+            *value_addr = value;
             if (ep->me_key == dummy) {
-                Py_INCREF(key);
                 ep->me_key = key;
                 ep->me_hash = hash;
                 Py_DECREF(dummy);
             } else {
                 assert(_PyDict_HasSplitTable(mp));
+                Py_DECREF(key);
             }
         }
-        mp->ma_used++;
-        *value_addr = value;
-        assert(ep->me_key != NULL && ep->me_key != dummy);
     }
     return 0;
+
+Fail:
+    Py_DECREF(value);
+    Py_DECREF(key);
+    return -1;
 }
 
 /*
@@ -1911,11 +1916,18 @@ PyDict_MergeFromSeq2(PyObject *d, PyObject *seq2, int override)
         /* Update/merge with this (key, value) pair. */
         key = PySequence_Fast_GET_ITEM(fast, 0);
         value = PySequence_Fast_GET_ITEM(fast, 1);
+        Py_INCREF(key);
+        Py_INCREF(value);
         if (override || PyDict_GetItem(d, key) == NULL) {
             int status = PyDict_SetItem(d, key, value);
-            if (status < 0)
+            if (status < 0) {
+                Py_DECREF(key);
+                Py_DECREF(value);
                 goto Fail;
+            }
         }
+        Py_DECREF(key);
+        Py_DECREF(value);
         Py_DECREF(fast);
         Py_DECREF(item);
     }
@@ -2174,14 +2186,15 @@ dict_equal(PyDictObject *a, PyDictObject *b)
                 bval = NULL;
             else
                 bval = *vaddr;
-            Py_DECREF(key);
             if (bval == NULL) {
+                Py_DECREF(key);
                 Py_DECREF(aval);
                 if (PyErr_Occurred())
                     return -1;
                 return 0;
             }
             cmp = PyObject_RichCompareBool(aval, bval, Py_EQ);
+            Py_DECREF(key);
             Py_DECREF(aval);
             if (cmp <= 0)  /* error or not equal */
                 return cmp;
@@ -3046,7 +3059,7 @@ PyTypeObject PyDictIterValue_Type = {
 
 static PyObject *dictiter_iternextitem(dictiterobject *di)
 {
-    PyObject *key, *value, *result = di->di_result;
+    PyObject *key, *value, *result;
     Py_ssize_t i, mask, offset;
     PyDictObject *d = di->di_dict;
     PyObject **value_ptr;
@@ -3082,22 +3095,27 @@ static PyObject *dictiter_iternextitem(dictiterobject *di)
     if (i > mask)
         goto fail;
 
-    if (result->ob_refcnt == 1) {
+    di->len--;
+    key = d->ma_keys->dk_entries[i].me_key;
+    value = *value_ptr;
+    Py_INCREF(key);
+    Py_INCREF(value);
+    result = di->di_result;
+    if (Py_REFCNT(result) == 1) {
+        PyObject *oldkey = PyTuple_GET_ITEM(result, 0);
+        PyObject *oldvalue = PyTuple_GET_ITEM(result, 1);
+        PyTuple_SET_ITEM(result, 0, key);  /* steals reference */
+        PyTuple_SET_ITEM(result, 1, value);  /* steals reference */
         Py_INCREF(result);
-        Py_DECREF(PyTuple_GET_ITEM(result, 0));
-        Py_DECREF(PyTuple_GET_ITEM(result, 1));
+        Py_DECREF(oldkey);
+        Py_DECREF(oldvalue);
     } else {
         result = PyTuple_New(2);
         if (result == NULL)
             return NULL;
+        PyTuple_SET_ITEM(result, 0, key);  /* steals reference */
+        PyTuple_SET_ITEM(result, 1, value);  /* steals reference */
     }
-    di->len--;
-    key = d->ma_keys->dk_entries[i].me_key;
-    value = *value_ptr;
-    Py_INCREF(key);
-    Py_INCREF(value);
-    PyTuple_SET_ITEM(result, 0, key);
-    PyTuple_SET_ITEM(result, 1, value);
     return result;
 
 fail:
@@ -3596,6 +3614,7 @@ dictitems_iter(dictviewobject *dv)
 static int
 dictitems_contains(dictviewobject *dv, PyObject *obj)
 {
+    int result;
     PyObject *key, *value, *found;
     if (dv->dv_dict == NULL)
         return 0;
@@ -3609,7 +3628,10 @@ dictitems_contains(dictviewobject *dv, PyObject *obj)
             return -1;
         return 0;
     }
-    return PyObject_RichCompareBool(value, found, Py_EQ);
+    Py_INCREF(found);
+    result = PyObject_RichCompareBool(value, found, Py_EQ);
+    Py_DECREF(found);
+    return result;
 }
 
 static PySequenceMethods dictitems_as_sequence = {
index ca5355a..2fae4d7 100644 (file)
@@ -1116,11 +1116,6 @@ subtype_dealloc(PyObject *self)
     Py_TRASHCAN_SAFE_BEGIN(self);
     --_PyTrash_delete_nesting;
     -- tstate->trash_delete_nesting;
-    /* DO NOT restore GC tracking at this point.  weakref callbacks
-     * (if any, and whether directly here or indirectly in something we
-     * call) may trigger GC, and if self is tracked at that point, it
-     * will look like trash to GC and GC will try to delete self again.
-     */
 
     /* Find the nearest base with a different tp_dealloc */
     base = type;
@@ -1131,30 +1126,36 @@ subtype_dealloc(PyObject *self)
 
     has_finalizer = type->tp_finalize || type->tp_del;
 
-    /* Maybe call finalizer; exit early if resurrected */
-    if (has_finalizer)
-        _PyObject_GC_TRACK(self);
-
     if (type->tp_finalize) {
+        _PyObject_GC_TRACK(self);
         if (PyObject_CallFinalizerFromDealloc(self) < 0) {
             /* Resurrected */
             goto endlabel;
         }
+        _PyObject_GC_UNTRACK(self);
     }
-    /* If we added a weaklist, we clear it.      Do this *before* calling
-       tp_del, clearing slots, or clearing the instance dict. */
+    /*
+      If we added a weaklist, we clear it. Do this *before* calling tp_del,
+      clearing slots, or clearing the instance dict.
+
+      GC tracking must be off at this point. weakref callbacks (if any, and
+      whether directly here or indirectly in something we call) may trigger GC,
+      and if self is tracked at that point, it will look like trash to GC and GC
+      will try to delete self again.
+    */
     if (type->tp_weaklistoffset && !base->tp_weaklistoffset)
         PyObject_ClearWeakRefs(self);
 
     if (type->tp_del) {
+        _PyObject_GC_TRACK(self);
         type->tp_del(self);
         if (self->ob_refcnt > 0) {
             /* Resurrected */
             goto endlabel;
         }
+        _PyObject_GC_UNTRACK(self);
     }
     if (has_finalizer) {
-        _PyObject_GC_UNTRACK(self);
         /* New weakrefs could be created during the finalizer call.
            If this occurs, clear them out without calling their
            finalizers since they might rely on part of the object
index 7802ab3..3bd513f 100644 (file)
     </Midl>
     <ClCompile>
       <AdditionalIncludeDirectories>..\Modules\expat;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>
-      <PreprocessorDefinitions>XML_NS;XML_DTD;BYTEORDER=1234;XML_CONTEXT_BYTES=1024;USE_PYEXPAT_CAPI;XML_STATIC;HAVE_MEMMOVE;%(PreprocessorDefinitions)</PreprocessorDefinitions>
+      <PreprocessorDefinitions>_CRT_SECURE_NO_WARNINGS;USE_PYEXPAT_CAPI;XML_STATIC;%(PreprocessorDefinitions)</PreprocessorDefinitions>
     </ClCompile>
     <Link>
       <BaseAddress>0x1D100000</BaseAddress>
   <Import Project="$(VCTargetsPath)\Microsoft.Cpp.targets" />
   <ImportGroup Label="ExtensionTargets">
   </ImportGroup>
-</Project>
\ No newline at end of file
+</Project>
diff --git a/README b/README
index 2ee032b..d1f6a4d 100644 (file)
--- a/README
+++ b/README
@@ -1,4 +1,4 @@
-This is Python version 3.4.6
+This is Python version 3.4.7
 ============================
 
 Copyright (c) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011,
@@ -176,7 +176,8 @@ Copyright and License Information
 ---------------------------------
 
 Copyright (c) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011,
-2012, 2013, 2014, 2015, 2016 Python Software Foundation.  All rights reserved.
+2012, 2013, 2014, 2015, 2016, 2017 Python Software Foundation.  All rights
+reserved.
 
 Copyright (c) 2000 BeOpen.com.  All rights reserved.