Skip to content

Commit 50fae75

Browse files
authored
Merge pull request #3301 from kazuho/kazuho/incremental-false-and-extensibility
allow use of ?0 and clarify the possibility to add parameters
2 parents a4ea6de + 686d1ba commit 50fae75

File tree

1 file changed

+14
-3
lines changed

1 file changed

+14
-3
lines changed

draft-ietf-httpbis-incremental.md

Lines changed: 14 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -100,13 +100,20 @@ intermediaries to start forwarding the message downstream before the entire
100100
message is received.
101101

102102
The Incremental header field is defined as a structured field
103-
{{STRUCTURED-FIELDS}} of type Item. There is just one valid value, which is of
104-
type Boolean: "?1".
103+
{{STRUCTURED-FIELDS}} of type Item.
104+
Only Boolean values ({{Section 3.3.6 of STRUCTURED-FIELDS}}) are valid;
105+
a recipient ignores the field if it contains any other type.
105106

106107
~~~
107-
Incremental = ?1
108+
Incremental = sf-boolean
108109
~~~
109110

111+
A true value ("?1") indicates that the sender requests intermediaries to forward
112+
the message incrementally, as described below.
113+
114+
A false value ("?0") indicates the default behavior defined in {{HTTP}}, where
115+
intermediaries might buffer the entire message before forwarding it.
116+
110117
Upon receiving a header section that includes an Incremental header field with a
111118
true value, HTTP intermediaries SHOULD NOT buffer the entire message before
112119
forwarding it. Instead, intermediaries SHOULD transmit the header section
@@ -139,6 +146,10 @@ transmit message contents incrementally in both directions. However, when devel
139146
bidirectional protocols over HTTP, Extended CONNECT {{?RFC8441}}{{?RFC9220}} is
140147
generally more consistent with HTTP's architecture.
141148

149+
This document does not define any parameters for the Incremental header field
150+
value, but future documents might define parameters. Receivers MUST ignore
151+
unknown parameters.
152+
142153

143154
# Security Considerations
144155

0 commit comments

Comments
 (0)