From ed73d9e45d96ba47c6c67796d5ddd7b5d98cc96f Mon Sep 17 00:00:00 2001 From: requiredfield Date: Fri, 20 Feb 2015 12:20:18 -0600 Subject: [PATCH] document combination of repeated response headers --- docs/user/quickstart.rst | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/docs/user/quickstart.rst b/docs/user/quickstart.rst index 0878973f..6fd3602e 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 `_: + + > 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 -------