Ignore:
Timestamp:
Mar 30, 2011, 12:22:34 AM (9 years ago)
Author:
julian.reschke@…
Message:

rewrite header field ABNFs to only specify the field value (see #276)

File:
1 edited

Legend:

Unmodified
Added
Removed
  • draft-ietf-httpbis/latest/p3-payload.xml

    r1180 r1234  
    940940  <iref primary="true" item="Header Fields" subitem="Accept" x:for-anchor=""/>
    941941  <x:anchor-alias value="Accept"/>
    942   <x:anchor-alias value="Accept-v"/>
    943942  <x:anchor-alias value="accept-ext"/>
    944943  <x:anchor-alias value="accept-params"/>
     
    950949   types, as in the case of a request for an in-line image.
    951950</t>
    952 <figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="Accept"/><iref primary="true" item="Grammar" subitem="Accept-v"/><iref primary="true" item="Grammar" subitem="media-range"/><iref primary="true" item="Grammar" subitem="accept-params"/><iref primary="true" item="Grammar" subitem="accept-ext"/>
    953   <x:ref>Accept</x:ref>   = "Accept" ":" <x:ref>OWS</x:ref> <x:ref>Accept-v</x:ref>
    954   <x:ref>Accept-v</x:ref> = #( <x:ref>media-range</x:ref> [ <x:ref>accept-params</x:ref> ] )
     951<figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="Accept"/><iref primary="true" item="Grammar" subitem="media-range"/><iref primary="true" item="Grammar" subitem="accept-params"/><iref primary="true" item="Grammar" subitem="accept-ext"/>
     952  <x:ref>Accept</x:ref> = #( <x:ref>media-range</x:ref> [ <x:ref>accept-params</x:ref> ] )
    955953 
    956954  <x:ref>media-range</x:ref>    = ( "*/*"
     
    10681066  <iref primary="true" item="Header Fields" subitem="Accept-Charset" x:for-anchor=""/>
    10691067  <x:anchor-alias value="Accept-Charset"/>
    1070   <x:anchor-alias value="Accept-Charset-v"/>
    10711068<t>
    10721069   The "Accept-Charset" header field can be used by user agents to
     
    10771074   representing documents in those character encodings.
    10781075</t>
    1079 <figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="Accept-Charset"/><iref primary="true" item="Grammar" subitem="Accept-Charset-v"/>
    1080   <x:ref>Accept-Charset</x:ref>   = "Accept-Charset" ":" <x:ref>OWS</x:ref>
    1081           <x:ref>Accept-Charset-v</x:ref>
    1082   <x:ref>Accept-Charset-v</x:ref> = 1#( ( <x:ref>charset</x:ref> / "*" )
     1076<figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="Accept-Charset"/>
     1077  <x:ref>Accept-Charset</x:ref> = 1#( ( <x:ref>charset</x:ref> / "*" )
    10831078                         [ <x:ref>OWS</x:ref> ";" <x:ref>OWS</x:ref> "q=" <x:ref>qvalue</x:ref> ] )
    10841079</artwork></figure>
     
    11141109  <iref primary="true" item="Header Fields" subitem="Accept-Encoding" x:for-anchor=""/>
    11151110  <x:anchor-alias value="Accept-Encoding"/>
    1116   <x:anchor-alias value="Accept-Encoding-v"/>
    11171111  <x:anchor-alias value="codings"/>
    11181112<t>
     
    11211115   are acceptable in the response.
    11221116</t>
    1123 <figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="Accept-Encoding"/><iref primary="true" item="Grammar" subitem="Accept-Encoding-v"/><iref primary="true" item="Grammar" subitem="codings"/>
    1124   <x:ref>Accept-Encoding</x:ref>    = "Accept-Encoding" ":" <x:ref>OWS</x:ref>
    1125                      <x:ref>Accept-Encoding-v</x:ref>
    1126   <x:ref>Accept-Encoding-v</x:ref>  =
    1127                      #( <x:ref>codings</x:ref> [ <x:ref>OWS</x:ref> ";" <x:ref>OWS</x:ref> "q=" <x:ref>qvalue</x:ref> ] )
    1128   <x:ref>codings</x:ref>            = ( <x:ref>content-coding</x:ref> / "*" )
     1117<figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="Accept-Encoding"/><iref primary="true" item="Grammar" subitem="codings"/>
     1118  <x:ref>Accept-Encoding</x:ref>  = #( <x:ref>codings</x:ref> [ <x:ref>OWS</x:ref> ";" <x:ref>OWS</x:ref> "q=" <x:ref>qvalue</x:ref> ] )
     1119  <x:ref>codings</x:ref>          = ( <x:ref>content-coding</x:ref> / "*" )
    11291120</artwork></figure>
    11301121<t>
     
    12041195  <iref primary="true" item="Header Fields" subitem="Accept-Language" x:for-anchor=""/>
    12051196  <x:anchor-alias value="Accept-Language"/>
    1206   <x:anchor-alias value="Accept-Language-v"/>
    12071197  <x:anchor-alias value="language-range"/>
    12081198<t>
     
    12111201   Language tags are defined in <xref target="language.tags"/>.
    12121202</t>
    1213 <figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="Accept-Language"/><iref primary="true" item="Grammar" subitem="Accept-Language-v"/><iref primary="true" item="Grammar" subitem="language-range"/>
    1214   <x:ref>Accept-Language</x:ref>   = "Accept-Language" ":" <x:ref>OWS</x:ref>
    1215                     <x:ref>Accept-Language-v</x:ref>
    1216   <x:ref>Accept-Language-v</x:ref> =
     1203<figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="Accept-Language"/><iref primary="true" item="Grammar" subitem="language-range"/>
     1204  <x:ref>Accept-Language</x:ref> =
    12171205                    1#( <x:ref>language-range</x:ref> [ <x:ref>OWS</x:ref> ";" <x:ref>OWS</x:ref> "q=" <x:ref>qvalue</x:ref> ] )
    1218   <x:ref>language-range</x:ref>    =
     1206  <x:ref>language-range</x:ref>  =
    12191207            &lt;language-range, defined in <xref target="RFC4647" x:fmt="," x:sec="2.1"/>&gt;
    12201208</artwork></figure>
     
    12761264  <iref primary="true" item="Header Fields" subitem="Content-Encoding" x:for-anchor=""/>
    12771265  <x:anchor-alias value="Content-Encoding"/>
    1278   <x:anchor-alias value="Content-Encoding-v"/>
    12791266<t>
    12801267   The "Content-Encoding" header field indicates what content-codings
     
    12851272   media type.
    12861273</t>
    1287 <figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="Content-Encoding"/><iref primary="true" item="Grammar" subitem="Content-Encoding-v"/>
    1288   <x:ref>Content-Encoding</x:ref>   = "Content-Encoding" ":" <x:ref>OWS</x:ref> <x:ref>Content-Encoding-v</x:ref>
    1289   <x:ref>Content-Encoding-v</x:ref> = 1#<x:ref>content-coding</x:ref>
     1274<figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="Content-Encoding"/>
     1275  <x:ref>Content-Encoding</x:ref> = 1#<x:ref>content-coding</x:ref>
    12901276</artwork></figure>
    12911277<t>
     
    13261312  <iref primary="true" item="Header Fields" subitem="Content-Language" x:for-anchor=""/>
    13271313  <x:anchor-alias value="Content-Language"/>
    1328   <x:anchor-alias value="Content-Language-v"/>
    13291314<t>
    13301315   The "Content-Language" header field describes the natural
     
    13321317   not be equivalent to all the languages used within the representation.
    13331318</t>
    1334 <figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="Content-Language"/><iref primary="true" item="Grammar" subitem="Content-Language-v"/>
    1335   <x:ref>Content-Language</x:ref>   = "Content-Language" ":" <x:ref>OWS</x:ref> <x:ref>Content-Language-v</x:ref>
    1336   <x:ref>Content-Language-v</x:ref> = 1#<x:ref>language-tag</x:ref>
     1319<figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="Content-Language"/>
     1320  <x:ref>Content-Language</x:ref> = 1#<x:ref>language-tag</x:ref>
    13371321</artwork></figure>
    13381322<t>
     
    13791363  <iref primary="true" item="Header Fields" subitem="Content-Location" x:for-anchor=""/>
    13801364  <x:anchor-alias value="Content-Location"/>
    1381   <x:anchor-alias value="Content-Location-v"/>
    13821365<t>
    13831366   The "Content-Location" header field supplies a URI that can be used
     
    13871370   same representation that is enclosed as payload in this message.
    13881371</t>
    1389 <figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="Content-Location"/><iref primary="true" item="Grammar" subitem="Content-Location-v"/>
    1390   <x:ref>Content-Location</x:ref>   = "Content-Location" ":" <x:ref>OWS</x:ref>
    1391                     <x:ref>Content-Location-v</x:ref>
    1392   <x:ref>Content-Location-v</x:ref> =
    1393                     <x:ref>absolute-URI</x:ref> / <x:ref>partial-URI</x:ref>
     1372<figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="Content-Location"/>
     1373  <x:ref>Content-Location</x:ref> = <x:ref>absolute-URI</x:ref> / <x:ref>partial-URI</x:ref>
    13941374</artwork></figure>
    13951375<t>
     
    14691449  <iref primary="true" item="Header Fields" subitem="Content-MD5" x:for-anchor=""/>
    14701450  <x:anchor-alias value="Content-MD5"/>
    1471   <x:anchor-alias value="Content-MD5-v"/>
    14721451<t>
    14731452   The "Content-MD5" header field, as defined in <xref target="RFC1864"/>, is
     
    14781457   proof against malicious attacks.
    14791458</t>
    1480 <figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="Content-MD5"/><iref primary="true" item="Grammar" subitem="Content-MD5-v"/>
    1481   <x:ref>Content-MD5</x:ref>   = "Content-MD5" ":" <x:ref>OWS</x:ref> <x:ref>Content-MD5-v</x:ref>
    1482   <x:ref>Content-MD5-v</x:ref> = &lt;base64 of 128 bit MD5 digest as per <xref target="RFC1864"/>&gt;
     1459<figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="Content-MD5"/>
     1460  <x:ref>Content-MD5</x:ref> = &lt;base64 of 128 bit MD5 digest as per <xref target="RFC1864"/>&gt;
    14831461</artwork></figure>
    14841462<t>
     
    15441522  <iref primary="true" item="Header Fields" subitem="Content-Type" x:for-anchor=""/>
    15451523  <x:anchor-alias value="Content-Type"/>
    1546   <x:anchor-alias value="Content-Type-v"/>
    15471524<t>
    15481525   The "Content-Type" header field indicates the media type of the
     
    15501527   that which would have been sent had the request been a GET.
    15511528</t>
    1552 <figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="Content-Type"/><iref primary="true" item="Grammar" subitem="Content-Type-v"/>
    1553   <x:ref>Content-Type</x:ref>   = "Content-Type" ":" <x:ref>OWS</x:ref> <x:ref>Content-Type-v</x:ref>
    1554   <x:ref>Content-Type-v</x:ref> = <x:ref>media-type</x:ref>
     1529<figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="Content-Type"/>
     1530  <x:ref>Content-Type</x:ref> = <x:ref>media-type</x:ref>
    15551531</artwork></figure>
    15561532<t>
     
    24872463  <iref primary="true" item="Header Fields" subitem="MIME-Version" x:for-anchor=""/>
    24882464  <x:anchor-alias value="MIME-Version"/>
    2489   <x:anchor-alias value="MIME-Version-v"/>
    24902465<t>
    24912466   HTTP is not a MIME-compliant protocol. However, HTTP/1.1 messages &MAY;
     
    24972472   possible) when exporting HTTP messages to strict MIME environments.
    24982473</t>
    2499 <figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="MIME-Version"/><iref primary="true" item="Grammar" subitem="MIME-Version-v"/>
    2500   <x:ref>MIME-Version</x:ref>   = "MIME-Version" ":" <x:ref>OWS</x:ref> <x:ref>MIME-Version-v</x:ref>
    2501   <x:ref>MIME-Version-v</x:ref> = 1*<x:ref>DIGIT</x:ref> "." 1*<x:ref>DIGIT</x:ref>
     2474<figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="MIME-Version"/>
     2475  <x:ref>MIME-Version</x:ref> = 1*<x:ref>DIGIT</x:ref> "." 1*<x:ref>DIGIT</x:ref>
    25022476</artwork></figure>
    25032477<t>
     
    26272601</t>
    26282602<t>
     2603  Change ABNF productions for header fields to only define the field value.
     2604  (<xref target="header.fields"/>)
     2605</t>
     2606<t>
    26292607  Remove base URI setting semantics for Content-Location due to poor
    26302608  implementation support, which was caused by too many broken servers emitting
     
    26432621<figure>
    26442622<artwork type="abnf" name="p3-payload.parsed-abnf">
    2645 <x:ref>Accept</x:ref> = "Accept:" OWS Accept-v
    2646 <x:ref>Accept-Charset</x:ref> = "Accept-Charset:" OWS Accept-Charset-v
    2647 <x:ref>Accept-Charset-v</x:ref> = *( "," OWS ) ( charset / "*" ) [ OWS ";" OWS "q="
     2623<x:ref>Accept</x:ref> = [ ( "," / ( media-range [ accept-params ] ) ) *( OWS "," [
     2624 OWS media-range [ accept-params ] ] ) ]
     2625<x:ref>Accept-Charset</x:ref> = *( "," OWS ) ( charset / "*" ) [ OWS ";" OWS "q="
    26482626 qvalue ] *( OWS "," [ OWS ( charset / "*" ) [ OWS ";" OWS "q="
    26492627 qvalue ] ] )
    2650 <x:ref>Accept-Encoding</x:ref> = "Accept-Encoding:" OWS Accept-Encoding-v
    2651 <x:ref>Accept-Encoding-v</x:ref> = [ ( "," / ( codings [ OWS ";" OWS "q=" qvalue ] )
    2652  ) *( OWS "," [ OWS codings [ OWS ";" OWS "q=" qvalue ] ] ) ]
    2653 <x:ref>Accept-Language</x:ref> = "Accept-Language:" OWS Accept-Language-v
    2654 <x:ref>Accept-Language-v</x:ref> = *( "," OWS ) language-range [ OWS ";" OWS "q="
     2628<x:ref>Accept-Encoding</x:ref> = [ ( "," / ( codings [ OWS ";" OWS "q=" qvalue ] ) )
     2629 *( OWS "," [ OWS codings [ OWS ";" OWS "q=" qvalue ] ] ) ]
     2630<x:ref>Accept-Language</x:ref> = *( "," OWS ) language-range [ OWS ";" OWS "q="
    26552631 qvalue ] *( OWS "," [ OWS language-range [ OWS ";" OWS "q=" qvalue ]
    26562632 ] )
    2657 <x:ref>Accept-v</x:ref> = [ ( "," / ( media-range [ accept-params ] ) ) *( OWS "," [
    2658  OWS media-range [ accept-params ] ] ) ]
    2659 
    2660 <x:ref>Content-Encoding</x:ref> = "Content-Encoding:" OWS Content-Encoding-v
    2661 <x:ref>Content-Encoding-v</x:ref> = *( "," OWS ) content-coding *( OWS "," [ OWS
     2633
     2634<x:ref>Content-Encoding</x:ref> = *( "," OWS ) content-coding *( OWS "," [ OWS
    26622635 content-coding ] )
    2663 <x:ref>Content-Language</x:ref> = "Content-Language:" OWS Content-Language-v
    2664 <x:ref>Content-Language-v</x:ref> = *( "," OWS ) language-tag *( OWS "," [ OWS
     2636<x:ref>Content-Language</x:ref> = *( "," OWS ) language-tag *( OWS "," [ OWS
    26652637 language-tag ] )
    2666 <x:ref>Content-Location</x:ref> = "Content-Location:" OWS Content-Location-v
    2667 <x:ref>Content-Location-v</x:ref> = absolute-URI / partial-URI
    2668 <x:ref>Content-MD5</x:ref> = "Content-MD5:" OWS Content-MD5-v
    2669 <x:ref>Content-MD5-v</x:ref> = &lt;base64 of 128 bit MD5 digest as per [RFC1864]&gt;
    2670 <x:ref>Content-Type</x:ref> = "Content-Type:" OWS Content-Type-v
    2671 <x:ref>Content-Type-v</x:ref> = media-type
    2672 
    2673 <x:ref>MIME-Version</x:ref> = "MIME-Version:" OWS MIME-Version-v
    2674 <x:ref>MIME-Version-v</x:ref> = 1*DIGIT "." 1*DIGIT
     2638<x:ref>Content-Location</x:ref> = absolute-URI / partial-URI
     2639<x:ref>Content-MD5</x:ref> = &lt;base64 of 128 bit MD5 digest as per [RFC1864]&gt;
     2640<x:ref>Content-Type</x:ref> = media-type
     2641
     2642<x:ref>MIME-Version</x:ref> = 1*DIGIT "." 1*DIGIT
    26752643
    26762644<x:ref>OWS</x:ref> = &lt;OWS, defined in [Part1], Section 1.2.2&gt;
     
    31053073<section title="Since draft-ietf-httpbis-p3-payload-13" anchor="changes.since.13">
    31063074<t>
    3107   None yet.
     3075  Closed issues:
     3076  <list style="symbols">
     3077    <t>
     3078      <eref target="http://tools.ietf.org/wg/httpbis/trac/ticket/276"/>:
     3079      "untangle ABNFs for header fields"
     3080    </t>
     3081  </list>
    31083082</t>
    31093083</section>
Note: See TracChangeset for help on using the changeset viewer.