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: v2.7.2rc1~153
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=6033d26118cec11eca0c06af215b5876d72e24c6;p=python

#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 6c84f94241..546a09d69b 100644
--- a/Doc/library/json.rst
+++ b/Doc/library/json.rst
@@ -156,6 +156,11 @@ Basic Usage
    :meth:`default` method to serialize additional types), specify it with the
    *cls* kwarg; otherwise :class:`JSONEncoder` is used.
 
+   .. 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:: dumps(obj[, skipkeys[, ensure_ascii[, check_circular[, allow_nan[, cls[, indent[, separators[, encoding[, default[, **kw]]]]]]]]]])