From: Evan Allrich Date: Sat, 11 Aug 2018 07:34:02 +0000 (-0500) Subject: bpo-34379: Doc: Move note for json.dump (GH-8730) X-Git-Tag: v3.8.0a1~1218 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=9e840848510d20e644a19c723b803877377d3765;p=thirdparty%2FPython%2Fcpython.git bpo-34379: Doc: Move note for json.dump (GH-8730) --- diff --git a/Doc/library/json.rst b/Doc/library/json.rst index d65fb3f1c33e..8ce493d63995 100644 --- a/Doc/library/json.rst +++ b/Doc/library/json.rst @@ -188,6 +188,11 @@ Basic Usage .. versionchanged:: 3.6 All optional parameters are now :ref:`keyword-only `. + .. note:: + + Unlike :mod:`pickle` and :mod:`marshal`, JSON is not a framed protocol, + so trying to serialize multiple objects with repeated calls to + :func:`dump` using the same *fp* will result in an invalid JSON file. .. function:: dumps(obj, *, skipkeys=False, ensure_ascii=True, \ check_circular=True, allow_nan=True, cls=None, \ @@ -198,12 +203,6 @@ Basic Usage table `. 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 multiple objects with repeated calls to - :func:`dump` using the same *fp* will result in an invalid JSON file. - .. note:: Keys in key/value pairs of JSON are always of the type :class:`str`. When