Commit d156ae06 authored by Tim Graham's avatar Tim Graham
Browse files

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

Backport of 36d0aa43 from stable/1.9.x
parent 8957f8c0
Loading
Loading
Loading
Loading
+13 −0
Original line number Diff line number Diff line
@@ -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
``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
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

+2 −1
Original line number Diff line number Diff line
@@ -162,7 +162,8 @@ Optional arguments

    .. 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``
    The MIME type to use for the resulting document. Defaults to the value of