bpo-17909: Document that json.load can accept a binary IO (GH-7366)

(cherry picked from commit bb6366bd7570ff3b74bc66095540bea78f31504e)

Co-authored-by: Anthony Sottile <asottile@umich.edu>

diff --git a/Doc/library/json.rst b/Doc/library/json.rst
index a92ab82bd39ccdb57eefe50405ad6e5b8277d86a..d6dcd5209928650430247ceeac873df2de6142f8 100644 (file)
--- a/Doc/library/json.rst
+++ b/Doc/library/json.rst
@@ -215,9 +215,9 @@ Basic Usage
 
 .. function:: load(fp, *, cls=None, object_hook=None, parse_float=None, parse_int=None, parse_constant=None, object_pairs_hook=None, **kw)
 
-   Deserialize *fp* (a ``.read()``-supporting :term:`file-like object`
-   containing a JSON document) to a Python object using this :ref:`conversion
-   table <json-to-py-table>`.
+   Deserialize *fp* (a ``.read()``-supporting :term:`text file` or
+   :term:`binary file` containing a JSON document) to a Python object using
+   this :ref:`conversion table <json-to-py-table>`.
 
    *object_hook* is an optional function that will be called with the result of
    any object literal decoded (a :class:`dict`).  The return value of
@@ -264,6 +264,10 @@ Basic Usage
    .. versionchanged:: 3.6
       All optional parameters are now :ref:`keyword-only <keyword-only_parameter>`.
 
+   .. versionchanged:: 3.6
+      *fp* can now be a :term:`binary file`. The input encoding should be
+      UTF-8, UTF-16 or UTF-32.
+
 .. function:: loads(s, *, encoding=None, cls=None, object_hook=None, parse_float=None, parse_int=None, parse_constant=None, object_pairs_hook=None, **kw)
 
    Deserialize *s* (a :class:`str`, :class:`bytes` or :class:`bytearray`