Changeset 1860 for draft-ietf-httpbis/latest/p6-cache.xml

Timestamp:

03/09/12 23:03:33 (10 years ago)

Author:

fielding@…

Message:

(editorial) move Vary to p2 because it is generated by origin servers and not limited to caching

File:

• draft-ietf-httpbis/latest/p6-cache.xml (modified) (8 diffs)

draft-ietf-httpbis/latest/p6-cache.xml

@@ -33 +33 @@
   <!ENTITY header-connection           "<xref target='Part1' x:rel='#header.connection' xmlns:x='http://purl.org/net/xml2rfc/ext'/>">
   <!ENTITY header-date                 "<xref target='Part2' x:rel='#header.date' xmlns:x='http://purl.org/net/xml2rfc/ext'/>">
+  <!ENTITY header-last-modified        "<xref target='Part4' x:rel='#header.last-modified' xmlns:x='http://purl.org/net/xml2rfc/ext'/>">
+  <!ENTITY header-vary                 "<xref target='Part2' x:rel='#header.vary' xmlns:x='http://purl.org/net/xml2rfc/ext'/>">
   <!ENTITY header-via                  "<xref target='Part1' x:rel='#header.via' xmlns:x='http://purl.org/net/xml2rfc/ext'/>">
-  <!ENTITY header-last-modified        "<xref target='Part4' x:rel='#header.last-modified' xmlns:x='http://purl.org/net/xml2rfc/ext'/>">
   <!ENTITY header-fields               "<xref target='Part1' x:rel='#header.fields' xmlns:x='http://purl.org/net/xml2rfc/ext'/>">
   <!ENTITY safe-methods                "<xref target='Part2' x:rel='#safe.methods' xmlns:x='http://purl.org/net/xml2rfc/ext'/>">
@@ -977 +978 @@
 <t>
    When a cache receives a request that can be satisfied by a stored response
-   that has a <x:ref>Vary</x:ref> header field (<xref target="header.vary"/>),
+   that has a <x:ref>Vary</x:ref> header field (&header-vary;),
    it &MUST-NOT; use that response unless all of the selecting header fields
    nominated by the Vary header field match in both the original request
@@ -1767 +1768 @@
    </t>
 </x:note>
-</section>
-
-<section anchor="header.vary" title="Vary">
-   <iref item="Vary header field" primary="true" x:for-anchor="" />
-   <iref item="Header Fields" primary="true" subitem="Vary" x:for-anchor="" />
-   <x:anchor-alias value="Vary"/>
-<t>
-   The "Vary" header field conveys the set of header fields
-   that were used to select the representation.
-</t>
-<t>
-   Caches use this information, in part, to determine whether a stored
-   response can be used to satisfy a given request; see <xref
-   target="caching.negotiated.responses" />.
-</t>
-<t>
-   In uncacheable or stale responses, the Vary field value advises the user
-   agent about the criteria that were used to select the representation.
-</t>
-<figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="Vary"/>
-  <x:ref>Vary</x:ref> = "*" / 1#<x:ref>field-name</x:ref>
-</artwork></figure>
-<t>
-   The set of header fields named by the Vary field value is known as the
-   selecting header fields.
-</t>
-<t>
-   A server &SHOULD; include a Vary header field with any cacheable response
-   that is subject to proactive negotiation. Doing so allows a cache to
-   properly interpret future requests on that resource and informs the user
-   agent about the presence of negotiation on that resource. A server &MAY;
-   include a Vary header field with a non-cacheable response that is subject
-   to proactive negotiation, since this might provide the user agent with
-   useful information about the dimensions over which the response varies at
-   the time of the response.
-</t>
-<t>
-   A Vary field value of "*" signals that unspecified parameters not limited
-   to the header fields (e.g., the network address of the client), play a
-   role in the selection of the response representation; therefore, a cache
-   cannot determine whether this response is appropriate. A proxy &MUST-NOT;
-   generate the "*" value.
-</t>
-<t>
-   The field-names given are not limited to the set of standard header
-   fields defined by this specification. Field names are case-insensitive.
-</t>
 </section>
 
@@ -2191 +2145 @@
       <xref target="header.pragma"/>
    </c>
-   <c>Vary</c>
-   <c>http</c>
-   <c>standard</c>
-   <c>
-      <xref target="header.vary"/>
-   </c>
    <c>Warning</c>
    <c>http</c>
@@ -2293 +2241 @@
       <x:defines>Date</x:defines>
       <x:defines>Location</x:defines>
+      <x:defines>Vary</x:defines>
     </x:source>
   </reference>
@@ -2595 +2544 @@
 <x:ref>Expires</x:ref> = HTTP-date
 
-<x:ref>HTTP-date</x:ref> = &lt;HTTP-date, defined in [Part2], Section 6.1&gt;
+<x:ref>HTTP-date</x:ref> = &lt;HTTP-date, defined in [Part2], Section 9.1&gt;
 
 <x:ref>OWS</x:ref> = &lt;OWS, defined in [Part1], Section 3.2.1&gt;
@@ -2601 +2550 @@
 <x:ref>Pragma</x:ref> = *( "," OWS ) pragma-directive *( OWS "," [ OWS
  pragma-directive ] )
-
-<x:ref>Vary</x:ref> = "*" / ( *( "," OWS ) field-name *( OWS "," [ OWS field-name ]
- ) )
 
 <x:ref>Warning</x:ref> = *( "," OWS ) warning-value *( OWS "," [ OWS warning-value ]
@@ -2634 +2580 @@
 </artwork>
 </figure>
-</section>
+<figure><preamble>ABNF diagnostics:</preamble><artwork type="inline">
+; field-name defined but not used
+</artwork></figure></section>
 <?ENDINC p6-cache.abnf-appendix ?>