Update 3.5 to use blurb!

.travis.yml

@@ -40,7 +40,7 @@ matrix:
         - cd Doc
         # Sphinx is pinned so that new versions that introduce new warnings won't suddenly cause build failures.
         # (Updating the version is fine as long as no warnings are raised by doing so.)
-        - python -m pip install sphinx~=1.6.1
+        - python -m pip install sphinx~=1.6.1 blurb
       script:
         - make check suspicious html SPHINXOPTS="-q -W -j4"
     - os: linux

Doc/Makefile

@@ -6,6 +6,7 @@
 # You can set these variables from the command line.
 PYTHON       = python3
 SPHINXBUILD  = sphinx-build
+BLURB = $(PYTHON) -m blurb
 PAPER        =
 SOURCES      =
 DISTVERSION  = $(shell $(PYTHON) tools/extensions/patchlevel.py)
@@ -38,6 +39,8 @@ help:
 	@echo "  serve      to serve the documentation on the localhost (8000)"
 
 build:
+	-mkdir -p build
+	$(BLURB) merge -f build/NEWS
 	$(SPHINXBUILD) $(ALLSPHINXOPTS)
 	@echo
 
@@ -107,7 +110,7 @@ clean:
 
 venv:
 	$(PYTHON) -m venv venv
-	./venv/bin/python3 -m pip install -U Sphinx
+	./venv/bin/python3 -m pip install -U Sphinx blurb
 
 dist:
 	rm -rf dist

Doc/whatsnew/changelog.rst

@@ -4,4 +4,4 @@
 Changelog
 +++++++++
 
-.. miscnews:: ../../Misc/NEWS
+.. miscnews:: ../build/NEWS

Misc/NEWS.d/3.4.0.rst

+.. bpo: 20939
+.. date: 8350
+.. nonce: MX5O4e
+.. release date: 2014-03-16
+.. section: Library
+
+Fix test_geturl failure in test_urllibnet due to new redirect of
+http://www.python.org/ to https://www.python.org.
+
+..
+
+.. bpo: 0
+.. date: 8349
+.. nonce: 1hrH2G
+.. section: Documentation
+
+Merge in all documentation changes since branching 3.4.0rc1.

Misc/NEWS.d/3.4.0a3.rst

