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

Backport of 4832c004e8 from master
2015-01-15 08:24:54 +00:00 · 2015-01-15 08:24:54 +00:00 · b9101fa7a2
parent 79df62f4d2
commit b9101fa7a2
1 changed files with 3 additions and 0 deletions
--- a/docs/ref/utils.txt
+++ b/docs/ref/utils.txt
@ -804,6 +804,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>   '