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

Backport of 4832c00 from master
django · Jan 15, 2015 · 327703c · 327703c
1 parent 478546f
commit 327703c
Showing 1 changed file with 3 additions and 0 deletions.
diff --git 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>   '