Clarify and add detail to tojson docs

Fix some confusing and obsolete prose.
This commit is contained in:
Mark Amery 2018-12-27 22:04:27 +00:00 committed by David Lord
parent 6606f66857
commit 24325ecb69
No known key found for this signature in database
GPG key ID: 7A1C87E3F5BC42A8
2 changed files with 18 additions and 9 deletions

View file

@ -312,10 +312,10 @@ JSON module:
as string.
The :func:`~htmlsafe_dumps` function of this json module is also available
as filter called ``|tojson`` in Jinja2. Note that inside ``script``
tags no escaping must take place, so make sure to disable escaping
with ``|safe`` if you intend to use it inside ``script`` tags unless
you are using Flask 0.10 which implies that:
as a filter called ``|tojson`` in Jinja2. Note that in versions of Flask prior
to Flask 0.10, you must disable escaping with ``|safe`` if you intend to use
``|tojson`` output inside ``script`` tags. In Flask 0.10 and above, this
happens automatically (but it's harmless to include ``|safe`` anyway).
.. sourcecode:: html+jinja