From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
Date: Sat, 15 Jun 2019 16:02:57 +0000 (-0700)
Subject: bpo-36785: PEP 574 What's New entry (GH-13931)
X-Git-Tag: v3.8.0b2~124
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=298023633fde5cd60926a2923a01d896550cbf84;p=python

bpo-36785: PEP 574 What's New entry (GH-13931)

(cherry picked from commit c879ff247ae1b67a790ff98d2d59145302cd4e4e)

Co-authored-by: Antoine Pitrou <antoine@python.org>
---

diff --git a/Doc/whatsnew/3.8.rst b/Doc/whatsnew/3.8.rst
index 21ad112547..1312a74330 100644
--- a/Doc/whatsnew/3.8.rst
+++ b/Doc/whatsnew/3.8.rst
@@ -54,7 +54,6 @@ For full details, see the :ref:`changelog <changelog>`.
 
    Some notable items not yet covered here:
 
-   * :pep:`574` - Pickle protocol 5 with out-of-band data buffer support
    * :pep:`578` - Runtime audit hooks for potentially sensitive operations
    * ``python -m asyncio`` runs a natively async REPL
    * ...
@@ -261,6 +260,23 @@ See :pep:`590` for a full description.
 (Contributed by Jeroen Demeyer and Mark Shannon in :issue:`36974`.)
 
 
+Pickle protocol 5 with out-of-band data buffers
+-----------------------------------------------
+
+When :mod:`pickle` is used to transfer large data between Python processes
+in order to take advantage of multi-core or multi-machine processing,
+it is important to optimize the transfer by reducing memory copies, and
+possibly by applying custom techniques such as data-dependent compression.
+
+The :mod:`pickle` protocol 5 introduces support for out-of-band buffers
+where :pep:`3118`-compatible data can be transmitted separately from the
+main pickle stream, at the discretion of the communication layer.
+
+See :pep:`574` for a full description.
+
+(Contributed by Antoine Pitrou in :issue:`36785`.)
+
+
 Other Language Changes
 ======================