From f8a3d87a199a54305a0f50e24a00fa253fa43766 Mon Sep 17 00:00:00 2001 From: Jannis Leidel Date: Fri, 17 Jun 2011 15:39:35 +0000 Subject: [PATCH] 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 --- docs/ref/templates/builtins.txt | 8 ++++++++ 1 file changed, 8 insertions(+) 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 & Jerry``. +However, ampersands used in named entities and numeric character references +will not be replaced. For example, if ``value`` is ``Café``, the output +will *not* be ``Café&`` but remain ``Café``. 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