Fixed #21529 -- Noted that {% url %} encodes its output (refs #13260).

1 files changed, 9 insertions, 3 deletions

diff --git a/docs/ref/templates/builtins.txt b/docs/ref/templates/builtins.txt
index 31f6379b0d..737224794d 100644
--- a/docs/ref/templates/builtins.txt
+++ b/docs/ref/templates/builtins.txt
@@ -1003,9 +1003,15 @@ url
 ^^^
 
 Returns an absolute path reference (a URL without the domain name) matching a
-given view function and optional parameters. This is a way to output links
-without violating the DRY principle by having to hard-code URLs in your
-templates::
+given view function and optional parameters.
+
+.. versionchanged:: 1.6
+
+    Any special characters in the resulting path will be encoded using
+    :func:`~django.utils.encoding.iri_to_uri`.
+
+This is a way to output links without violating the DRY principle by having to
+hard-code URLs in your templates::
 
     {% url 'path.to.some_view' v1 v2 %}