Ticket #21529: 21529.diff

docs/ref/templates/builtins.txt

@@ -1003 +1003 @@
 ^^^
 
 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. Any special characters 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 %}