Clarify the change in behavior with a couple of workaround options.

jaraco · jaraco · commit 8f997b5fce58 · 2020-03-08T19:57:14.000-04:00
diff --git a/Doc/library/zipfile.rst b/Doc/library/zipfile.rst
@@ -500,7 +500,7 @@ Path objects are traversable using the ``/`` operator.
    ``pwd`` is the ``pwd`` parameter to
    :meth:`ZipFile.open`.
 
-   .. versionchanged:: 3.9
+   .. versionchanged:: 3.8.3
       Added support for text and binary modes for open. Default
       mode is now text.
 
diff --git a/Misc/NEWS.d/next/Library/2020-02-17-22-38-15.bpo-39667.QuzEHH.rst b/Misc/NEWS.d/next/Library/2020-02-17-22-38-15.bpo-39667.QuzEHH.rst
@@ -1 +1 @@
-Improve pathlib.Path compatibility on zipfile.Path and correct performance degradation as found in zipp 3.0.
+Improve pathlib.Path compatibility on zipfile.Path and correct performance degradation as found in zipp 3.0. This backward-incompatible change alters the default behavior for ``zipfile.Path.open`` to match the open behavior on ``pathlib.Path``. For compatibility across Python 3.8.0-3.8.2 and later versions, consider using ``zipp.Path`` on Python 3.8.2 and earlier. For a quick compatibility workaround, ``zipfile.Path.root.open`` provides the same interface as ``zipfile.Path.open`` on Python 3.8.2.

Original file line number	Diff line number	Diff line change
`@@ -1 +1 @@`
`1`		`-Improve pathlib.Path compatibility on zipfile.Path and correct performance degradation as found in zipp 3.0.`
	`1`	+Improve pathlib.Path compatibility on zipfile.Path and correct performance degradation as found in zipp 3.0. This backward-incompatible change alters the default behavior for ``zipfile.Path.open`` to match the open behavior on ``pathlib.Path``. For compatibility across Python 3.8.0-3.8.2 and later versions, consider using ``zipp.Path`` on Python 3.8.2 and earlier. For a quick compatibility workaround, ``zipfile.Path.root.open`` provides the same interface as ``zipfile.Path.open`` on Python 3.8.2.