summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--docs/ref/utils.txt11
1 files changed, 11 insertions, 0 deletions
diff --git a/docs/ref/utils.txt b/docs/ref/utils.txt
index 5d234e7883..0ef0a838bf 100644
--- a/docs/ref/utils.txt
+++ b/docs/ref/utils.txt
@@ -746,6 +746,17 @@ appropriate entities.
Can be called multiple times on a single string.
+ String marked safe will become unsafe again if modified. For example::
+
+ >>> mystr = '<b>Hello World</b> '
+ >>> mystr = mark_safe(mystr)
+ >>> type(mystr)
+ <class 'django.utils.safestring.SafeBytes'>
+
+ >>> mystr = mystr.strip() # removing whitespace
+ >>> type(mystr)
+ <type 'str'>
+
.. function:: mark_for_escaping(s)
Explicitly mark a string as requiring HTML escaping upon output. Has no