Documenting that json.load may raise a ValueError.

Issue #18680: JSONDecoder should document that it raises a ValueError
  for malformed data

diff --git a/Doc/library/json.rst b/Doc/library/json.rst
index 433f948ed8cd7ffe07e95e05e78d543516bc2d2a..f6520393eb5e0740657e2f868540b9568f41058f 100644 (file)
--- a/Doc/library/json.rst
+++ b/Doc/library/json.rst
@@ -328,6 +328,8 @@ Encoders and Decoders
    those with character codes in the 0-31 range, including ``'\t'`` (tab),
    ``'\n'``, ``'\r'`` and ``'\0'``.
 
+   If the data being deserialized is not a valid JSON document, a
+   :exc:`ValueError` will be raised.
 
    .. method:: decode(s)