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

git-svn-id: http://code.djangoproject.com/svn/django/trunk@12669 bcc190cf-cafb-0310-a4f2-bffc1f526a37
This commit is contained in:
James Bennett 2010-03-03 08:43:05 +00:00
parent 1f56ed7319
commit cdd95077a6
1 changed files with 7 additions and 0 deletions

View File

@ -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::