From: Gregory P. Smith Date: Sun, 9 Dec 2018 19:42:58 +0000 (-0800) Subject: bpo-22005: Document the reality of pickle compatibility. (GH-11054) X-Git-Tag: v3.8.0a1~312 X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=e328753d91379274b699b93decff45de07854617;p=thirdparty%2FPython%2Fcpython.git bpo-22005: Document the reality of pickle compatibility. (GH-11054) --- diff --git a/Doc/library/pickle.rst b/Doc/library/pickle.rst index 5fe49a013bc4..100a6a134508 100644 --- a/Doc/library/pickle.rst +++ b/Doc/library/pickle.rst @@ -71,7 +71,9 @@ The :mod:`pickle` module differs from :mod:`marshal` in several significant ways :file:`.pyc` files, the Python implementers reserve the right to change the serialization format in non-backwards compatible ways should the need arise. The :mod:`pickle` serialization format is guaranteed to be backwards compatible - across Python releases. + across Python releases provided a compatible pickle protocol is chosen and + pickling and unpickling code deals with Python 2 to Python 3 type differences + if your data is crossing that unique breaking change language boundary. Comparison with ``json`` ^^^^^^^^^^^^^^^^^^^^^^^^