Ticket #1504: templates_python.txt.diff

templates_python.txt

@@ -555 +555 @@
 Django uses the template loaders in order according to the ``TEMPLATE_LOADERS``
 setting. It uses each loader until a loader finds a match.
 
+The ``render_to_response()`` shortcut
+=====================================
+
+Django provides a shortcut, ``django.shortcuts.render_to_response``, for loading a template, filling
+its context, and returning `an HttpResponse object`_. 
+
+**Required arguments:**
+
+    ``template``
+        The full name of a template to use.
+
+**Optional arguments:**
+
+    ``context``
+        A dictionary of values to add to the template
+        context. By default, this is an empty dictionary. If a value in the
+        dictionary is callable, the view will call it just before rendering 
+        the template.
+
+    ``mimetype``
+        The MIME type to use for the resulting document. Defaults
+        to the value of the ``DEFAULT_CONTENT_TYPE`` setting.
+
+**Example:**
+
+The following example renders the template ``myapp/index.html`` with the mimetype ``application/xhtml+xml``::
+
+    from django.shortcuts import render_to_response
+    
+    my_view(request):
+        # View code here
+        return render_to_response("myapp/index.html", {"foo": "bar"}, mimetype="application/xhtml+xml")
+    
+.. _an HttpResponse object: ../request_response/#httpresponse-objects
+
 Extending the template system
 =============================