From: Éric Araujo <merwok@netwok.org>
Date: Mon, 16 Jan 2012 09:09:20 +0000 (+0100)
Subject: Document json.dump ensure_ascii parameter (#13770)
X-Git-Tag: v3.2.3rc1~90^2~3^2~2
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=6f7aa00c1eb40d9a74e25e6bc3ab7c8efbe8e866;p=python

Document json.dump ensure_ascii parameter (#13770)
---

diff --git a/Doc/library/json.rst b/Doc/library/json.rst
index 4ee17f2395..a791259831 100644
--- a/Doc/library/json.rst
+++ b/Doc/library/json.rst
@@ -125,6 +125,10 @@ Basic Usage
    :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).