diff --git a/Doc/library/json.rst b/Doc/library/json.rst index d65fb3f1c33ec1..8ce493d63995d4 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