From: requiredfield <requiredfield256@gmail.com>
Date: Fri, 20 Feb 2015 18:20:18 +0000 (-0600)
Subject: document combination of repeated response headers
X-Git-Tag: v2.5.2~3^2
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=ed73d9e45d96ba47c6c67796d5ddd7b5d98cc96f;p=services%2Fpython-requests.git

document combination of repeated response headers
---

diff --git a/docs/user/quickstart.rst b/docs/user/quickstart.rst
index 0878973..6fd3602 100644
--- a/docs/user/quickstart.rst
+++ b/docs/user/quickstart.rst
@@ -347,6 +347,15 @@ So, we can access the headers using any capitalization we want::
     >>> r.headers.get('content-type')
     'application/json'
 
+It is also special in that the server could have sent the same header multiple
+times with different values, but requests combines them so they can be
+represented in the dictionary within a single mapping, as per
+`RFC 7230 <http://tools.ietf.org/html/rfc7230#section-3.2>`_:
+
+    > A recipient MAY combine multiple header fields with the same field name
+    > into one "field-name: field-value" pair, without changing the semantics
+    > of the message, by appending each subsequent field value to the combined
+    > field value in order, separated by a comma.
 
 Cookies
 -------