+.. bpo: 18818
+.. date: 7851
+.. nonce: fsZ51D
+.. release date: 2013-09-29
+.. section: Core and Builtins
+
+The "encodingname" part of PYTHONIOENCODING is now optional.
+
+..
+
+.. bpo: 19098
+.. date: 7850
+.. nonce: 5XU9uv
+.. section: Core and Builtins
+
+Prevent overflow in the compiler when the recursion limit is set absurdly
+high.
+
+..
+
+.. bpo: 18929
+.. date: 7849
+.. nonce: xt9_At
+.. section: Library
+
+`inspect.classify_class_attrs()` now correctly finds class attributes
+returned by `dir()` that are located in the metaclass.
+
+..
+
+.. bpo: 18950
+.. date: 7848
+.. nonce: DHn3qf
+.. section: Library
+
+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.
+
+..
+
+.. bpo: 18594
+.. date: 7847
+.. nonce: Dm34qD
+.. section: Library
+
+The fast path for collections.Counter() was never taken due to an over-
+restrictive type check.
+
+..
+
+.. bpo: 19053
+.. date: 7846
+.. nonce: DkcFZ8
+.. section: Library
+
+ZipExtFile.read1() with non-zero argument no more returns empty bytes until
+end of data.
+
+..
+
+.. bpo: 0
+.. date: 7845
+.. nonce: x-7joT
+.. section: Library
+
+logging: added support for Unix domain sockets to SocketHandler and
+DatagramHandler.
+
+..
+
+.. bpo: 18996
+.. date: 7844
+.. nonce: 1Waotx
+.. section: Library
+
+TestCase.assertEqual() now more cleverly shorten differing strings in error
+report.
+
+..
+
+.. bpo: 19034
+.. date: 7843
+.. nonce: S5MyMF
+.. section: Library
+
+repr() for tkinter.Tcl_Obj now exposes string reperesentation.
+
+..
+
+.. bpo: 18978
+.. date: 7842
+.. nonce: qyLkAY
+.. section: Library
+
+``urllib.request.Request`` now allows the method to be indicated on the
+class and no longer sets it to None in ``__init__``.
+
+..
+
+.. bpo: 18626
+.. date: 7841
+.. nonce: X3HiU3
+.. section: Library
+
+the inspect module now offers a basic command line introspection interface
+(Initial patch by Claudiu Popa)
+
+..
+
+.. bpo: 3015
+.. date: 7840
+.. nonce: Db5Zwa
+.. section: Library
+
+Fixed tkinter with wantobject=False.  Any Tcl command call returned empty
+string.
+
+..
+
+.. bpo: 19037
+.. date: 7839
+.. nonce: OfBhoU
+.. section: Library
+
+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: 14984
+.. date: 7838
+.. nonce: iRbFp4
+.. section: Library
+
+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.
+
+..
+
+.. bpo: 18873
+.. date: 7837
+.. nonce: 3ezwXm
+.. section: Library
+
+The tokenize module now detects Python source code encoding only in comment
+lines.
+
+..
+
+.. bpo: 17764
+.. date: 7836
+.. nonce: czuuKO
+.. section: Library
+
+Enable http.server to bind to a user specified network interface.  Patch
+contributed by Malte Swart.
+
+..
+
+.. bpo: 18937
+.. date: 7835
+.. nonce: bcvKgi
+.. section: Library
+
+Add an assertLogs() context manager to unittest.TestCase to ensure that a
+block of code emits a message using the logging module.
+
+..
+
+.. bpo: 17324
+.. date: 7834
+.. nonce: 0PkOTi
+.. section: Library
+
+Fix http.server's request handling case on trailing '/'. Patch contributed
+by Vajrasky Kok.
+
+..
+
+.. bpo: 19018
+.. date: 7833
+.. nonce: mntKOW
+.. section: Library
+
+The heapq.merge() function no longer suppresses IndexError in the underlying
+iterables.
+
+..
+
+.. bpo: 18784
+.. date: 7832
+.. nonce: dtzGbX
+.. section: Library
+
+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: 0
+.. date: 7831
+.. nonce: 22MCfN
+.. section: Library
+
+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`.
+
+..
+
+.. bpo: 1565525
+.. date: 7830
+.. nonce: 0rVMB7
+.. section: Library
+
+New function ``traceback.clear_frames`` will clear the local variables of
+all the stack frames referenced by a traceback object.
+
+..
+
+.. bpo: 18952
+.. date: 7829
+.. nonce: ysovuf
+.. section: Tests
+
+Fix regression in support data downloads introduced when test.support was
+converted to a package. Regression noticed by Zachary Ware.
+
+..
+
+.. bpo: 18873
+.. date: 7828
+.. nonce: dyLPY9
+.. section: IDLE
+
+IDLE now detects Python source code encoding only in comment lines.
+
+..
+
+.. bpo: 18988
+.. date: 7827
+.. nonce: 6CpesW
+.. section: IDLE
+
+The "Tab" key now works when a word is already autocompleted.
+
+..
+
+.. bpo: 17003
+.. date: 7826
+.. nonce: eQGdny
+.. section: Documentation
+
+Unified the size argument names in the io module with common practice.
+
+..
+
+.. bpo: 18596
+.. date: 7825
+.. nonce: TMPNJZ
+.. section: Build
+
+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.
+
+..
+
+.. bpo: 18873
+.. date: 7824
+.. nonce: i_1Tf_
+.. section: Tools/Demos
+
+2to3 and the findnocoding.py script now detect Python source code encoding
+only in comment lines.

Misc/NEWS.d/3.4.0rc2.rst

+.. bpo: 20625
+.. date: 8341
+.. nonce: IA5Cu9
+.. release date: 2014-02-23
+.. section: Core and Builtins
+
+Parameter names in __annotations__ were not mangled properly. Discovered by
+Jonas Wielicki, patch by Yury Selivanov.
+
+..
+
+.. bpo: 20261
+.. date: 8340
+.. nonce: xyA9tG
+.. section: Core and Builtins
+
+In pickle, lookup __getnewargs__ and __getnewargs_ex__ on the type of the
+object.
+
+..
+
+.. bpo: 20619
+.. date: 8339
+.. nonce: GtdhSO
+.. section: Core and Builtins
+
+Give the AST nodes of keyword-only arguments a column and line number.
+
+..
+
+.. bpo: 20526
+.. date: 8338
+.. nonce: wZEy32
+.. section: Core and Builtins
+
+Revert changes of issue #19466 which introduces a regression: don't clear
+anymore the state of Python threads early during the Python shutdown.
+
+..
+
+.. bpo: 20710
+.. date: 8337
+.. nonce: byega8
+.. section: Library
+
+The pydoc summary line no longer displays the "self" parameter for bound
+methods.
+
+..
+
+.. bpo: 20566
+.. date: 8336
+.. nonce: R8yrPZ
+.. section: Library
+
+Change asyncio.as_completed() to use a Queue, to avoid O(N**2) behavior.
+
+..
+
+.. bpo: 20704
+.. date: 8335
+.. nonce: QQ4uy4
+.. section: Library
+
+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: 0
+.. date: 8334
+.. nonce: Ocnov-
+.. section: Library
+
+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.
+
+..
+
+.. bpo: 20684
+.. date: 8333
+.. nonce: EArKf9
+.. section: Library
+
+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.
+
+..
+
+.. bpo: 20681
+.. date: 8332
+.. nonce: O8EUu8
+.. section: Library
+
+Add new error handling API in asyncio. New APIs:
+loop.set_exception_handler(), loop.default_exception_handler(), and
+loop.call_exception_handler().
+
+..
+
+.. bpo: 20673
+.. date: 8331
+.. nonce: bLJpSo
+.. section: Library
+
+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().
+
+..
+
+.. bpo: 20616
+.. date: 8330
+.. nonce: 9fIygg
+.. section: Library
+
+Add a format() method to tracemalloc.Traceback.
+
+..
+
+.. bpo: 19744
+.. date: 8329
+.. nonce: fL4Brl
+.. section: Library
+
+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.
+
+..
+
+.. bpo: 20594
+.. date: 8328
+.. nonce: BVHxPd
+.. section: Library
+
+Avoid name clash with the libc function posix_close.
+
+..
+
+.. bpo: 20641
+.. date: 8327
+.. nonce: kAo-M-
+.. section: Build
+
+Run MSI custom actions (pip installation, pyc compilation) with the
+NoImpersonate flag, to support elevated execution (UAC).
+
+..
+
+.. bpo: 20221
+.. date: 8326
+.. nonce: _yAetK
+.. section: Build
+
+Removed conflicting (or circular) hypot definition when compiled with VS
+2010 or above.  Initial patch by Tabrez Mohammed.
+
+..
+
+.. bpo: 20609
+.. date: 8325
+.. nonce: IMbrDQ
+.. section: Build
+
+Restored the ability to build 64-bit Windows binaries on 32-bit Windows,
+which was broken by the change in issue #19788.

Misc/NEWS.d/3.4.0rc3.rst

+.. bpo: 20786
+.. date: 8348
+.. nonce: M_2OYE
+.. release date: 2014-03-09
+.. section: Core and Builtins
+
+Fix signatures for dict.__delitem__ and property.__delete__ builtins.
+
+..
+
+.. bpo: 20839
+.. date: 8347
+.. nonce: SNn1MY
+.. section: Library
+
+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: 14512
+.. date: 8346
+.. nonce: y7vmx3
+.. section: Build
+
+Launch pydoc -b instead of pydocgui.pyw on Windows.
+
+..
+
+.. bpo: 20748
+.. date: 8345
+.. nonce: HbDp_u
+.. section: Build
+
+Uninstalling pip does not leave behind the pyc of the uninstaller anymore.
+
+..
+
+.. bpo: 20568
+.. date: 8344
+.. nonce: ZvMU8d
+.. section: Build
+
+The Windows installer now installs the unversioned ``pip`` command in
+addition to the versioned ``pip3`` and ``pip3.4`` commands.
+
+..
+
+.. bpo: 20757
+.. date: 8343
+.. nonce: BGFT6U
+.. section: Build
+
+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.
+
+..
+
+.. bpo: 20465
+.. date: 8342
+.. nonce: iemVBC
+.. section: Build
+
+Update OS X and Windows installer builds to use SQLite 3.8.3.1.

Misc/NEWS.d/3.5.0.rst

+.. bpo: 25071
+.. date: 9305
+.. nonce: EwjXl1
+.. release date: 2015-09-13
+.. section: Build
+
+Windows installer should not require TargetDir parameter when installing
+quietly.

Misc/NEWS.d/3.5.0b2.rst

+.. bpo: 24284
+.. date: 9208
+.. nonce: NvtEnc
+.. release date: 2015-05-31
+.. section: Core and Builtins
+
+The startswith and endswith methods of the str class no longer return True
+when finding the empty string and the indexes are completely out of range.
+
+..
+
+.. bpo: 24115
+.. date: 9207
+.. nonce: y9e_MO
+.. section: Core and Builtins
+
+Update uses of PyObject_IsTrue(), PyObject_Not(), PyObject_IsInstance(),
+PyObject_RichCompareBool() and _PyDict_Contains() to check for and handle
+errors correctly.
+
+..
+
+.. bpo: 24328
+.. date: 9206
+.. nonce: 5gL8or
+.. section: Core and Builtins
+
+Fix importing one character extension modules.
+
+..
+
+.. bpo: 11205
+.. date: 9205
+.. nonce: bikrRP
+.. section: Core and Builtins
+
+In dictionary displays, evaluate the key before the value.
+
+..
+
+.. bpo: 24285
+.. date: 9204
+.. nonce: wvJumr
+.. section: Core and Builtins
+
+Fixed regression that prevented importing extension modules from inside
+packages. Patch by Petr Viktorin.
+
+..
+
+.. bpo: 23247
+.. date: 9203
+.. nonce: nN-K74
+.. section: Library
+
+Fix a crash in the StreamWriter.reset() of CJK codecs.
+
+..
+
+.. bpo: 24270
+.. date: 9202
+.. nonce: M2rJNs
+.. section: Library
+
+Add math.isclose() and cmath.isclose() functions as per PEP 485. Contributed
+by Chris Barker and Tal Einat.
+
+..
+
+.. bpo: 5633
+.. date: 9201
+.. nonce: JNzKZq
+.. section: Library
+
+Fixed timeit when the statement is a string and the setup is not.
+
+..
+
+.. bpo: 24326
+.. date: 9200
+.. nonce: 4t_6Gy
+.. section: Library
+
+Fixed audioop.ratecv() with non-default weightB argument. Original patch by
+David Moore.
+
+..
+
+.. bpo: 16991
+.. date: 9199
+.. nonce: 19_Zmj
+.. section: Library
+
+Add a C implementation of OrderedDict.
+
+..
+
+.. bpo: 23934
+.. date: 9198
+.. nonce: esb-45
+.. section: Library
+
+Fix inspect.signature to fail correctly for builtin types lacking signature
+information.  Initial patch by James Powell.

Misc/NEWS.d/3.5.0rc2.rst

+.. bpo: 24769
+.. date: 9294
+.. nonce: XgRA0n
+.. release date: 2015-08-25
+.. section: Core and Builtins
+
+Interpreter now starts properly when dynamic loading is disabled.  Patch by
+Petr Viktorin.
+
+..
+
+.. bpo: 21167
+.. date: 9293
+.. nonce: uom-Dq
+.. section: Core and Builtins
+
+NAN operations are now handled correctly when python is compiled with ICC
+even if -fp-model strict is not specified.
+
+..
+
+.. bpo: 24492
+.. date: 9292
+.. nonce: LKDAIu
+.. section: Core and Builtins
+
+A "package" lacking a __name__ attribute when trying to perform a ``from ..
+import ...`` statement will trigger an ImportError instead of an
+AttributeError.
+
+..
+
+.. bpo: 24847
+.. date: 9291
+.. nonce: SHiiO_
+.. section: Library
+
+Removes vcruntime140.dll dependency from Tcl/Tk.
+
+..
+
+.. bpo: 24839
+.. date: 9290
+.. nonce: 7_iQZl
+.. section: Library
+
+platform._syscmd_ver raises DeprecationWarning
+
+..
+
+.. bpo: 24867
+.. date: 9289
+.. nonce: rxJIl7
+.. section: Library
+
+Fix Task.get_stack() for 'async def' coroutines

Misc/NEWS.d/3.5.0rc3.rst

+.. bpo: 24305
+.. date: 9302
+.. nonce: QeF4A8
+.. release date: 2015-09-07
+.. section: Core and Builtins
+
+Prevent import subsystem stack frames from being counted by the
+warnings.warn(stacklevel=) parameter.
+
+..
+
+.. bpo: 24912
+.. date: 9301
+.. nonce: ubSi5J
+.. section: Core and Builtins
+
+Prevent __class__ assignment to immutable built-in objects.
+
+..
+
+.. bpo: 24975
+.. date: 9300
+.. nonce: 2gLdfN
+.. section: Core and Builtins
+
+Fix AST compilation for PEP 448 syntax.
+
+..
+
+.. bpo: 24917
+.. date: 9299
+.. nonce: xaQocz
+.. section: Library
+
+time_strftime() buffer over-read.
+
+..
+
+.. bpo: 24748
+.. date: 9298
+.. nonce: 83NuO8
+.. section: Library
+
+To resolve a compatibility problem found with py2exe and pywin32,
+imp.load_dynamic() once again ignores previously loaded modules to support
+Python modules replacing themselves with extension modules. Patch by Petr
+Viktorin.
+
+..
+
+.. bpo: 24635
+.. date: 9297
+.. nonce: EiJPPf
+.. section: Library
+
+Fixed a bug in typing.py where isinstance([], typing.Iterable) would return
+True once, then False on subsequent calls.
+
+..
+
+.. bpo: 24989
+.. date: 9296
+.. nonce: 9BJLiy
+.. section: Library
+
+Fixed buffer overread in BytesIO.readline() if a position is set beyond
+size.  Based on patch by John Leitch.
+
+..
+
+.. bpo: 24913
+.. date: 9295
+.. nonce: p2ZAJ4
+.. section: Library
+
+Fix overrun error in deque.index(). Found by John Leitch and Bryce Darling.

Misc/NEWS.d/3.5.0rc4.rst

+.. bpo: 25029
+.. date: 9304
+.. nonce: Zf97rk
+.. release date: 2015-09-09
+.. section: Library
+
+Fixes MemoryError in test_strptime.
+
+..
+
+.. bpo: 25027
+.. date: 9303
+.. nonce: Zaib78
+.. section: Build
+
+Reverts partial-static build options and adds vcruntime140.dll to Windows
+installation.

Misc/NEWS.d/3.5.1.rst

+.. bpo: 25709
+.. date: 9452
+.. nonce: OPX2TS
+.. release date: 2015-12-06
+.. section: Core and Builtins
+
+Fixed problem with in-place string concatenation and utf-8 cache.
+
+..
+
+.. bpo: 25715
+.. date: 9451
+.. nonce: 3LLYLj
+.. section: Windows
+
+Python 3.5.1 installer shows wrong upgrade path and incorrect logic for
+launcher detection.

Misc/NEWS.d/3.5.2.rst

+.. bpo: 26930
+.. date: 9676
+.. nonce: 9JUeSD
+.. release date: 2016-06-26
+.. section: Core and Builtins
+
+Update Windows builds to use OpenSSL 1.0.2h.
+
+..
+
+.. bpo: 26867
+.. date: 9675
+.. nonce: QPSyP5
+.. section: Tests
+
+Ubuntu's openssl OP_NO_SSLv3 is forced on by default; fix test.
+
+..
+
+.. bpo: 27365
+.. date: 9674
+.. nonce: ipkJ_M
+.. section: IDLE
+
+Allow non-ascii in idlelib/NEWS.txt - minimal part for 3.5.2.

Misc/NEWS.d/3.5.3.rst

+.. bpo: 0
+.. date: 9899
+.. no changes: True
+.. nonce: zYPqUK
+.. release date: 2017-01-17
+
+There were no code changes between 3.5.3rc1 and 3.5.3 final.

Misc/NEWS.d/next/Build/005.bpo-29643.4WLIJQ.rst

+Fix ``--enable-optimization`` didn't work.

Misc/NEWS.d/next/Build/006.bpo-23404.PdYVWg.rst

+Don't regenerate generated files based on file modification time anymore:
+the action is now explicit. Replace ``make touch`` with ``make regen-all``.

Misc/NEWS.d/next/Build/007.bpo-29243.WDK4hT.rst

+Prevent unnecessary rebuilding of Python during ``make test``, ``make
+install`` and some other make targets when configured with ``--enable-
+optimizations``.

Misc/NEWS.d/next/C API/014.bpo-29083.tGTjr_.rst

+Fixed the declaration of some public API functions. PyArg_VaParse() and
+PyArg_VaParseTupleAndKeywords() were not available in limited API.
+PyArg_ValidateKeywordArguments(), PyArg_UnpackTuple() and Py_BuildValue()
+were not available in limited API of version < 3.3 when PY_SSIZE_T_CLEAN is
+defined.

Misc/NEWS.d/next/C API/015.bpo-27867.VMCoJU.rst

+Function PySlice_GetIndicesEx() is replaced with a macro if Py_LIMITED_API
+is set to the value between 0x03050400 and 0x03060000 (not including) or
+0x03060100 or higher.

Misc/NEWS.d/next/Core and Builtins/088.bpo-29478.rTQ-qy.rst

+If max_line_length=None is specified while using the Compat32 policy, it is
+no longer ignored.  Patch by Mircea Cosbuc.