Changeset 457 for draft-ietf-httpbis/latest/p1-messaging.xml
- Timestamp:
- 28/02/09 19:31:30 (13 years ago)
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
draft-ietf-httpbis/latest/p1-messaging.xml
r454 r457 25 25 <!ENTITY entity-body "<xref target='Part3' x:rel='#entity.body' xmlns:x='http://purl.org/net/xml2rfc/ext'/>"> 26 26 <!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'/>">28 27 <!ENTITY header-cache-control "<xref target='Part6' x:rel='#header.cache-control' xmlns:x='http://purl.org/net/xml2rfc/ext'/>"> 29 28 <!ENTITY header-expect "<xref target='Part2' x:rel='#header.expect' xmlns:x='http://purl.org/net/xml2rfc/ext'/>"> … … 31 30 <!ENTITY header-warning "<xref target='Part6' x:rel='#header.warning' xmlns:x='http://purl.org/net/xml2rfc/ext'/>"> 32 31 <!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'/>">34 32 <!ENTITY request-header-fields "<xref target='Part2' x:rel='#request.header.fields' xmlns:x='http://purl.org/net/xml2rfc/ext'/>"> 35 33 <!ENTITY response-header-fields "<xref target='Part2' x:rel='#response.header.fields' xmlns:x='http://purl.org/net/xml2rfc/ext'/>"> … … 474 472 <x:anchor-alias value="request-header"/> 475 473 <x:anchor-alias value="response-header"/> 476 <x:anchor-alias value="accept-params"/>477 474 <x:anchor-alias value="entity-body"/> 478 475 <x:anchor-alias value="entity-header"/> … … 488 485 </artwork></figure> 489 486 <figure><!-- Part3--><artwork type="abnf2616"> 490 <x:ref>accept-params</x:ref> = <accept-params, defined in &header-accept;>491 487 <x:ref>entity-body</x:ref> = <entity-body, defined in &entity-body;> 492 488 <x:ref>entity-header</x:ref> = <entity-header, defined in &entity-header-fields;> … … 1145 1141 the product value). 1146 1142 </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> 1147 1169 </section> 1148 1170 … … 2381 2403 <x:anchor-alias value="TE-v"/> 2382 2404 <x:anchor-alias value="t-codings"/> 2405 <x:anchor-alias value="te-params"/> 2406 <x:anchor-alias value="te-ext"/> 2383 2407 <t> 2384 2408 The request-header field "TE" indicates what extension transfer-codings … … 2389 2413 parameters (as described in <xref target="transfer.codings"/>). 2390 2414 </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"/> 2392 2416 <x:ref>TE</x:ref> = "TE" ":" <x:ref>OWS</x:ref> <x:ref>TE-v</x:ref> 2393 2417 <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> ) ] 2395 2421 </artwork></figure> 2396 2422 <t> … … 2435 2461 <t>If the transfer-coding being tested is one of the transfer-codings 2436 2462 listed in the TE field, then it is acceptable unless it 2437 is accompanied by a qvalue of 0. (As defined in &qvalue;, a2463 is accompanied by a qvalue of 0. (As defined in <xref target="quality.values"/>, a 2438 2464 qvalue of 0 means "not acceptable.")</t> 2439 2465 </x:lt> … … 2448 2474 <t> 2449 2475 If the TE field-value is empty or if no TE field is present, the only 2450 transfer-coding 2476 transfer-coding is "chunked". A message with no transfer-coding is 2451 2477 always acceptable. 2452 2478 </t> … … 4094 4120 </t> 4095 4121 <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> 4096 4126 Transfer-coding had significant problems, particularly with 4097 4127 interactions with chunked encoding. The solution is that transfer-codings … … 4464 4494 4465 4495 <x:ref>absolute-URI</x:ref> = <absolute-URI, defined in [RFC3986], Section 4.3> 4466 <x:ref>accept-params</x:ref> = <accept-params, defined in [Part3], Section 5.1>4467 4496 <x:ref>asctime-date</x:ref> = wkday SP date3 SP time SP 4DIGIT 4468 4497 <x:ref>attribute</x:ref> = token … … 4533 4562 <x:ref>quoted-string</x:ref> = DQUOTE *( qdtext / quoted-pair ) DQUOTE 4534 4563 <x:ref>quoted-text</x:ref> = %x01-09 / %x0B-0C / %x0E-FF 4564 <x:ref>qvalue</x:ref> = ( "0" [ "." *3DIGIT ] ) / ( "1" [ "." *3"0" ] ) 4535 4565 4536 4566 <x:ref>received-by</x:ref> = ( uri-host [ ":" port ] ) / pseudonym … … 4565 4595 <x:ref>start-line</x:ref> = Request-Line / Status-Line 4566 4596 4567 <x:ref>t-codings</x:ref> = "trailers" / ( transfer-extension [ accept-params ] )4597 <x:ref>t-codings</x:ref> = "trailers" / ( transfer-extension [ te-params ] ) 4568 4598 <x:ref>tchar</x:ref> = "!" / "#" / "$" / "%" / "&" / "'" / "*" / "+" / "-" / "." / 4569 4599 "^" / "_" / "`" / "|" / "~" / 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 4570 4602 <x:ref>time</x:ref> = 2DIGIT ":" 2DIGIT ":" 2DIGIT 4571 4603 <x:ref>token</x:ref> = 1*tchar … … 4948 4980 Rewrite introduction; add mostly new Architecture Section. 4949 4981 </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> 4950 4986 </list> 4951 4987 </t>
Note: See TracChangeset
for help on using the changeset viewer.