Ticket #13876: 13876.2.diff

docs/ref/request-response.txt

@@ -46 +46 @@
     attr:`~HttpRequest.path` can make your code much easier to move between test
     and deployment servers.
 
-    For example, if the ``django.root`` for your application is set to 
+    For example, if the ``django.root`` for your application is set to
     ``"/minfo"``, then ``path`` might be ``"/minfo/music/bands/the_beatles/"``
     and ``path_info`` would be ``"/music/bands/the_beatles/"``.
 
@@ -420 +420 @@
     >>> response.write("<p>Here's the text of the Web page.</p>")
     >>> response.write("<p>Here's another paragraph.</p>")
 
-You can add and delete headers using dictionary syntax::
-
-    >>> response = HttpResponse()
-    >>> response['X-DJANGO'] = "It's the best."
-    >>> del response['X-PHP']
-    >>> response['X-DJANGO']
-    "It's the best."
-
-Note that ``del`` doesn't raise ``KeyError`` if the header doesn't exist.
-
 Passing iterators
 ~~~~~~~~~~~~~~~~~
 
@@ -444 +434 @@
 Setting headers
 ~~~~~~~~~~~~~~~
 
-To set a header in your response, just treat it like a dictionary::
+To set or remove a header in your response, treat it like a dictionary::
 
     >>> response = HttpResponse()
     >>> response['Cache-Control'] = 'no-cache'
+    >>> del response['Cache-Control']
 
+Note that unlike a dictionary, ``del`` doesn't raise ``KeyError`` if the header
+doesn't exist.
+
 .. versionadded:: 1.1
 
 HTTP headers cannot contain newlines. An attempt to set a header containing a