Clearer description of Response.close().

diff --git a/requests/models.py b/requests/models.py
index 7390d1c669523c6e378910d1ea8b67c7f017aaa8..f5afebc890da324a7f51bdafee585e57bac51e42 100644 (file)
--- a/requests/models.py
+++ b/requests/models.py
@@ -791,8 +791,8 @@ class Response(object):
             raise HTTPError(http_error_msg, response=self)
 
     def close(self):
-        """Closes the underlying file descriptor and releases the connection
-        back to the pool.
+        """Releases the connection back to the pool. Once this method has been
+        called the underlying ``raw`` object must not be accessed again.
 
         *Note: Should not normally need to be called explicitly.*
         """