From de8825685491ed0e3078cdcef0f7fed7b08796cc Mon Sep 17 00:00:00 2001 From: Tim Graham Date: Thu, 30 Oct 2014 18:34:10 -0400 Subject: [PATCH] [1.6.x] Fixed #23737 -- Recommended the render() shortcut more strongly. Thanks Aymeric Augustin for the report. Backport of f85fcc75e3 from master --- docs/ref/templates/api.txt | 21 ++------------------- 1 file changed, 2 insertions(+), 19 deletions(-) diff --git a/docs/ref/templates/api.txt b/docs/ref/templates/api.txt index 1c3dd4ed39..f483aff5f5 100644 --- a/docs/ref/templates/api.txt +++ b/docs/ref/templates/api.txt @@ -422,26 +422,9 @@ optional, third positional argument, ``processors``. In this example, the shortcut to populate a template with the contents of a dictionary, your template will be passed a ``Context`` instance by default (not a ``RequestContext``). To use a ``RequestContext`` in your template - rendering, pass an optional third argument to - :func:`~django.shortcuts.render_to_response()`: a ``RequestContext`` - instance. Your code might look like this:: - - from django.shortcuts import render_to_response - from django.template import RequestContext - - def some_view(request): - # ... - return render_to_response('my_template.html', - my_data_dictionary, - context_instance=RequestContext(request)) - - Alternatively, use the :meth:`~django.shortcuts.render()` shortcut which is + rendering, use the :meth:`~django.shortcuts.render()` shortcut which is the same as a call to :func:`~django.shortcuts.render_to_response()` with a - context_instance argument that forces the use of a ``RequestContext``. - - Note that the contents of a supplied dictionary (``my_data_dictionary`` - in this example) will take precedence over any variables supplied by - context processors or the ``RequestContext``. + ``context_instance`` argument that forces the use of a ``RequestContext``. Here's what each of the default processors does: