hook plans

diff --git a/requests/hooks.py b/requests/hooks.py
index 7e9f23a4a7e049ba43096330eb31833609500df0..272dc07dc527cd50cc7bbd42f77e4892e3008a59 100644 (file)
--- a/requests/hooks.py
+++ b/requests/hooks.py
@@ -5,6 +5,21 @@ requests.hooks
 ~~~~~~~~~~~~~~
 
 This module provides the capabilities for the Requests hooks system.
+
+Available hooks:
+
+``args``:
+    A dictionary of the arguments being sent to Request().
+
+``pre-request``:
+    The Request object, directly before being sent.
+
+``post-request``:
+    The Request object, directly after being sent.
+
+``response``:
+    The response generated from a Request.
+
 """
 
 import warnings