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/p3-payload.xml

    r454 r457  
    3131  <!ENTITY multipart-byteranges     "<xref target='Part5' x:rel='#internet.media.type.multipart.byteranges' xmlns:x='http://purl.org/net/xml2rfc/ext'/>">
    3232  <!ENTITY full-date                "<xref target='Part1' x:rel='#full.date' xmlns:x='http://purl.org/net/xml2rfc/ext'/>">
     33  <!ENTITY qvalue                   "<xref target='Part1' x:rel='#quality.values' xmlns:x='http://purl.org/net/xml2rfc/ext'/>">
    3334  <!ENTITY uri                      "<xref target='Part1' x:rel='#uri' xmlns:x='http://purl.org/net/xml2rfc/ext'/>">
    3435]>
     
    296297  <x:anchor-alias value="message-header"/>
    297298  <x:anchor-alias value="partial-URI"/>
     299  <x:anchor-alias value="qvalue"/>
    298300<t>
    299301  The ABNF rules below are defined in other parts:
     
    304306  <x:ref>message-header</x:ref> = &lt;message-header, defined in &message-headers;&gt;
    305307  <x:ref>partial-URI</x:ref>    = &lt;partial-URI, defined in &uri;&gt;
     308  <x:ref>qvalue</x:ref>         = &lt;qvalue, defined in &qvalue;&gt;
    306309</artwork></figure>
    307310<figure><!--Part4--><artwork type="abnf2616">
     
    601604</t></list></t>
    602605</section>
    603 </section>
    604 
    605 <section title="Quality Values" anchor="quality.values">
    606   <x:anchor-alias value="qvalue"/>
    607 <t>
    608    HTTP content negotiation (<xref target="content.negotiation"/>) uses short "floating point"
    609    numbers to indicate the relative importance ("weight") of various
    610    negotiable parameters.  A weight is normalized to a real number in
    611    the range 0 through 1, where 0 is the minimum and 1 the maximum
    612    value. If a parameter has a quality value of 0, then content with
    613    this parameter is `not acceptable' for the client. HTTP/1.1
    614    applications &MUST-NOT; generate more than three digits after the
    615    decimal point. User configuration of these values &SHOULD; also be
    616    limited in this fashion.
    617 </t>
    618 <figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="qvalue"/>
    619   <x:ref>qvalue</x:ref>         = ( "0" [ "." 0*3<x:ref>DIGIT</x:ref> ] )
    620                  / ( "1" [ "." 0*3("0") ] )
    621 </artwork></figure>
    622 <t>
    623    "Quality values" is a misnomer, since these values merely represent
    624    relative degradation in desired quality.
    625 </t>
    626606</section>
    627607
     
    967947   parameter(s) from the accept-params. Quality factors allow the user
    968948   or user agent to indicate the relative degree of preference for that
    969    media-range, using the qvalue scale from 0 to 1 (<xref target="quality.values"/>). The
     949   media-range, using the qvalue scale from 0 to 1 (&qvalue;). The
    970950   default value is q=1.
    971951  <list><t>
     
    11371117      <t>If the content-coding is one of the content-codings listed in
    11381118         the Accept-Encoding field, then it is acceptable, unless it is
    1139          accompanied by a qvalue of 0. (As defined in <xref target="quality.values"/>, a
     1119         accompanied by a qvalue of 0. (As defined in &qvalue;, a
    11401120         qvalue of 0 means "not acceptable.")</t>
    11411121
     
    26342614</t>
    26352615<t>
    2636    Quality Values of zero should indicate that "I don't want something"
    2637    to allow clients to refuse a representation. (<xref target="quality.values"/>)
    2638 </t>
    2639 <t>
    26402616   The Alternates<iref item="Alternates header" primary="true"/><iref item="Headers" subitem="Alternate" primary="true"/>, Content-Version<iref item="Content-Version header" primary="true"/><iref item="Headers" subitem="Content-Version" primary="true"/>, Derived-From<iref item="Derived-From header" primary="true"/><iref item="Headers" subitem="Derived-From" primary="true"/>, Link<iref item="Link header" primary="true"/><iref item="Headers" subitem="Link" primary="true"/>, URI<iref item="URI header" primary="true"/><iref item="Headers" subitem="URI" primary="true"/>, Public<iref item="Public header" primary="true"/><iref item="Headers" subitem="Public" primary="true"/> and
    26412617   Content-Base<iref item="Content-Base header" primary="true"/><iref item="Headers" subitem="Content-Base" primary="true"/> header fields were defined in previous versions of this
     
    27382714
    27392715<x:ref>quoted-string</x:ref> = &lt;quoted-string, defined in [Part1], Section 1.2.2&gt;
    2740 <x:ref>qvalue</x:ref> = ( "0" [ "." *3DIGIT ] ) / ( "1" [ "." *3"0" ] )
     2716<x:ref>qvalue</x:ref> = &lt;qvalue, defined in [Part1], Section 3.5&gt;
    27412717
    27422718<x:ref>subtag</x:ref> = 1*8ALPHA
     
    29402916  </list>
    29412917</t>
     2918<t>
     2919  Other changes:
     2920  <list style="symbols">
     2921    <t>
     2922      Move definition of quality values into Part 1.
     2923    </t>
     2924  </list>
     2925</t>
    29422926</section>
    29432927
Note: See TracChangeset for help on using the changeset viewer.