Movatterモバイル変換


[0]ホーム

URL:


Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

Commitf443d14

Browse files
authored
Merge pull request#487 from httpwg/mnot-448
Talk about field backwards compatibility
2 parentsbc593c2 +1d4422f commitf443d14

File tree

1 file changed

+34
-11
lines changed

1 file changed

+34
-11
lines changed

‎draft-ietf-httpbis-semantics-latest.xml‎

Lines changed: 34 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -9728,9 +9728,32 @@ Content-Type: text/plain
97289728
</section>
97299729
</section>
97309730

9731-
<section title="FieldNameExtensibility" anchor="field-extensibility">
9731+
<section title="Field Extensibility" anchor="field-extensibility">
97329732
<x:anchor-alias value="header.extensibility"/>
97339733

9734+
<t>
9735+
HTTP's most widely used extensibility point is the definition of new header and
9736+
trailer fields.
9737+
</t>
9738+
<t>
9739+
New fields can be defined such that, when they are understood by a
9740+
recipient, they override or enhance the interpretation of previously
9741+
defined fields, define preconditions on request evaluation, or
9742+
refine the meaning of responses.
9743+
</t>
9744+
<t>
9745+
However, defining a field doesn't guarantee its deployment or recognition
9746+
by recipients. Most fields are designed with the expectation that a recipient
9747+
can safely ignore (but forward downstream) any field not recognized.
9748+
In other cases, the sender's ability to understand a given field might be
9749+
indicated by its prior communication, perhaps in the protocol version
9750+
or fields that it sent in prior messages, or its use of a specific media type.
9751+
Likewise, direct inspection of support might be possible through an
9752+
OPTIONS request or by interacting with a defined well-known URI
9753+
<xref target="RFC8615"/> if such inspection is defined along with
9754+
the field being introduced.
9755+
</t>
9756+
97349757
<section title="Field Name Registry" anchor="field-name.registry">
97359758
<x:anchor-alias value="header.name.registry"/>
97369759
<t>
@@ -9809,16 +9832,6 @@ Content-Type: text/plain
98099832
</section>
98109833

98119834
<section title="Considerations for New Field Names" anchor="considerations.for.new.field.names">
9812-
<t>
9813-
There is no limit on the introduction of new field names, each presumably
9814-
defining new semantics.
9815-
</t>
9816-
<t>
9817-
New fields can be defined such that, when they are understood by a
9818-
recipient, they might override or enhance the interpretation of previously
9819-
defined fields, define preconditions on request evaluation, or
9820-
refine the meaning of responses.
9821-
</t>
98229835
<t>
98239836
Authors of specifications defining new fields are advised to choose a short
98249837
but descriptive field name. Short names avoid needless data transmission;
@@ -12540,6 +12553,15 @@ Content-Type: text/plain
1254012553
<seriesInfo name="RFC" value="8336"/>
1254112554
</reference>
1254212555

12556+
<reference anchor="RFC8615">
12557+
<front>
12558+
<title>Well-Known Uniform Resource Identifiers (URIs)</title>
12559+
<author initials="M." surname="Nottingham" fullname="M. Nottingham"/>
12560+
<date year="2019" month="May"/>
12561+
</front>
12562+
<seriesInfo name="RFC" value="8615"/>
12563+
</reference>
12564+
1254312565
<reference anchor="HTTP3">
1254412566
<front>
1254512567
<title>Hypertext Transfer Protocol Version 3 (HTTP/3)</title>
@@ -13439,6 +13461,7 @@ transfer-coding = &lt;transfer-coding, see <xref target="Messaging" x:fmt="," x:
1343913461

1344013462
<section title="Since draft-ietf-httpbis-semantics-12" anchor="changes.since.12">
1344113463
<ul x:when-empty="None yet.">
13464+
<li>In <xref target="field-extensibility"/>, explain why new fields need to be backwards-compatible (<eref target="https://github.com/httpwg/http-core/issues/448"/>)</li>
1344213465
<li>In <xref target="field-order"/>, constrain field combination to be within a section (<eref target="https://github.com/httpwg/http-core/issues/454"/>)</li>
1344313466
<li>In <xref target="http.date"/>, mention that caching relaxes date sensitivity (<eref target="https://github.com/httpwg/http-core/issues/473"/>)</li>
1344413467
<li>In <xref target="field.name.registration"/>, moved "*" field registration into main table (<eref target="https://github.com/httpwg/http-core/issues/476"/>)</li>

0 commit comments

Comments
 (0)

[8]ページ先頭

©2009-2025 Movatter.jp