Better cookie docs on sessions.

diff --git a/requests/sessions.py b/requests/sessions.py
index c24ed5aa4c34190ce7f3c6b00ae5f4b4b7ed8a31..e7c343306a78eb72067e501a5d712a0494f29bcc 100644 (file)
--- a/requests/sessions.py
+++ b/requests/sessions.py
@@ -211,7 +211,10 @@ class Session(SessionRedirectMixin):
         #: Should we trust the environment?
         self.trust_env = True
 
-        # Set up a CookieJar to be used by default
+        #: A CookieJar containing all currently outstanding cookies set on this
+        #: session. By default is a
+        #: :class:`RequestsCookieJar <requests.cookies.RequestsCookieJar>`, but
+        #: may be any other ``CookieJar``.
         self.cookies = cookiejar_from_dict({})
 
         # Default connection adapters.