[Python-checkins] cpython (3.2): Document json.dump ensure_ascii parameter (#13770)

[eric.araujo]

http://hg.python.org/cpython/rev/33d6da1b1c71
changeset:   74789:33d6da1b1c71
branch:      3.2
user:        Éric Araujo <merwok at netwok.org>
date:        Mon Jan 16 10:09:20 2012 +0100
summary:
  Document json.dump ensure_ascii parameter (#13770)

files:
  Doc/library/json.rst |  4 ++++
  1 files changed, 4 insertions(+), 0 deletions(-)


diff --git a/Doc/library/json.rst b/Doc/library/json.rst
--- a/Doc/library/json.rst
+++ b/Doc/library/json.rst
@@ -125,6 +125,10 @@
    :class:`bytes` objects. Therefore, ``fp.write()`` must support :class:`str`
    input.
 
+   If *ensure_ascii* is ``True`` (the default), the output is guaranteed to
+   have all incoming non-ASCII characters escaped.  If *ensure_ascii* is
+   ``False``, these characters will be output as-is.
+
    If *check_circular* is ``False`` (default: ``True``), then the circular
    reference check for container types will be skipped and a circular reference
    will result in an :exc:`OverflowError` (or worse).

-- 
Repository URL: http://hg.python.org/cpython