[1.7.x] Direct readers to format_html() in mark_safe() docs.

Backport of 4832c004e88a68b98b976b4f68a1c9fdb4ea3530 from master
2015-01-15 08:24:54 +00:00 · 2015-01-15 08:24:54 +00:00 · 327703c067
commit 327703c067
parent 478546fcef
1 changed files with 3 additions and 0 deletions
--- a/docs/ref/utils.txt
+++ b/docs/ref/utils.txt
@ -790,6 +790,9 @@ appropriate entities.

    Can be called multiple times on a single string.

+    For building up fragments of HTML, you should normally be using
+    :func:`django.utils.html.format_html` instead.
+
    String marked safe will become unsafe again if modified. For example::

        >>> mystr = '<b>Hello World</b>   '