From: Ezio Melotti <ezio.melotti@gmail.com>
Date: Fri, 15 Apr 2011 04:37:00 +0000 (+0300)
Subject: #4783: document that is not possible to use json.dump twice on the same stream.
X-Git-Tag: v3.2.1b1~126^2
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=60adf9595592a84c1108ab984d81397c0a5c613d;p=thirdparty%2FPython%2Fcpython.git

#4783: document that is not possible to use json.dump twice on the same stream.
---

diff --git a/Doc/library/json.rst b/Doc/library/json.rst
index 2bf242fff42b..0b42012c9acf 100644
--- a/Doc/library/json.rst
+++ b/Doc/library/json.rst
@@ -156,6 +156,11 @@ Basic Usage
    Serialize *obj* to a JSON formatted :class:`str`.  The arguments have the
    same meaning as in :func:`dump`.
 
+   .. note::
+
+      Unlike :mod:`pickle` and :mod:`marshal`, JSON is not a framed protocol so
+      trying to serialize more objects with repeated calls to :func:`dump` and
+      the same *fp* will result in an invalid JSON file.
 
 .. function:: load(fp, cls=None, object_hook=None, parse_float=None, parse_int=None, parse_constant=None, object_pairs_hook=None, **kw)