Changeset 613 for draft-ietf-httpbis
- Timestamp:
- 19/07/09 13:10:24 (13 years ago)
- Location:
- draft-ietf-httpbis/latest
- Files:
-
- 2 edited
Legend:
- Unmodified
- Added
- Removed
-
draft-ietf-httpbis/latest/p3-payload.html
r609 r613 478 478 <tr> 479 479 <td class="header left"></td> 480 <td class="header right">July 1 3, 2009</td>480 <td class="header right">July 19, 2009</td> 481 481 </tr> 482 482 </table> … … 810 810 </div> 811 811 <h2 id="rfc.section.2.4"><a href="#rfc.section.2.4">2.4</a> <a id="language.tags" href="#language.tags">Language Tags</a></h2> 812 <p id="rfc.section.2.4.p.1">A language tag identifies a natural language spoken, written, or otherwise conveyed by human beings for communication of information 813 to other human beings. Computer languages are explicitly excluded. HTTP uses language tags within the Accept-Language and 814 Content-Language fields. 815 </p> 816 <p id="rfc.section.2.4.p.2">The syntax and registry of HTTP language tags is the same as that defined by <a href="#RFC1766" id="rfc.xref.RFC1766.1"><cite title="Tags for the Identification of Languages">[RFC1766]</cite></a>. In summary, a language tag is composed of 1 or more parts: A primary language tag and a possibly empty series of subtags: 817 </p> 818 <div id="rfc.figure.u.10"></div><pre class="inline"><span id="rfc.iref.g.10"></span><span id="rfc.iref.g.11"></span><span id="rfc.iref.g.12"></span> <a href="#language.tags" class="smpl">language-tag</a> = <a href="#language.tags" class="smpl">primary-tag</a> *( "-" <a href="#language.tags" class="smpl">subtag</a> ) 819 <a href="#language.tags" class="smpl">primary-tag</a> = 1*8<a href="#notation" class="smpl">ALPHA</a> 820 <a href="#language.tags" class="smpl">subtag</a> = 1*8<a href="#notation" class="smpl">ALPHA</a> 821 </pre><p id="rfc.section.2.4.p.4">White space is not allowed within the tag and all tags are case-insensitive. The name space of language tags is administered 822 by the IANA. Example tags include: 823 </p> 824 <div id="rfc.figure.u.11"></div><pre class="text"> en, en-US, en-cockney, i-cherokee, x-pig-latin 825 </pre><p id="rfc.section.2.4.p.6">where any two-letter primary-tag is an ISO-639 language abbreviation and any two-letter initial subtag is an ISO-3166 country 826 code. (The last three tags above are not registered tags; all but the last are examples of tags which could be registered 827 in future.) 812 <p id="rfc.section.2.4.p.1">A language tag, as defined in <a href="#RFC4646bis" id="rfc.xref.RFC4646bis.1"><cite title="Tags for Identifying Languages">[RFC4646bis]</cite></a>, identifies a natural language spoken, written, or otherwise conveyed by human beings for communication of information to 813 other human beings. Computer languages are explicitly excluded. HTTP uses language tags within the Accept-Language and Content-Language 814 fields. 815 </p> 816 <p id="rfc.section.2.4.p.2">In summary, a language tag is composed of one or more parts: A primary language subtag followed by a possibly empty series 817 of subtags: 818 </p> 819 <div id="rfc.figure.u.10"></div><pre class="inline"><span id="rfc.iref.g.10"></span> <a href="#language.tags" class="smpl">language-tag</a> = <Language-Tag, defined in <a href="#RFC4646bis" id="rfc.xref.RFC4646bis.2"><cite title="Tags for Identifying Languages">[RFC4646bis]</cite></a>, <a href="http://tools.ietf.org/html/draft-ietf-ltru-4646bis-23#section-2.1">Section 2.1</a>> 820 </pre><p id="rfc.section.2.4.p.4">White space is not allowed within the tag and all tags are case-insensitive. The name space of language subtags is administered 821 by the IANA (see <<a href="http://www.iana.org/assignments/language-subtag-registry">http://www.iana.org/assignments/language-subtag-registry</a>>). 822 </p> 823 <div id="rfc.figure.u.11"></div> 824 <p>Example tags include:</p> <pre class="text"> en, en-US, es-419, az-Arab, x-pig-latin, man-Nkoo-GN 825 </pre> <p id="rfc.section.2.4.p.6">See <a href="#RFC4646bis" id="rfc.xref.RFC4646bis.3"><cite title="Tags for Identifying Languages">[RFC4646bis]</cite></a> for further information. 828 826 </p> 829 827 <h1 id="rfc.section.3"><a href="#rfc.section.3">3.</a> <a id="entity" href="#entity">Entity</a></h1> … … 838 836 by the request. 839 837 </p> 840 <div id="rfc.figure.u.12"></div><pre class="inline"><span id="rfc.iref.g.1 3"></span><span id="rfc.iref.g.14"></span> <a href="#entity.header.fields" class="smpl">entity-header</a> = <a href="#header.content-encoding" class="smpl">Content-Encoding</a> ; <a href="#header.content-encoding" id="rfc.xref.header.content-encoding.2" title="Content-Encoding">Section 5.5</a>838 <div id="rfc.figure.u.12"></div><pre class="inline"><span id="rfc.iref.g.11"></span><span id="rfc.iref.g.12"></span> <a href="#entity.header.fields" class="smpl">entity-header</a> = <a href="#header.content-encoding" class="smpl">Content-Encoding</a> ; <a href="#header.content-encoding" id="rfc.xref.header.content-encoding.2" title="Content-Encoding">Section 5.5</a> 841 839 / <a href="#header.content-language" class="smpl">Content-Language</a> ; <a href="#header.content-language" id="rfc.xref.header.content-language.1" title="Content-Language">Section 5.6</a> 842 840 / <a href="#abnf.dependencies" class="smpl">Content-Length</a> ; <a href="#Part1" id="rfc.xref.Part1.11"><cite title="HTTP/1.1, part 1: URIs, Connections, and Message Parsing">[Part1]</cite></a>, <a href="p1-messaging.html#header.content-length" title="Content-Length">Section 8.2</a> … … 855 853 <h2 id="rfc.section.3.2"><a href="#rfc.section.3.2">3.2</a> <a id="entity.body" href="#entity.body">Entity Body</a></h2> 856 854 <p id="rfc.section.3.2.p.1">The entity-body (if any) sent with an HTTP request or response is in a format and encoding defined by the entity-header fields.</p> 857 <div id="rfc.figure.u.13"></div><pre class="inline"><span id="rfc.iref.g.1 5"></span> <a href="#entity.body" class="smpl">entity-body</a> = *<a href="#notation" class="smpl">OCTET</a>855 <div id="rfc.figure.u.13"></div><pre class="inline"><span id="rfc.iref.g.13"></span> <a href="#entity.body" class="smpl">entity-body</a> = *<a href="#notation" class="smpl">OCTET</a> 858 856 </pre><p id="rfc.section.3.2.p.3">An entity-body is only present in a message when a message-body is present, as described in <a href="p1-messaging.html#message.body" title="Message Body">Section 4.3</a> of <a href="#Part1" id="rfc.xref.Part1.12"><cite title="HTTP/1.1, part 1: URIs, Connections, and Message Parsing">[Part1]</cite></a>. The entity-body is obtained from the message-body by decoding any Transfer-Encoding that might have been applied to ensure 859 857 safe and proper transfer of the message. … … 968 966 a request for an in-line image. 969 967 </p> 970 <div id="rfc.figure.u.15"></div><pre class="inline"><span id="rfc.iref.g.1 6"></span><span id="rfc.iref.g.17"></span><span id="rfc.iref.g.18"></span><span id="rfc.iref.g.19"></span><span id="rfc.iref.g.20"></span> <a href="#header.accept" class="smpl">Accept</a> = "Accept" ":" <a href="#core.rules" class="smpl">OWS</a> <a href="#header.accept" class="smpl">Accept-v</a>968 <div id="rfc.figure.u.15"></div><pre class="inline"><span id="rfc.iref.g.14"></span><span id="rfc.iref.g.15"></span><span id="rfc.iref.g.16"></span><span id="rfc.iref.g.17"></span><span id="rfc.iref.g.18"></span> <a href="#header.accept" class="smpl">Accept</a> = "Accept" ":" <a href="#core.rules" class="smpl">OWS</a> <a href="#header.accept" class="smpl">Accept-v</a> 971 969 <a href="#header.accept" class="smpl">Accept-v</a> = #( <a href="#header.accept" class="smpl">media-range</a> [ <a href="#header.accept" class="smpl">accept-params</a> ] ) 972 970 … … 1070 1068 to a server which is capable of representing documents in those character sets. 1071 1069 </p> 1072 <div id="rfc.figure.u.20"></div><pre class="inline"><span id="rfc.iref.g. 21"></span><span id="rfc.iref.g.22"></span> <a href="#header.accept-charset" class="smpl">Accept-Charset</a> = "Accept-Charset" ":" <a href="#core.rules" class="smpl">OWS</a>1070 <div id="rfc.figure.u.20"></div><pre class="inline"><span id="rfc.iref.g.19"></span><span id="rfc.iref.g.20"></span> <a href="#header.accept-charset" class="smpl">Accept-Charset</a> = "Accept-Charset" ":" <a href="#core.rules" class="smpl">OWS</a> 1073 1071 <a href="#header.accept-charset" class="smpl">Accept-Charset-v</a> 1074 1072 <a href="#header.accept-charset" class="smpl">Accept-Charset-v</a> = 1#( ( <a href="#rule.charset" class="smpl">charset</a> / "*" ) … … 1091 1089 <p id="rfc.section.5.3.p.1">The request-header field "Accept-Encoding" is similar to Accept, but restricts the content-codings (<a href="#content.codings" title="Content Codings">Section 2.2</a>) that are acceptable in the response. 1092 1090 </p> 1093 <div id="rfc.figure.u.22"></div><pre class="inline"><span id="rfc.iref.g.2 3"></span><span id="rfc.iref.g.24"></span><span id="rfc.iref.g.25"></span> <a href="#header.accept-encoding" class="smpl">Accept-Encoding</a> = "Accept-Encoding" ":" <a href="#core.rules" class="smpl">OWS</a>1091 <div id="rfc.figure.u.22"></div><pre class="inline"><span id="rfc.iref.g.21"></span><span id="rfc.iref.g.22"></span><span id="rfc.iref.g.23"></span> <a href="#header.accept-encoding" class="smpl">Accept-Encoding</a> = "Accept-Encoding" ":" <a href="#core.rules" class="smpl">OWS</a> 1094 1092 <a href="#header.accept-encoding" class="smpl">Accept-Encoding-v</a> 1095 1093 <a href="#header.accept-encoding" class="smpl">Accept-Encoding-v</a> = … … 1143 1141 as a response to the request. Language tags are defined in <a href="#language.tags" title="Language Tags">Section 2.4</a>. 1144 1142 </p> 1145 <div id="rfc.figure.u.24"></div><pre class="inline"><span id="rfc.iref.g.2 6"></span><span id="rfc.iref.g.27"></span><span id="rfc.iref.g.28"></span> <a href="#header.accept-language" class="smpl">Accept-Language</a> = "Accept-Language" ":" <a href="#core.rules" class="smpl">OWS</a>1143 <div id="rfc.figure.u.24"></div><pre class="inline"><span id="rfc.iref.g.24"></span><span id="rfc.iref.g.25"></span><span id="rfc.iref.g.26"></span> <a href="#header.accept-language" class="smpl">Accept-Language</a> = "Accept-Language" ":" <a href="#core.rules" class="smpl">OWS</a> 1146 1144 <a href="#header.accept-language" class="smpl">Accept-Language-v</a> 1147 1145 <a href="#header.accept-language" class="smpl">Accept-Language-v</a> = … … 1196 1194 to be compressed without losing the identity of its underlying media type. 1197 1195 </p> 1198 <div id="rfc.figure.u.26"></div><pre class="inline"><span id="rfc.iref.g.2 9"></span><span id="rfc.iref.g.30"></span> <a href="#header.content-encoding" class="smpl">Content-Encoding</a> = "Content-Encoding" ":" <a href="#core.rules" class="smpl">OWS</a> <a href="#header.content-encoding" class="smpl">Content-Encoding-v</a>1196 <div id="rfc.figure.u.26"></div><pre class="inline"><span id="rfc.iref.g.27"></span><span id="rfc.iref.g.28"></span> <a href="#header.content-encoding" class="smpl">Content-Encoding</a> = "Content-Encoding" ":" <a href="#core.rules" class="smpl">OWS</a> <a href="#header.content-encoding" class="smpl">Content-Encoding-v</a> 1199 1197 <a href="#header.content-encoding" class="smpl">Content-Encoding-v</a> = 1#<a href="#content.codings" class="smpl">content-coding</a> 1200 1198 </pre><p id="rfc.section.5.5.p.3">Content codings are defined in <a href="#content.codings" title="Content Codings">Section 2.2</a>. An example of its use is … … 1217 1215 Note that this might not be equivalent to all the languages used within the entity-body. 1218 1216 </p> 1219 <div id="rfc.figure.u.28"></div><pre class="inline"><span id="rfc.iref.g. 31"></span><span id="rfc.iref.g.32"></span> <a href="#header.content-language" class="smpl">Content-Language</a> = "Content-Language" ":" <a href="#core.rules" class="smpl">OWS</a> <a href="#header.content-language" class="smpl">Content-Language-v</a>1217 <div id="rfc.figure.u.28"></div><pre class="inline"><span id="rfc.iref.g.29"></span><span id="rfc.iref.g.30"></span> <a href="#header.content-language" class="smpl">Content-Language</a> = "Content-Language" ":" <a href="#core.rules" class="smpl">OWS</a> <a href="#header.content-language" class="smpl">Content-Language-v</a> 1220 1218 <a href="#header.content-language" class="smpl">Content-Language-v</a> = 1#<a href="#language.tags" class="smpl">language-tag</a> 1221 1219 </pre><p id="rfc.section.5.6.p.3">Language tags are defined in <a href="#language.tags" title="Language Tags">Section 2.4</a>. The primary purpose of Content-Language is to allow a user to identify and differentiate entities according to the user's … … 1245 1243 accessed, the server <em class="bcp14">SHOULD</em> provide a Content-Location for the particular variant which is returned. 1246 1244 </p> 1247 <div id="rfc.figure.u.31"></div><pre class="inline"><span id="rfc.iref.g.3 3"></span><span id="rfc.iref.g.34"></span> <a href="#header.content-location" class="smpl">Content-Location</a> = "Content-Location" ":" <a href="#core.rules" class="smpl">OWS</a>1245 <div id="rfc.figure.u.31"></div><pre class="inline"><span id="rfc.iref.g.31"></span><span id="rfc.iref.g.32"></span> <a href="#header.content-location" class="smpl">Content-Location</a> = "Content-Location" ":" <a href="#core.rules" class="smpl">OWS</a> 1248 1246 <a href="#header.content-location" class="smpl">Content-Location-v</a> 1249 1247 <a href="#header.content-location" class="smpl">Content-Location-v</a> = … … 1266 1264 attacks.) 1267 1265 </p> 1268 <div id="rfc.figure.u.32"></div><pre class="inline"><span id="rfc.iref.g.3 5"></span><span id="rfc.iref.g.36"></span> <a href="#header.content-md5" class="smpl">Content-MD5</a> = "Content-MD5" ":" <a href="#core.rules" class="smpl">OWS</a> <a href="#header.content-md5" class="smpl">Content-MD5-v</a>1266 <div id="rfc.figure.u.32"></div><pre class="inline"><span id="rfc.iref.g.33"></span><span id="rfc.iref.g.34"></span> <a href="#header.content-md5" class="smpl">Content-MD5</a> = "Content-MD5" ":" <a href="#core.rules" class="smpl">OWS</a> <a href="#header.content-md5" class="smpl">Content-MD5-v</a> 1269 1267 <a href="#header.content-md5" class="smpl">Content-MD5-v</a> = <base64 of 128 bit MD5 digest as per <a href="#RFC1864" id="rfc.xref.RFC1864.2"><cite title="The Content-MD5 Header Field">[RFC1864]</cite></a>> 1270 1268 </pre><p id="rfc.section.5.8.p.3">The Content-MD5 header field <em class="bcp14">MAY</em> be generated by an origin server or client to function as an integrity check of the entity-body. Only origin servers or clients <em class="bcp14">MAY</em> generate the Content-MD5 header field; proxies and gateways <em class="bcp14">MUST NOT</em> generate it, as this would defeat its value as an end-to-end integrity check. Any recipient of the entity-body, including … … 1303 1301 the HEAD method, the media type that would have been sent had the request been a GET. 1304 1302 </p> 1305 <div id="rfc.figure.u.33"></div><pre class="inline"><span id="rfc.iref.g.3 7"></span><span id="rfc.iref.g.38"></span> <a href="#header.content-type" class="smpl">Content-Type</a> = "Content-Type" ":" <a href="#core.rules" class="smpl">OWS</a> <a href="#header.content-type" class="smpl">Content-Type-v</a>1303 <div id="rfc.figure.u.33"></div><pre class="inline"><span id="rfc.iref.g.35"></span><span id="rfc.iref.g.36"></span> <a href="#header.content-type" class="smpl">Content-Type</a> = "Content-Type" ":" <a href="#core.rules" class="smpl">OWS</a> <a href="#header.content-type" class="smpl">Content-Type-v</a> 1306 1304 <a href="#header.content-type" class="smpl">Content-Type-v</a> = <a href="#media.types" class="smpl">media-type</a> 1307 1305 </pre><p id="rfc.section.5.9.p.3">Media types are defined in <a href="#media.types" title="Media Types">Section 2.3</a>. An example of the field is … … 1471 1469 </tr> 1472 1470 <tr> 1473 <td class="reference"><b id="RFC1766">[RFC1766]</b></td>1474 <td class="top"><a title="UNINETT">Alvestrand, H.</a>, “<a href="http://tools.ietf.org/html/rfc1766">Tags for the Identification of Languages</a>”, RFC 1766, March 1995.1475 </td>1476 </tr>1477 <tr>1478 1471 <td class="reference"><b id="RFC1864">[RFC1864]</b></td> 1479 1472 <td class="top"><a title="Carnegie Mellon University">Myers, J.</a> and <a title="Dover Beach Consulting, Inc.">M. Rose</a>, “<a href="http://tools.ietf.org/html/rfc1864">The Content-MD5 Header Field</a>”, RFC 1864, October 1995. … … 1511 1504 <td class="reference"><b id="RFC2119">[RFC2119]</b></td> 1512 1505 <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 14, RFC 2119, March 1997. 1506 </td> 1507 </tr> 1508 <tr> 1509 <td class="reference"><b id="RFC4646bis">[RFC4646bis]</b></td> 1510 <td class="top"><a title="Lab126">Phillips, A., Ed.</a> and <a title="Google">M. Davis, Ed.</a>, “<a href="http://tools.ietf.org/html/draft-ietf-ltru-4646bis-23">Tags for Identifying Languages</a>”, Internet-Draft draft-ietf-ltru-4646bis-23 (work in progress), June 2009. 1513 1511 </td> 1514 1512 </tr> … … 1631 1629 environments. 1632 1630 </p> 1633 <div id="rfc.figure.u.35"></div><pre class="inline"><span id="rfc.iref.g.3 9"></span><span id="rfc.iref.g.40"></span> <a href="#mime-version" class="smpl">MIME-Version</a> = "MIME-Version" ":" <a href="#core.rules" class="smpl">OWS</a> <a href="#mime-version" class="smpl">MIME-Version-v</a>1631 <div id="rfc.figure.u.35"></div><pre class="inline"><span id="rfc.iref.g.37"></span><span id="rfc.iref.g.38"></span> <a href="#mime-version" class="smpl">MIME-Version</a> = "MIME-Version" ":" <a href="#core.rules" class="smpl">OWS</a> <a href="#mime-version" class="smpl">MIME-Version-v</a> 1634 1632 <a href="#mime-version" class="smpl">MIME-Version-v</a> = 1*<a href="#notation" class="smpl">DIGIT</a> "." 1*<a href="#notation" class="smpl">DIGIT</a> 1635 1633 </pre><p id="rfc.section.A.1.p.3">MIME version "1.0" is the default for use in HTTP/1.1. However, HTTP/1.1 message parsing and semantics are defined by this … … 1689 1687 in <a href="#RFC2183" id="rfc.xref.RFC2183.3"><cite title="Communicating Presentation Information in Internet Messages: The Content-Disposition Header Field">[RFC2183]</cite></a>. 1690 1688 </p> 1691 <div id="rfc.figure.u.36"></div><pre class="inline"><span id="rfc.iref.g. 41"></span><span id="rfc.iref.g.42"></span><span id="rfc.iref.g.43"></span><span id="rfc.iref.g.44"></span><span id="rfc.iref.g.45"></span><span id="rfc.iref.g.46"></span><span id="rfc.iref.g.47"></span> <a href="#content-disposition" class="smpl">content-disposition</a> = "Content-Disposition" ":" <a href="#core.rules" class="smpl">OWS</a>1689 <div id="rfc.figure.u.36"></div><pre class="inline"><span id="rfc.iref.g.39"></span><span id="rfc.iref.g.40"></span><span id="rfc.iref.g.41"></span><span id="rfc.iref.g.42"></span><span id="rfc.iref.g.43"></span><span id="rfc.iref.g.44"></span><span id="rfc.iref.g.45"></span> <a href="#content-disposition" class="smpl">content-disposition</a> = "Content-Disposition" ":" <a href="#core.rules" class="smpl">OWS</a> 1692 1690 <a href="#content-disposition" class="smpl">content-disposition-v</a> 1693 1691 <a href="#content-disposition" class="smpl">content-disposition-v</a> = <a href="#content-disposition" class="smpl">disposition-type</a> … … 1795 1793 1796 1794 <a href="#header.accept-language" class="smpl">language-range</a> = <language-range, defined in [RFC4647], Section 2.1> 1797 <a href="#language.tags" class="smpl">language-tag</a> = primary-tag *( "-" subtag )1795 <a href="#language.tags" class="smpl">language-tag</a> = <Language-Tag, defined in [RFC4646bis], Section 2.1> 1798 1796 1799 1797 <a href="#header.accept" class="smpl">media-range</a> = ( "*/*" / ( type "/*" ) / ( type "/" subtype ) ) *( OWS … … 1804 1802 <a href="#rule.parameter" class="smpl">parameter</a> = attribute "=" value 1805 1803 <a href="#abnf.dependencies" class="smpl">partial-URI</a> = <partial-URI, defined in [Part1], Section 2.1> 1806 <a href="#language.tags" class="smpl">primary-tag</a> = 1*8ALPHA1807 1804 1808 1805 <a href="#core.rules" class="smpl">quoted-string</a> = <quoted-string, defined in [Part1], Section 1.2.2> 1809 1806 <a href="#abnf.dependencies" class="smpl">qvalue</a> = <qvalue, defined in [Part1], Section 3.5> 1810 1807 1811 <a href="#language.tags" class="smpl">subtag</a> = 1*8ALPHA1812 1808 <a href="#media.types" class="smpl">subtype</a> = token 1813 1809 … … 1816 1812 1817 1813 <a href="#rule.parameter" class="smpl">value</a> = token / quoted-string 1818 1819 1820 1814 </pre> <div id="rfc.figure.u.39"></div> 1821 1815 <p>ABNF diagnostics:</p><pre class="inline">; Accept defined but not used … … 1933 1927 </ul> 1934 1928 <h2 id="rfc.section.E.9"><a href="#rfc.section.E.9">E.9</a> <a id="changes.since.07" href="#changes.since.07">Since draft-ietf-httpbis-p3-payload-07</a></h2> 1935 <p id="rfc.section.E.9.p.1">None.</p> 1929 <p id="rfc.section.E.9.p.1">Closed issues: </p> 1930 <ul> 1931 <li> <<a href="http://www3.tools.ietf.org/wg/httpbis/trac/ticket/13">http://www3.tools.ietf.org/wg/httpbis/trac/ticket/13</a>>: "Updated reference for language tags" 1932 </li> 1933 </ul> 1936 1934 <h1 id="rfc.index"><a href="#rfc.index">Index</a></h1> 1937 1935 <p class="noprint"><a href="#rfc.index.A">A</a> <a href="#rfc.index.B">B</a> <a href="#rfc.index.C">C</a> <a href="#rfc.index.D">D</a> <a href="#rfc.index.G">G</a> <a href="#rfc.index.H">H</a> <a href="#rfc.index.I">I</a> <a href="#rfc.index.L">L</a> <a href="#rfc.index.M">M</a> <a href="#rfc.index.P">P</a> <a href="#rfc.index.R">R</a> <a href="#rfc.index.U">U</a> … … 1972 1970 <li class="indline1"><tt>Grammar</tt> 1973 1971 <ul class="ind"> 1974 <li class="indline1"><tt>Accept</tt> <a class="iref" href="#rfc.iref.g.1 6"><b>5.1</b></a></li>1975 <li class="indline1"><tt>Accept-Charset</tt> <a class="iref" href="#rfc.iref.g. 21"><b>5.2</b></a></li>1976 <li class="indline1"><tt>Accept-Charset-v</tt> <a class="iref" href="#rfc.iref.g.2 2"><b>5.2</b></a></li>1977 <li class="indline1"><tt>Accept-Encoding</tt> <a class="iref" href="#rfc.iref.g.2 3"><b>5.3</b></a></li>1978 <li class="indline1"><tt>Accept-Encoding-v</tt> <a class="iref" href="#rfc.iref.g.2 4"><b>5.3</b></a></li>1979 <li class="indline1"><tt>accept-ext</tt> <a class="iref" href="#rfc.iref.g. 20"><b>5.1</b></a></li>1980 <li class="indline1"><tt>Accept-Language</tt> <a class="iref" href="#rfc.iref.g.2 6"><b>5.4</b></a></li>1981 <li class="indline1"><tt>Accept-Language-v</tt> <a class="iref" href="#rfc.iref.g.2 7"><b>5.4</b></a></li>1982 <li class="indline1"><tt>accept-params</tt> <a class="iref" href="#rfc.iref.g.1 9"><b>5.1</b></a></li>1983 <li class="indline1"><tt>Accept-v</tt> <a class="iref" href="#rfc.iref.g.1 7"><b>5.1</b></a></li>1972 <li class="indline1"><tt>Accept</tt> <a class="iref" href="#rfc.iref.g.14"><b>5.1</b></a></li> 1973 <li class="indline1"><tt>Accept-Charset</tt> <a class="iref" href="#rfc.iref.g.19"><b>5.2</b></a></li> 1974 <li class="indline1"><tt>Accept-Charset-v</tt> <a class="iref" href="#rfc.iref.g.20"><b>5.2</b></a></li> 1975 <li class="indline1"><tt>Accept-Encoding</tt> <a class="iref" href="#rfc.iref.g.21"><b>5.3</b></a></li> 1976 <li class="indline1"><tt>Accept-Encoding-v</tt> <a class="iref" href="#rfc.iref.g.22"><b>5.3</b></a></li> 1977 <li class="indline1"><tt>accept-ext</tt> <a class="iref" href="#rfc.iref.g.18"><b>5.1</b></a></li> 1978 <li class="indline1"><tt>Accept-Language</tt> <a class="iref" href="#rfc.iref.g.24"><b>5.4</b></a></li> 1979 <li class="indline1"><tt>Accept-Language-v</tt> <a class="iref" href="#rfc.iref.g.25"><b>5.4</b></a></li> 1980 <li class="indline1"><tt>accept-params</tt> <a class="iref" href="#rfc.iref.g.17"><b>5.1</b></a></li> 1981 <li class="indline1"><tt>Accept-v</tt> <a class="iref" href="#rfc.iref.g.15"><b>5.1</b></a></li> 1984 1982 <li class="indline1"><tt>attribute</tt> <a class="iref" href="#rfc.iref.g.8"><b>2.3</b></a></li> 1985 1983 <li class="indline1"><tt>charset</tt> <a class="iref" href="#rfc.iref.g.1"><b>2.1</b></a></li> 1986 <li class="indline1"><tt>codings</tt> <a class="iref" href="#rfc.iref.g.2 5"><b>5.3</b></a></li>1984 <li class="indline1"><tt>codings</tt> <a class="iref" href="#rfc.iref.g.23"><b>5.3</b></a></li> 1987 1985 <li class="indline1"><tt>content-coding</tt> <a class="iref" href="#rfc.iref.g.2"><b>2.2</b></a></li> 1988 <li class="indline1"><tt>content-disposition</tt> <a class="iref" href="#rfc.iref.g. 41"><b>B.1</b></a></li>1989 <li class="indline1"><tt>content-disposition-v</tt> <a class="iref" href="#rfc.iref.g.4 2"><b>B.1</b></a></li>1990 <li class="indline1"><tt>Content-Encoding</tt> <a class="iref" href="#rfc.iref.g.2 9"><b>5.5</b></a></li>1991 <li class="indline1"><tt>Content-Encoding-v</tt> <a class="iref" href="#rfc.iref.g. 30"><b>5.5</b></a></li>1992 <li class="indline1"><tt>Content-Language</tt> <a class="iref" href="#rfc.iref.g. 31"><b>5.6</b></a></li>1993 <li class="indline1"><tt>Content-Language-v</tt> <a class="iref" href="#rfc.iref.g.3 2"><b>5.6</b></a></li>1994 <li class="indline1"><tt>Content-Location</tt> <a class="iref" href="#rfc.iref.g.3 3"><b>5.7</b></a></li>1995 <li class="indline1"><tt>Content-Location-v</tt> <a class="iref" href="#rfc.iref.g.3 4"><b>5.7</b></a></li>1996 <li class="indline1"><tt>Content-MD5</tt> <a class="iref" href="#rfc.iref.g.3 5"><b>5.8</b></a></li>1997 <li class="indline1"><tt>Content-MD5-v</tt> <a class="iref" href="#rfc.iref.g.3 6"><b>5.8</b></a></li>1998 <li class="indline1"><tt>Content-Type</tt> <a class="iref" href="#rfc.iref.g.3 7"><b>5.9</b></a></li>1999 <li class="indline1"><tt>Content-Type-v</tt> <a class="iref" href="#rfc.iref.g.3 8"><b>5.9</b></a></li>2000 <li class="indline1"><tt>disp-extension-parm</tt> <a class="iref" href="#rfc.iref.g.4 7"><b>B.1</b></a></li>2001 <li class="indline1"><tt>disp-extension-token</tt> <a class="iref" href="#rfc.iref.g.4 6"><b>B.1</b></a></li>2002 <li class="indline1"><tt>disposition-parm</tt> <a class="iref" href="#rfc.iref.g.4 4"><b>B.1</b></a></li>2003 <li class="indline1"><tt>disposition-type</tt> <a class="iref" href="#rfc.iref.g.4 3"><b>B.1</b></a></li>2004 <li class="indline1"><tt>entity-body</tt> <a class="iref" href="#rfc.iref.g.1 5"><b>3.2</b></a></li>2005 <li class="indline1"><tt>entity-header</tt> <a class="iref" href="#rfc.iref.g.1 3"><b>3.1</b></a></li>2006 <li class="indline1"><tt>extension-header</tt> <a class="iref" href="#rfc.iref.g.1 4"><b>3.1</b></a></li>2007 <li class="indline1"><tt>filename-parm</tt> <a class="iref" href="#rfc.iref.g.4 5"><b>B.1</b></a></li>2008 <li class="indline1"><tt>language-range</tt> <a class="iref" href="#rfc.iref.g.2 8"><b>5.4</b></a></li>1986 <li class="indline1"><tt>content-disposition</tt> <a class="iref" href="#rfc.iref.g.39"><b>B.1</b></a></li> 1987 <li class="indline1"><tt>content-disposition-v</tt> <a class="iref" href="#rfc.iref.g.40"><b>B.1</b></a></li> 1988 <li class="indline1"><tt>Content-Encoding</tt> <a class="iref" href="#rfc.iref.g.27"><b>5.5</b></a></li> 1989 <li class="indline1"><tt>Content-Encoding-v</tt> <a class="iref" href="#rfc.iref.g.28"><b>5.5</b></a></li> 1990 <li class="indline1"><tt>Content-Language</tt> <a class="iref" href="#rfc.iref.g.29"><b>5.6</b></a></li> 1991 <li class="indline1"><tt>Content-Language-v</tt> <a class="iref" href="#rfc.iref.g.30"><b>5.6</b></a></li> 1992 <li class="indline1"><tt>Content-Location</tt> <a class="iref" href="#rfc.iref.g.31"><b>5.7</b></a></li> 1993 <li class="indline1"><tt>Content-Location-v</tt> <a class="iref" href="#rfc.iref.g.32"><b>5.7</b></a></li> 1994 <li class="indline1"><tt>Content-MD5</tt> <a class="iref" href="#rfc.iref.g.33"><b>5.8</b></a></li> 1995 <li class="indline1"><tt>Content-MD5-v</tt> <a class="iref" href="#rfc.iref.g.34"><b>5.8</b></a></li> 1996 <li class="indline1"><tt>Content-Type</tt> <a class="iref" href="#rfc.iref.g.35"><b>5.9</b></a></li> 1997 <li class="indline1"><tt>Content-Type-v</tt> <a class="iref" href="#rfc.iref.g.36"><b>5.9</b></a></li> 1998 <li class="indline1"><tt>disp-extension-parm</tt> <a class="iref" href="#rfc.iref.g.45"><b>B.1</b></a></li> 1999 <li class="indline1"><tt>disp-extension-token</tt> <a class="iref" href="#rfc.iref.g.44"><b>B.1</b></a></li> 2000 <li class="indline1"><tt>disposition-parm</tt> <a class="iref" href="#rfc.iref.g.42"><b>B.1</b></a></li> 2001 <li class="indline1"><tt>disposition-type</tt> <a class="iref" href="#rfc.iref.g.41"><b>B.1</b></a></li> 2002 <li class="indline1"><tt>entity-body</tt> <a class="iref" href="#rfc.iref.g.13"><b>3.2</b></a></li> 2003 <li class="indline1"><tt>entity-header</tt> <a class="iref" href="#rfc.iref.g.11"><b>3.1</b></a></li> 2004 <li class="indline1"><tt>extension-header</tt> <a class="iref" href="#rfc.iref.g.12"><b>3.1</b></a></li> 2005 <li class="indline1"><tt>filename-parm</tt> <a class="iref" href="#rfc.iref.g.43"><b>B.1</b></a></li> 2006 <li class="indline1"><tt>language-range</tt> <a class="iref" href="#rfc.iref.g.26"><b>5.4</b></a></li> 2009 2007 <li class="indline1"><tt>language-tag</tt> <a class="iref" href="#rfc.iref.g.10"><b>2.4</b></a></li> 2010 <li class="indline1"><tt>media-range</tt> <a class="iref" href="#rfc.iref.g.1 8"><b>5.1</b></a></li>2008 <li class="indline1"><tt>media-range</tt> <a class="iref" href="#rfc.iref.g.16"><b>5.1</b></a></li> 2011 2009 <li class="indline1"><tt>media-type</tt> <a class="iref" href="#rfc.iref.g.4"><b>2.3</b></a></li> 2012 <li class="indline1"><tt>MIME-Version</tt> <a class="iref" href="#rfc.iref.g.3 9"><b>A.1</b></a></li>2013 <li class="indline1"><tt>MIME-Version-v</tt> <a class="iref" href="#rfc.iref.g. 40"><b>A.1</b></a></li>2010 <li class="indline1"><tt>MIME-Version</tt> <a class="iref" href="#rfc.iref.g.37"><b>A.1</b></a></li> 2011 <li class="indline1"><tt>MIME-Version-v</tt> <a class="iref" href="#rfc.iref.g.38"><b>A.1</b></a></li> 2014 2012 <li class="indline1"><tt>parameter</tt> <a class="iref" href="#rfc.iref.g.7"><b>2.3</b></a></li> 2015 <li class="indline1"><tt>primary-tag</tt> <a class="iref" href="#rfc.iref.g.11"><b>2.4</b></a></li>2016 <li class="indline1"><tt>subtag</tt> <a class="iref" href="#rfc.iref.g.12"><b>2.4</b></a></li>2017 2013 <li class="indline1"><tt>subtype</tt> <a class="iref" href="#rfc.iref.g.6"><b>2.3</b></a></li> 2018 2014 <li class="indline1"><tt>type</tt> <a class="iref" href="#rfc.iref.g.5"><b>2.3</b></a></li> … … 2098 2094 </li> 2099 2095 <li class="indline0"><a id="rfc.index.R" href="#rfc.index.R"><b>R</b></a><ul class="ind"> 2100 <li class="indline1"><em>RFC1766</em> <a class="iref" href="#rfc.xref.RFC1766.1">2.4</a>, <a class="iref" href="#RFC1766"><b>9.1</b></a></li>2101 2096 <li class="indline1"><em>RFC1864</em> <a class="iref" href="#rfc.xref.RFC1864.1">5.8</a>, <a class="iref" href="#rfc.xref.RFC1864.2">5.8</a>, <a class="iref" href="#RFC1864"><b>9.1</b></a></li> 2102 2097 <li class="indline1"><em>RFC1945</em> <a class="iref" href="#RFC1945"><b>9.2</b></a>, <a class="iref" href="#rfc.xref.RFC1945.1">B</a></li> … … 2131 2126 <li class="indline1"><em>RFC3864</em> <a class="iref" href="#rfc.xref.RFC3864.1">6.1</a>, <a class="iref" href="#RFC3864"><b>9.2</b></a></li> 2132 2127 <li class="indline1"><em>RFC4288</em> <a class="iref" href="#rfc.xref.RFC4288.1">2.3</a>, <a class="iref" href="#RFC4288"><b>9.2</b></a></li> 2128 <li class="indline1"><em>RFC4646bis</em> <a class="iref" href="#rfc.xref.RFC4646bis.1">2.4</a>, <a class="iref" href="#rfc.xref.RFC4646bis.2">2.4</a>, <a class="iref" href="#rfc.xref.RFC4646bis.3">2.4</a>, <a class="iref" href="#RFC4646bis"><b>9.1</b></a><ul class="ind"> 2129 <li class="indline1"><em>Section 2.1</em> <a class="iref" href="#rfc.xref.RFC4646bis.2">2.4</a></li> 2130 </ul> 2131 </li> 2133 2132 <li class="indline1"><em>RFC4647</em> <a class="iref" href="#rfc.xref.RFC4647.1">5.4</a>, <a class="iref" href="#rfc.xref.RFC4647.2">5.4</a>, <a class="iref" href="#RFC4647"><b>9.1</b></a><ul class="ind"> 2134 2133 <li class="indline1"><em>Section 2.1</em> <a class="iref" href="#rfc.xref.RFC4647.1">5.4</a></li> -
draft-ietf-httpbis/latest/p3-payload.xml
r609 r613 617 617 <section title="Language Tags" anchor="language.tags"> 618 618 <x:anchor-alias value="language-tag"/> 619 <x:anchor-alias value="primary-tag"/> 620 <x:anchor-alias value="subtag"/> 621 <t> 622 A language tag identifies a natural language spoken, written, or 623 otherwise conveyed by human beings for communication of information 624 to other human beings. Computer languages are explicitly excluded. 625 HTTP uses language tags within the Accept-Language and Content-Language 626 fields. 627 </t> 628 <t> 629 The syntax and registry of HTTP language tags is the same as that 630 defined by <xref target="RFC1766"/>. In summary, a language tag is composed of 1 631 or more parts: A primary language tag and a possibly empty series of 632 subtags: 633 </t> 634 <figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="language-tag"/><iref primary="true" item="Grammar" subitem="primary-tag"/><iref primary="true" item="Grammar" subitem="subtag"/> 635 <x:ref>language-tag</x:ref> = <x:ref>primary-tag</x:ref> *( "-" <x:ref>subtag</x:ref> ) 636 <x:ref>primary-tag</x:ref> = 1*8<x:ref>ALPHA</x:ref> 637 <x:ref>subtag</x:ref> = 1*8<x:ref>ALPHA</x:ref> 619 <t> 620 A language tag, as defined in <xref target="RFC4646bis"/>, identifies a 621 natural language spoken, written, or otherwise conveyed by human beings for 622 communication of information to other human beings. Computer languages are 623 explicitly excluded. HTTP uses language tags within the Accept-Language and 624 Content-Language fields. 625 </t> 626 <t> 627 In summary, a language tag is composed of one or more parts: A primary 628 language subtag followed by a possibly empty series of subtags: 629 </t> 630 <figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="language-tag"/> 631 <x:ref>language-tag</x:ref> = <Language-Tag, defined in <xref target="RFC4646bis" x:sec="2.1"/>> 638 632 </artwork></figure> 639 633 <t> 640 634 White space is not allowed within the tag and all tags are case-insensitive. 641 The name space of language tags is administered by the642 IANA. Example tags include:643 </t> 644 <figure> <artwork type="example">645 en, en-US, en-cockney, i-cherokee, x-pig-latin646 < /artwork></figure>647 <t> 648 where any two-letter primary-tag is an ISO-639 language abbreviation 649 and any two-letter initial subtag is an ISO-3166 country code. (The 650 last three tags above are not registered tags; all but the last are 651 examples of tags which could be registered in future.)635 The name space of language subtags is administered by the IANA (see 636 <eref target="http://www.iana.org/assignments/language-subtag-registry"/>). 637 </t> 638 <figure> 639 <preamble>Example tags include:</preamble> 640 <artwork type="example"> 641 en, en-US, es-419, az-Arab, x-pig-latin, man-Nkoo-GN 642 </artwork> 643 </figure> 644 <t> 645 See <xref target="RFC4646bis"/> for further information. 652 646 </t> 653 647 </section> … … 1942 1936 </reference> 1943 1937 1944 <reference anchor="RFC1766">1945 <front>1946 <title abbrev="Language Tag">Tags for the Identification of Languages</title>1947 <author initials="H." surname="Alvestrand" fullname="Harald Tveit Alvestrand">1948 <organization>UNINETT</organization>1949 <address><email>Harald.T.Alvestrand@uninett.no</email></address>1950 </author>1951 <date month="March" year="1995"/>1952 </front>1953 <seriesInfo name="RFC" value="1766"/>1954 </reference>1955 1956 1938 <reference anchor="RFC1864"> 1957 1939 <front> … … 2138 2120 <seriesInfo name="STD" value="68"/> 2139 2121 <seriesInfo name="RFC" value="5234"/> 2122 </reference> 2123 2124 <reference anchor='RFC4646bis'> 2125 <front> 2126 <title>Tags for Identifying Languages</title> 2127 <author initials='A.' surname='Phillips' fullname='Addison Phillips' role='editor'> 2128 <organization>Lab126</organization> 2129 <address><email>addison@inter-locale.com</email></address> 2130 </author> 2131 <author initials='M.' surname='Davis' fullname='Mark Davis' role='editor'> 2132 <organization>Google</organization> 2133 <address><email>mark.davis@google.com</email></address> 2134 </author> 2135 <date month='June' day='11' year='2009' /> 2136 </front> 2137 <seriesInfo name='Internet-Draft' value='draft-ietf-ltru-4646bis-23' /> 2140 2138 </reference> 2141 2139 … … 2736 2734 2737 2735 <x:ref>language-range</x:ref> = <language-range, defined in [RFC4647], Section 2.1> 2738 <x:ref>language-tag</x:ref> = primary-tag *( "-" subtag )2736 <x:ref>language-tag</x:ref> = <Language-Tag, defined in [RFC4646bis], Section 2.1> 2739 2737 2740 2738 <x:ref>media-range</x:ref> = ( "*/*" / ( type "/*" ) / ( type "/" subtype ) ) *( OWS … … 2745 2743 <x:ref>parameter</x:ref> = attribute "=" value 2746 2744 <x:ref>partial-URI</x:ref> = <partial-URI, defined in [Part1], Section 2.1> 2747 <x:ref>primary-tag</x:ref> = 1*8ALPHA2748 2745 2749 2746 <x:ref>quoted-string</x:ref> = <quoted-string, defined in [Part1], Section 1.2.2> 2750 2747 <x:ref>qvalue</x:ref> = <qvalue, defined in [Part1], Section 3.5> 2751 2748 2752 <x:ref>subtag</x:ref> = 1*8ALPHA2753 2749 <x:ref>subtype</x:ref> = token 2754 2750 … … 2757 2753 2758 2754 <x:ref>value</x:ref> = token / quoted-string 2759 2760 2761 2755 </artwork> 2762 2756 </figure> … … 2979 2973 <section title="Since draft-ietf-httpbis-p3-payload-07" anchor="changes.since.07"> 2980 2974 <t> 2981 None. 2975 Closed issues: 2976 <list style="symbols"> 2977 <t> 2978 <eref target="http://www3.tools.ietf.org/wg/httpbis/trac/ticket/13"/>: 2979 "Updated reference for language tags" 2980 </t> 2981 </list> 2982 2982 </t> 2983 2983 </section>
Note: See TracChangeset
for help on using the changeset viewer.