Changeset 303


Ignore:
Timestamp:
04/08/08 10:20:21 (15 years ago)
Author:
julian.reschke@…
Message:

Resolve #113: refer to RFC4647 for definition of language ranges and matching (closes #113).

Location:
draft-ietf-httpbis/latest
Files:
2 edited

Legend:

Unmodified
Added
Removed

  • draft-ietf-httpbis/latest/p3-payload.html

    r301 r303  
    2222  font-style: normal;
    2323}
     24blockquote {
     25  border-style: solid;
     26  border-color: gray;
     27  border-width: 0 0 0 .25em;
     28  font-style: italic;
     29  padding-left: 0.5em;
     30}
    2431body {
    2532  color: black;
    … …  
    238245  text-transform: lowercase;
    239246  font-variant: small-caps;
     247}
     248blockquote > * .bcp14 {
     249  font-style: italic;
    240250}
    241251.comment {
    … …  
    474484         <tr>
    475485            <td class="header left"></td>
    476             <td class="header right">August 1, 2008</td>
     486            <td class="header right">August 4, 2008</td>
    477487         </tr>
    478488      </table>
    … …  
    10861096      <div id="rfc.figure.u.28"></div><pre class="inline"><span id="rfc.iref.g.24"></span><span id="rfc.iref.g.25"></span>  <a href="#header.accept-language" class="smpl">Accept-Language</a> = "Accept-Language" ":"
    10871097                    1#( <a href="#header.accept-language" class="smpl">language-range</a> [ ";" "q" "=" <a href="#quality.values" class="smpl">qvalue</a> ] )
    1088   <a href="#header.accept-language" class="smpl">language-range</a>  = ( ( 1*8<a href="#notation" class="smpl">ALPHA</a> *( "-" 1*8<a href="#notation" class="smpl">ALPHA</a> ) ) | "*" )
    1089 </pre><p id="rfc.section.6.4.p.3">Each language-range <em class="bcp14">MAY</em> be given an associated quality value which represents an estimate of the user's preference for the languages specified by
    1090          that range. The quality value defaults to "q=1". For example,
     1098  <a href="#header.accept-language" class="smpl">language-range</a>  =
     1099            &lt;language-range, defined in <a href="#RFC4647" id="rfc.xref.RFC4647.1"><cite title="Matching of Language Tags">[RFC4647]</cite></a>, <a href="http://tools.ietf.org/html/rfc4647#section-2.1">Section 2.1</a>&gt;
     1100</pre><p id="rfc.section.6.4.p.3">Each language-range can be given an associated quality value which represents an estimate of the user's preference for the
     1101         languages specified by that range. The quality value defaults to "q=1". For example,
    10911102      </p>
    10921103      <div id="rfc.figure.u.29"></div><pre class="text">    Accept-Language: da, en-gb;q=0.8, en;q=0.7
    1093 </pre><p id="rfc.section.6.4.p.5">would mean: "I prefer Danish, but will accept British English and other types of English." A language-range matches a language-tag
    1094          if it exactly equals the tag, or if it exactly equals a prefix of the tag such that the first tag character following the
    1095          prefix is "-". The special range "*", if present in the Accept-Language field, matches every tag not matched by any other
    1096          range present in the Accept-Language field.
     1104</pre><p id="rfc.section.6.4.p.5">would mean: "I prefer Danish, but will accept British English and other types of English."</p>
     1105      <p id="rfc.section.6.4.p.6">For matching, the "Basic Filtering" matching scheme, defined in <a href="http://tools.ietf.org/html/rfc4647#section-3.3.1">Section 3.3.1</a> of <a href="#RFC4647" id="rfc.xref.RFC4647.2"><cite title="Matching of Language Tags">[RFC4647]</cite></a>, is used:
     1106      </p>
     1107      <blockquote id="rfc.section.6.4.p.7" cite="http://tools.ietf.org/html/rfc4647#section-3.3.1">
     1108         <p>A language range matches a particular language tag if, in a case-insensitive comparison, it exactly equals the tag, or if
     1109            it exactly equals a prefix of the tag such that the first character following the prefix is "-".
     1110         </p>
     1111      </blockquote>
     1112      <p id="rfc.section.6.4.p.8">The special range "*", if present in the Accept-Language field, matches every tag not matched by any other range present in
     1113         the Accept-Language field.
    10971114      </p>
    10981115      <dl class="empty">
    … …  
    11021119         </dd>
    11031120      </dl>
    1104       <p id="rfc.section.6.4.p.6">The language quality factor assigned to a language-tag by the Accept-Language field is the quality value of the longest language-range
     1121      <p id="rfc.section.6.4.p.9">The language quality factor assigned to a language-tag by the Accept-Language field is the quality value of the longest language-range
    11051122         in the field that matches the language-tag. If no language-range in the field matches the tag, the language quality factor
    11061123         assigned is 0. If no Accept-Language header is present in the request, the server <em class="bcp14">SHOULD</em> assume that all languages are equally acceptable. If an Accept-Language header is present, then all languages which are assigned
    11071124         a quality factor greater than 0 are acceptable.
    11081125      </p>
    1109       <p id="rfc.section.6.4.p.7">It might be contrary to the privacy expectations of the user to send an Accept-Language header with the complete linguistic
     1126      <p id="rfc.section.6.4.p.10">It might be contrary to the privacy expectations of the user to send an Accept-Language header with the complete linguistic
    11101127         preferences of the user in every request. For a discussion of this issue, see <a href="#privacy.issues.connected.to.accept.headers" title="Privacy Issues Connected to Accept Headers">Section&nbsp;8.1</a>.
    11111128      </p>
    1112       <p id="rfc.section.6.4.p.8">As intelligibility is highly dependent on the individual user, it is recommended that client applications make the choice
     1129      <p id="rfc.section.6.4.p.11">As intelligibility is highly dependent on the individual user, it is recommended that client applications make the choice
    11131130         of linguistic preference available to the user. If the choice is not made available, then the Accept-Language header field <em class="bcp14">MUST NOT</em> be given in the request.
    11141131      </p>
    … …  
    13671384      <h2 id="rfc.references.1"><a href="#rfc.section.10.1" id="rfc.section.10.1">10.1</a> Normative References
    13681385      </h2>
    1369       <table summary="Normative References">                           
     1386      <table summary="Normative References">                             
    13701387         <tr>
    13711388            <td class="reference"><b id="ISO-8859-1">[ISO-8859-1]</b></td>
    … …  
    14411458            <td class="reference"><b id="RFC2119">[RFC2119]</b></td>
    14421459            <td class="top"><a title="Harvard University">Bradner, S.</a>, “<a href="http://tools.ietf.org/html/rfc2119">Key words for use in RFCs to Indicate Requirement Levels</a>”, BCP&nbsp;14, RFC&nbsp;2119, March&nbsp;1997.
     1460            </td>
     1461         </tr>
     1462         <tr>
     1463            <td class="reference"><b id="RFC4647">[RFC4647]</b></td>
     1464            <td class="top"><a title="Yahoo! Inc.">Phillips, A., Ed.</a> and <a title="Google">M. Davis, Ed.</a>, “<a href="http://tools.ietf.org/html/rfc4647">Matching of Language Tags</a>”, BCP&nbsp;47, RFC&nbsp;4647, September&nbsp;2006.
    14431465            </td>
    14441466         </tr>
    … …  
    17021724      <ul>
    17031725         <li> &lt;<a href="http://tools.ietf.org/wg/httpbis/trac/ticket/67">http://tools.ietf.org/wg/httpbis/trac/ticket/67</a>&gt;: "Quoting Charsets"
     1726         </li>
     1727         <li> &lt;<a href="http://tools.ietf.org/wg/httpbis/trac/ticket/113">http://tools.ietf.org/wg/httpbis/trac/ticket/113</a>&gt;: "language tag matching (Accept-Language) vs RFC4647"
    17041728         </li>
    17051729         <li> &lt;<a href="http://tools.ietf.org/wg/httpbis/trac/ticket/121">http://tools.ietf.org/wg/httpbis/trac/ticket/121</a>&gt;: "RFC 1806 has been replaced by RFC2183"
    … …  
    19201944                  <li class="indline1"><em>RFC3864</em>&nbsp;&nbsp;<a class="iref" href="#rfc.xref.RFC3864.1">7.1</a>, <a class="iref" href="#RFC3864"><b>10.2</b></a></li>
    19211945                  <li class="indline1"><em>RFC4288</em>&nbsp;&nbsp;<a class="iref" href="#rfc.xref.RFC4288.1">3.3</a>, <a class="iref" href="#RFC4288"><b>10.2</b></a></li>
     1946                  <li class="indline1"><em>RFC4647</em>&nbsp;&nbsp;<a class="iref" href="#rfc.xref.RFC4647.1">6.4</a>, <a class="iref" href="#rfc.xref.RFC4647.2">6.4</a>, <a class="iref" href="#RFC4647"><b>10.1</b></a><ul class="ind">
     1947                        <li class="indline1"><em>Section 2.1</em>&nbsp;&nbsp;<a class="iref" href="#rfc.xref.RFC4647.1">6.4</a></li>
     1948                        <li class="indline1"><em>Section 3.3.1</em>&nbsp;&nbsp;<a class="iref" href="#rfc.xref.RFC4647.2">6.4</a></li>
     1949                     </ul>
     1950                  </li>
    19221951               </ul>
    19231952            </li>

  • draft-ietf-httpbis/latest/p3-payload.xml

    r301 r303  
    11711171  <x:ref>Accept-Language</x:ref> = "Accept-Language" ":"
    11721172                    1#( <x:ref>language-range</x:ref> [ ";" "q" "=" <x:ref>qvalue</x:ref> ] )
    1173   <x:ref>language-range</x:ref>  = ( ( 1*8<x:ref>ALPHA</x:ref> *( "-" 1*8<x:ref>ALPHA</x:ref> ) ) | "*" )
    1174 </artwork></figure>
    1175 <t>
    1176    Each language-range &MAY; be given an associated quality value which
     1173  <x:ref>language-range</x:ref>  =
     1174            &lt;language-range, defined in <xref target="RFC4647" x:fmt="," x:sec="2.1"/>&gt;
     1175</artwork></figure>
     1176<t>
     1177   Each language-range can be given an associated quality value which
    11771178   represents an estimate of the user's preference for the languages
    11781179   specified by that range. The quality value defaults to "q=1". For
    … …  
    11841185<t>
    11851186   would mean: "I prefer Danish, but will accept British English and
    1186    other types of English." A language-range matches a language-tag if
    1187    it exactly equals the tag, or if it exactly equals a prefix of the
    1188    tag such that the first tag character following the prefix is "-".
     1187   other types of English."
     1188</t>
     1189<t>
     1190   For matching, the "Basic Filtering" matching scheme, defined in
     1191   <xref target="RFC4647" x:sec="3.3.1" x:fmt="of"/>, is used:
     1192</t>
     1193<x:blockquote cite="http://tools.ietf.org/html/rfc4647#section-3.3.1">
     1194  <t>
     1195     A language range matches a
     1196     particular language tag if, in a case-insensitive comparison, it
     1197     exactly equals the tag, or if it exactly equals a prefix of the tag
     1198     such that the first character following the prefix is "-".
     1199  </t>
     1200</x:blockquote>
     1201<t>
    11891202   The special range "*", if present in the Accept-Language field,
    11901203   matches every tag not matched by any other range present in the
    … …  
    20262039</reference>
    20272040
     2041<reference anchor='RFC4647'>
     2042  <front>
     2043    <title>Matching of Language Tags</title>
     2044    <author initials='A.' surname='Phillips' fullname='Addison Phillips' role="editor">
     2045      <organization>Yahoo! Inc.</organization>
     2046      <address><email>addison@inter-locale.com</email></address>
     2047    </author>
     2048    <author initials='M.' surname='Davis' fullname='Mark Davis' role="editor">
     2049      <organization>Google</organization>
     2050      <address><email>mark.davis@macchiato.com</email></address>
     2051    </author>
     2052    <date year='2006' month='September' />
     2053  </front>
     2054  <seriesInfo name='BCP' value='47' />
     2055  <seriesInfo name='RFC' value='4647' />
     2056</reference>
     2057
    20282058</references>
    20292059
    … …  
    26532683    </t>
    26542684    <t>
     2685      <eref target="http://tools.ietf.org/wg/httpbis/trac/ticket/113"/>:
     2686      "language tag matching (Accept-Language) vs RFC4647"
     2687    </t>
     2688    <t>
    26552689      <eref target="http://tools.ietf.org/wg/httpbis/trac/ticket/121"/>:
    26562690      "RFC 1806 has been replaced by RFC2183"
Note: See TracChangeset for help on using the changeset viewer.