summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorJannis Leidel <jannis@leidel.info>2011-06-17 15:39:35 +0000
committerJannis Leidel <jannis@leidel.info>2011-06-17 15:39:35 +0000
commitf8a3d87a199a54305a0f50e24a00fa253fa43766 (patch)
tree4397ff979873fef4b2cac743e317faa6afef3d98 /docs
parent2a122be0fc92f12df16eeac65c9dc48516cf499a (diff)
Fixed #16071 -- Added note to fix_ampersands documentation about its limitations. Many thanks to jerry and Julien Phalip.
git-svn-id: http://code.djangoproject.com/svn/django/trunk@16431 bcc190cf-cafb-0310-a4f2-bffc1f526a37
Diffstat (limited to 'docs')
-rw-r--r--docs/ref/templates/builtins.txt8
1 files changed, 8 insertions, 0 deletions
diff --git a/docs/ref/templates/builtins.txt b/docs/ref/templates/builtins.txt
index 2216b6efef..ed8e234c29 100644
--- a/docs/ref/templates/builtins.txt
+++ b/docs/ref/templates/builtins.txt
@@ -1510,6 +1510,14 @@ For example::
If ``value`` is ``Tom & Jerry``, the output will be ``Tom &amp; Jerry``.
+However, ampersands used in named entities and numeric character references
+will not be replaced. For example, if ``value`` is ``Caf&eacute;``, the output
+will *not* be ``Caf&eacute&amp;`` but remain ``Caf&eacute;``. This means that
+in some edge cases, such as acronyms followed by semicolons, this filter will
+not replace ampersands that need replacing. For example, if ``value`` is
+``Contact the R&D;``, the output will remain unchanged because ``&D;``
+resembles a named entity.
+
.. templatefilter:: floatformat
floatformat