From e328753d91379274b699b93decff45de07854617 Mon Sep 17 00:00:00 2001 From: "Gregory P. Smith" Date: Sun, 9 Dec 2018 11:42:58 -0800 Subject: bpo-22005: Document the reality of pickle compatibility. (GH-11054) --- Doc/library/pickle.rst | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/Doc/library/pickle.rst b/Doc/library/pickle.rst index 5fe49a0..100a6a1 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`` ^^^^^^^^^^^^^^^^^^^^^^^^ -- cgit v0.12