[Python-checkins] cpython (3.1): #4783: document that is not possible to use json.dump twice on the same stream.

[ezio.melotti]

http://hg.python.org/cpython/rev/2ec08aa2c566
changeset:   69356:2ec08aa2c566
branch:      3.1
parent:      69351:e7a55e236b8b
user:        Ezio Melotti <ezio.melotti at gmail.com>
date:        Fri Apr 15 07:37:00 2011 +0300
summary:
  #4783: document that is not possible to use json.dump twice on the same stream.

files:
  Doc/library/json.rst |  5 +++++
  1 files changed, 5 insertions(+), 0 deletions(-)


diff --git a/Doc/library/json.rst b/Doc/library/json.rst
--- a/Doc/library/json.rst
+++ b/Doc/library/json.rst
@@ -156,6 +156,11 @@
    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)
 

-- 
Repository URL: http://hg.python.org/cpython