summaryrefslogtreecommitdiff
path: root/docs/templates_python.txt
diff options
context:
space:
mode:
Diffstat (limited to 'docs/templates_python.txt')
-rw-r--r--docs/templates_python.txt8
1 files changed, 5 insertions, 3 deletions
diff --git a/docs/templates_python.txt b/docs/templates_python.txt
index 6b37483702..d353abb5bc 100644
--- a/docs/templates_python.txt
+++ b/docs/templates_python.txt
@@ -669,9 +669,11 @@ Notes:
* ``token.contents`` is a string of the raw contents of the tag. In our
example, it's ``'current_time "%Y-%m-%d %I:%M %p"'``.
- * The ``token.split_contents()`` method separates the arguments on spaces,
- whilst keeping quoted strings together. The more straightforward
- ``token.contents.split()`` would be as robust.
+ * The ``token.split_contents()`` method separates the arguments on spaces
+ while keeping quoted strings together. The more straightforward
+ ``token.contents.split()`` wouldn't be as robust, as it would naively
+ split on *all* spaces, including those within quoted strings. It's a good
+ idea to always use ``token.split_contents()``.
* This function is responsible for raising
``django.template.TemplateSyntaxError``, with helpful messages, for