Ignore:
Timestamp:
Feb 28, 2009, 11:31:30 AM (11 years ago)
Author:
julian.reschke@…
Message:

Editorial change: move definition of quality values from Part 3 to Part 1. In Part 1, make the grammar of the TE request header independent from accept-params, defined in Part 3.

File:
1 edited

Legend:

Unmodified
Added
Removed
  • draft-ietf-httpbis/latest/p1-messaging.xml

    r454 r457  
    2525  <!ENTITY entity-body            "<xref target='Part3' x:rel='#entity.body' xmlns:x='http://purl.org/net/xml2rfc/ext'/>">
    2626  <!ENTITY entity-header-fields   "<xref target='Part3' x:rel='#entity.header.fields' xmlns:x='http://purl.org/net/xml2rfc/ext'/>">
    27   <!ENTITY header-accept          "<xref target='Part3' x:rel='#header.accept' xmlns:x='http://purl.org/net/xml2rfc/ext'/>">
    2827  <!ENTITY header-cache-control   "<xref target='Part6' x:rel='#header.cache-control' xmlns:x='http://purl.org/net/xml2rfc/ext'/>">
    2928  <!ENTITY header-expect          "<xref target='Part2' x:rel='#header.expect' xmlns:x='http://purl.org/net/xml2rfc/ext'/>">
     
    3130  <!ENTITY header-warning         "<xref target='Part6' x:rel='#header.warning' xmlns:x='http://purl.org/net/xml2rfc/ext'/>">
    3231  <!ENTITY idempotent-methods     "<xref target='Part2' x:rel='#idempotent.methods' xmlns:x='http://purl.org/net/xml2rfc/ext'/>">
    33   <!ENTITY qvalue                 "<xref target='Part3' x:rel='#quality.values' xmlns:x='http://purl.org/net/xml2rfc/ext'/>">
    3432  <!ENTITY request-header-fields  "<xref target='Part2' x:rel='#request.header.fields' xmlns:x='http://purl.org/net/xml2rfc/ext'/>">
    3533  <!ENTITY response-header-fields "<xref target='Part2' x:rel='#response.header.fields' xmlns:x='http://purl.org/net/xml2rfc/ext'/>">
     
    474472  <x:anchor-alias value="request-header"/>
    475473  <x:anchor-alias value="response-header"/>
    476   <x:anchor-alias value="accept-params"/>
    477474  <x:anchor-alias value="entity-body"/>
    478475  <x:anchor-alias value="entity-header"/>
     
    488485</artwork></figure>
    489486<figure><!-- Part3--><artwork type="abnf2616">
    490   <x:ref>accept-params</x:ref>   = &lt;accept-params, defined in &header-accept;&gt;
    491487  <x:ref>entity-body</x:ref>     = &lt;entity-body, defined in &entity-body;&gt;
    492488  <x:ref>entity-header</x:ref>   = &lt;entity-header, defined in &entity-header-fields;&gt;
     
    11451141   the product value).
    11461142</t>
     1143</section>
     1144
     1145<section title="Quality Values" anchor="quality.values">
     1146  <x:anchor-alias value="qvalue"/>
     1147<t>
     1148   Both transfer codings (TE request header, <xref target="header.te"/>)
     1149   and content negotiation (&content.negotiation;) use short "floating point"
     1150   numbers to indicate the relative importance ("weight") of various
     1151   negotiable parameters.  A weight is normalized to a real number in
     1152   the range 0 through 1, where 0 is the minimum and 1 the maximum
     1153   value. If a parameter has a quality value of 0, then content with
     1154   this parameter is `not acceptable' for the client. HTTP/1.1
     1155   applications &MUST-NOT; generate more than three digits after the
     1156   decimal point. User configuration of these values &SHOULD; also be
     1157   limited in this fashion.
     1158</t>
     1159<figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="qvalue"/>
     1160  <x:ref>qvalue</x:ref>         = ( "0" [ "." 0*3<x:ref>DIGIT</x:ref> ] )
     1161                 / ( "1" [ "." 0*3("0") ] )
     1162</artwork></figure>
     1163<x:note>
     1164  <t>
     1165     <x:h>Note:</x:h> "Quality values" is a misnomer, since these values merely represent
     1166     relative degradation in desired quality.
     1167  </t>
     1168</x:note>
    11471169</section>
    11481170
     
    23812403  <x:anchor-alias value="TE-v"/>
    23822404  <x:anchor-alias value="t-codings"/>
     2405  <x:anchor-alias value="te-params"/>
     2406  <x:anchor-alias value="te-ext"/>
    23832407<t>
    23842408   The request-header field "TE" indicates what extension transfer-codings
     
    23892413   parameters (as described in <xref target="transfer.codings"/>).
    23902414</t>
    2391 <figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="TE"/><iref primary="true" item="Grammar" subitem="TE-v"/><iref primary="true" item="Grammar" subitem="t-codings"/>
     2415<figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="TE"/><iref primary="true" item="Grammar" subitem="TE-v"/><iref primary="true" item="Grammar" subitem="t-codings"/><iref primary="true" item="Grammar" subitem="te-params"/><iref primary="true" item="Grammar" subitem="te-ext"/>
    23922416  <x:ref>TE</x:ref>        = "TE" ":" <x:ref>OWS</x:ref> <x:ref>TE-v</x:ref>
    23932417  <x:ref>TE-v</x:ref>      = #<x:ref>t-codings</x:ref>
    2394   <x:ref>t-codings</x:ref> = "trailers" / ( <x:ref>transfer-extension</x:ref> [ <x:ref>accept-params</x:ref> ] )
     2418  <x:ref>t-codings</x:ref> = "trailers" / ( <x:ref>transfer-extension</x:ref> [ <x:ref>te-params</x:ref> ] )
     2419  <x:ref>te-params</x:ref> = <x:ref>OWS</x:ref> ";" <x:ref>OWS</x:ref> "q=" <x:ref>qvalue</x:ref> *( <x:ref>te-ext</x:ref> )
     2420  <x:ref>te-ext</x:ref>    = <x:ref>OWS</x:ref> ";" <x:ref>OWS</x:ref> <x:ref>token</x:ref> [ "=" ( <x:ref>token</x:ref> / <x:ref>quoted-string</x:ref> ) ]
    23952421</artwork></figure>
    23962422<t>
     
    24352461      <t>If the transfer-coding being tested is one of the transfer-codings
    24362462         listed in the TE field, then it is acceptable unless it
    2437          is accompanied by a qvalue of 0. (As defined in &qvalue;, a
     2463         is accompanied by a qvalue of 0. (As defined in <xref target="quality.values"/>, a
    24382464         qvalue of 0 means "not acceptable.")</t>
    24392465    </x:lt>
     
    24482474<t>
    24492475   If the TE field-value is empty or if no TE field is present, the only
    2450    transfer-coding  is "chunked". A message with no transfer-coding is
     2476   transfer-coding is "chunked". A message with no transfer-coding is
    24512477   always acceptable.
    24522478</t>
     
    40944120</t>
    40954121<t>
     4122   Quality Values of zero should indicate that "I don't want something"
     4123   to allow clients to refuse a representation. (<xref target="quality.values"/>)
     4124</t>
     4125<t>
    40964126   Transfer-coding had significant problems, particularly with
    40974127   interactions with chunked encoding. The solution is that transfer-codings
     
    44644494
    44654495<x:ref>absolute-URI</x:ref> = &lt;absolute-URI, defined in [RFC3986], Section 4.3&gt;
    4466 <x:ref>accept-params</x:ref> = &lt;accept-params, defined in [Part3], Section 5.1&gt;
    44674496<x:ref>asctime-date</x:ref> = wkday SP date3 SP time SP 4DIGIT
    44684497<x:ref>attribute</x:ref> = token
     
    45334562<x:ref>quoted-string</x:ref> = DQUOTE *( qdtext / quoted-pair ) DQUOTE
    45344563<x:ref>quoted-text</x:ref> = %x01-09 / %x0B-0C / %x0E-FF
     4564<x:ref>qvalue</x:ref> = ( "0" [ "." *3DIGIT ] ) / ( "1" [ "." *3"0" ] )
    45354565
    45364566<x:ref>received-by</x:ref> = ( uri-host [ ":" port ] ) / pseudonym
     
    45654595<x:ref>start-line</x:ref> = Request-Line / Status-Line
    45664596
    4567 <x:ref>t-codings</x:ref> = "trailers" / ( transfer-extension [ accept-params ] )
     4597<x:ref>t-codings</x:ref> = "trailers" / ( transfer-extension [ te-params ] )
    45684598<x:ref>tchar</x:ref> = "!" / "#" / "$" / "%" / "&amp;" / "'" / "*" / "+" / "-" / "." /
    45694599 "^" / "_" / "`" / "|" / "~" / DIGIT / ALPHA
     4600<x:ref>te-ext</x:ref> = OWS ";" OWS token [ "=" ( token / quoted-string ) ]
     4601<x:ref>te-params</x:ref> = OWS ";" OWS "q=" qvalue *te-ext
    45704602<x:ref>time</x:ref> = 2DIGIT ":" 2DIGIT ":" 2DIGIT
    45714603<x:ref>token</x:ref> = 1*tchar
     
    49484980      Rewrite introduction; add mostly new Architecture Section.
    49494981    </t>
     4982    <t>
     4983      Move definition of quality values from Part 3 into Part 1;
     4984      make TE request header grammar independent of accept-params (defined in Part 3).
     4985    </t>
    49504986  </list>
    49514987</t>
Note: See TracChangeset for help on using the changeset viewer.