adding clarification to the history API. It was not clear how the history list was...

diff --git a/docs/user/quickstart.rst b/docs/user/quickstart.rst
index d0b20dee3b0f6165ce04aca4d286bc6b7e882d6b..d3e786cbcb7577eb1818f2d059808d7bb000c474 100644 (file)
--- a/docs/user/quickstart.rst
+++ b/docs/user/quickstart.rst
@@ -386,7 +386,7 @@ of the Response object to track redirection. Let's see what Github does::
     [<Response [301]>]
 
 The :class:`Response.history` list contains a list of the
-:class:`Request` objects that were created in order to complete the request.
+:class:`Request` objects that were created in order to complete the request. The list is sorted from the oldest to the most recent request.
 
 If you're using GET or OPTIONS, you can disable redirection handling with the
 ``allow_redirects`` parameter::

diff --git a/requests/models.py b/requests/models.py
index 928cc2cad21c53ec589e5daa9b01d98c00d84ec3..8223f541d9a516dc40fec67f4fcfa3d0af945bb7 100644 (file)
--- a/requests/models.py
+++ b/requests/models.py
@@ -660,7 +660,7 @@ class Response(object):
 
         #: A list of :class:`Response <Response>` objects from
         #: the history of the Request. Any redirect responses will end
-        #: up here.
+        #: up here. The list is sorted from the oldest to the most recent request.
         self.history = []
 
         #: The :class:`Request <Request>` that created the Response.