Skip to content

Commit 97300fa

Browse files
Update RFC references for the JSON format from RFC 7159 to RFC 8259
1 parent bfecfcc commit 97300fa

1 file changed

Lines changed: 5 additions & 4 deletions

File tree

Doc/library/json.rst

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@
99
--------------
1010

1111
`JSON (JavaScript Object Notation) <https://json.org>`_, specified by
12-
:rfc:`7159` (which obsoletes :rfc:`4627`) and by
12+
:rfc:`8259` (which obsoletes :rfc:`7159`) and by
1313
`ECMA-404 <https://ecma-international.org/publications-and-standards/standards/ecma-404/>`_,
1414
is a lightweight data interchange format inspired by
1515
`JavaScript <https://en.wikipedia.org/wiki/JavaScript>`_ object literal syntax
@@ -632,7 +632,7 @@ Exceptions
632632
Standard Compliance and Interoperability
633633
----------------------------------------
634634

635-
The JSON format is specified by :rfc:`7159` and by
635+
The JSON format is specified by :rfc:`8259` and by
636636
`ECMA-404 <https://ecma-international.org/publications-and-standards/standards/ecma-404/>`_.
637637
This section details this module's level of compliance with the RFC.
638638
For simplicity, :class:`JSONEncoder` and :class:`JSONDecoder` subclasses, and
@@ -652,8 +652,9 @@ default settings.
652652
Character Encodings
653653
^^^^^^^^^^^^^^^^^^^
654654

655-
The RFC requires that JSON be represented using either UTF-8, UTF-16, or
656-
UTF-32, with UTF-8 being the recommended default for maximum interoperability.
655+
The RFC requires that JSON exchanged between systems that are not part of a
656+
closed ecosystem be encoded using UTF-8 for maximum interoperability. Earlier
657+
specifications of JSON also permitted the use of UTF-16 and UTF-32.
657658

658659
As permitted, though not required, by the RFC, this module's serializer sets
659660
*ensure_ascii=True* by default, thus escaping the output so that the resulting

0 commit comments

Comments
 (0)