From 0d692a0ce5d818c558c97cdd538f8e361eb4405b Mon Sep 17 00:00:00 2001 From: "Gregory P. Smith" Date: Sun, 9 Dec 2018 11:25:04 -0800 Subject: [PATCH] bpo-22005: Document the reality of pickle compatibility. --- 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 5fe49a013bc4c6..100a6a13450868 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`` ^^^^^^^^^^^^^^^^^^^^^^^^