Document the Response.close() method.

diff --git a/requests/models.py b/requests/models.py
index 667b001..b5b1bd0 100644 (file)
--- a/requests/models.py
+++ b/requests/models.py
@@ -689,4 +689,9 @@ 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.
+
+        *Note: Should not normally need to be called explicitly.*
+        """
         return self.raw.release_conn()