Fixed #11889: Documented the fact that context processors will overwrite pre-existing context variables of the same names.

ubernostrum · ubernostrum · commit cdd95077a6c7 · 2010-03-03T08:43:05.000Z
git-svn-id: http://code.djangoproject.com/svn/django/trunk@12669 bcc190cf-cafb-0310-a4f2-bffc1f526a37
diff --git a/docs/ref/templates/api.txt b/docs/ref/templates/api.txt
@@ -335,6 +335,13 @@ variable to the context and a second processor adds a variable with the same
 name, the second will override the first. The default processors are explained
 below.
 
+.. admonition:: When context processors are applied
+    When you use ``RequestContext``, the variables you supply directly
+    are added first, followed any variables supplied by context
+    processors. This means that a context processor may overwrite a
+    variable you've supplied, so take care to avoid variable names
+    which overlap with those supplied by your context processors.
+
 Also, you can give ``RequestContext`` a list of additional processors, using the
 optional, third positional argument, ``processors``. In this example, the
 ``RequestContext`` instance gets a ``ip_address`` variable::
