Merged revisions 88137 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/branches/py3k
........
r88137 | antoine.pitrou | 2011-01-21 22:37:32 +0100 (ven., 21 janv. 2011) | 3 lines
Fix JSON docs about loads() accepting only str objects, not bytes.
........
diff --git a/Doc/library/json.rst b/Doc/library/json.rst
index a26001d..1e8a87b 100644
--- a/Doc/library/json.rst
+++ b/Doc/library/json.rst
@@ -118,9 +118,8 @@
file-like object).
If *skipkeys* is ``True`` (default: ``False``), then dict keys that are not
- of a basic type (:class:`bytes`, :class:`str`, :class:`int`,
- :class:`float`, :class:`bool`, ``None``) will be skipped instead of raising a
- :exc:`TypeError`.
+ of a basic type (:class:`str`, :class:`int`, :class:`float`, :class:`bool`,
+ ``None``) will be skipped instead of raising a :exc:`TypeError`.
The :mod:`json` module always produces :class:`str` objects, not
:class:`bytes` objects. Therefore, ``fp.write()`` must support :class:`str`
@@ -201,15 +200,11 @@
.. 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:`bytes` or :class:`str` instance containing a JSON
- document) to a Python object.
+ Deserialize *s* (a :class:`str` instance containing a JSON document) to a
+ Python object.
- If *s* is a :class:`bytes` instance and is encoded with an ASCII based encoding
- other than UTF-8 (e.g. latin-1), then an appropriate *encoding* name must be
- specified. Encodings that are not ASCII based (such as UCS-2) are not
- allowed and should be decoded to :class:`str` first.
-
- The other arguments have the same meaning as in :func:`load`.
+ The other arguments have the same meaning as in :func:`load`, except
+ *encoding* which is ignored and deprecated.
Encoders and decoders