clarify RequestReceived CONTINUATION frame behavior

python-hyper · Jan 18, 2025 · 82d97da · 82d97da
1 parent ee4fa16
commit 82d97da
Showing 1 changed file with 7 additions and 3 deletions.
diff --git a/src/h2/events.py b/src/h2/events.py
@@ -23,9 +23,13 @@ class Event:
 
 class RequestReceived(Event):
     """
-    The RequestReceived event is fired whenever request headers are received.
-    This event carries the HTTP headers for the given request and the stream ID
-    of the new stream.
+    The RequestReceived event is fired whenever all of a request's headers
+    are received. This event carries the HTTP headers for the given request
+    and the stream ID of the new stream.
+    
+    In HTTP/2, headers may be sent as a HEADERS frame followed by zero or more
+    CONTINUATION frames with the final frame setting the END_HEADERS flag.
+    This event is fired after the entire sequence is received.
 
     .. versionchanged:: 2.3.0
        Changed the type of ``headers`` to :class:`HeaderTuple