From cfd5b184fba4f51a6756fecaf4ec4272f3e23bfc Mon Sep 17 00:00:00 2001
From: Malcolm Tredinnick <malcolm.tredinnick@gmail.com>
Date: Sun, 19 Aug 2007 08:50:51 +0000
Subject: [PATCH] Clarified that urlize and urlizetrunc should only be applied
 to plain text. Refs #5202.

git-svn-id: http://code.djangoproject.com/svn/django/trunk@5937 bcc190cf-cafb-0310-a4f2-bffc1f526a37
---
 docs/templates.txt | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/docs/templates.txt b/docs/templates.txt
index 0d53c281d1..53384864ea 100644
--- a/docs/templates.txt
+++ b/docs/templates.txt
@@ -1326,12 +1326,17 @@ urlize
 
 Converts URLs in plain text into clickable links.
 
+Note that if ``urlize`` is applied to text that already contains HTML markup,
+things won't work as expected. Apply this filter only to *plain* text.
+
 urlizetrunc
 ~~~~~~~~~~~
 
 Converts URLs into clickable links, truncating URLs longer than the given
 character limit.
 
+As with urlize_, this filter should only be applied to *plain* text.
+
 **Argument:** Length to truncate URLs to
 
 wordcount