[1.8.x] Fixed #25963 -- Clarified render_to_response() context_instance deprecation.

Backport of 36d0aa4303 from stable/1.9.x
This commit is contained in:
Tim Graham 2015-12-22 10:56:51 -05:00
parent 8957f8c00d
commit d156ae0612
2 changed files with 15 additions and 1 deletions

View File

@ -1571,6 +1571,19 @@ pass a :class:`dict` in the ``context`` parameter instead. If you're passing a
:class:`~django.template.RequestContext`, pass the request separately in the :class:`~django.template.RequestContext`, pass the request separately in the
``request`` parameter. ``request`` parameter.
If you're using ``context_instance=RequestContext(request))`` with
``render_to_response()``, use :func:`django.shortcuts.render`, which always
makes ``RequestContext`` available, instead. For example::
from django.shortcuts import render_to_response
from django.template import RequestContext
render_to_response('template.html', {...}, context_instance=RequestContext(request))
becomes::
from django.shortcuts import render
render(request, 'template.html', {...})
``dirs`` argument of template-finding functions ``dirs`` argument of template-finding functions
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

View File

@ -162,7 +162,8 @@ Optional arguments
.. deprecated:: 1.8 .. deprecated:: 1.8
The ``context_instance`` argument is deprecated. Simply use ``context``. The ``context_instance`` argument is deprecated. Use the :func:`render`
function instead which always makes ``RequestContext`` available.
``content_type`` ``content_type``
The MIME type to use for the resulting document. Defaults to the value of The MIME type to use for the resulting document. Defaults to the value of