Changeset 1856 for draft-ietf-httpbis/latest/p2-semantics.xml

Timestamp:

03/09/12 07:33:04 (10 years ago)

Author:

fielding@…

Message:

(editorial) split response fields into categories

File:

• draft-ietf-httpbis/latest/p2-semantics.xml (modified) (1 diff)

draft-ietf-httpbis/latest/p2-semantics.xml

@@ -2459 +2459 @@
    further access to the target resource (&effective-request-uri;).
 </t>
+
+<section title="Control Data" anchor="response.control.data">
+<t>
+   Response header fields can supply control data that supplements the
+   status code or instructs the client where to go next.
+</t>
 <texttable align="left">
   <ttcol>Header Field Name</ttcol><ttcol>Defined in...</ttcol>
 
+  <c>Location</c> <c><xref target="header.location"/></c>
+  <c>Retry-After</c> <c><xref target="header.retry-after"/></c>
+</texttable>
+</section>
+
+<section title="Cache-related" anchor="response.cache.related">
+<t>
+   Cache-related response header fields provide metadata about the message
+   in order to assist downstream caches.
+</t>
+<texttable align="left">
+  <ttcol>Header Field Name</ttcol><ttcol>Defined in...</ttcol>
+
+  <c>Date</c> <c><xref target="header.date"/></c>
+  <c>Age</c> <c>&header-age;</c>
+  <c>Vary</c> <c>&header-vary;</c>
+</texttable>
+</section>
+
+<section title="Authentication Challenges" anchor="response.auth">
+<t>
+   Authentication challenges indicate what mechanisms are available for the
+   user or client to provide authentication credentials in future requests.
+</t>
+<texttable align="left">
+  <ttcol>Header Field Name</ttcol><ttcol>Defined in...</ttcol>
+
+  <c>WWW-Authenticate</c> <c>&header-www-authenticate;</c>
+  <c>Proxy-Authenticate</c> <c>&header-proxy-authenticate;</c>
+</texttable>
+</section>
+
+<section title="Informative" anchor="response.inform">
+<t>
+   The remaining response header fields provide more information about
+   the target resource for potential use in later requests.
+</t>
+<texttable align="left">
+  <ttcol>Header Field Name</ttcol><ttcol>Defined in...</ttcol>
+
   <c>Accept-Ranges</c> <c>&header-accept-ranges;</c>
-  <c>Age</c> <c>&header-age;</c>
   <c>Allow</c> <c><xref target="header.allow"/></c>
-  <c>Date</c> <c><xref target="header.date"/></c>
-  <c>ETag</c> <c>&header-etag;</c>
-  <c>Location</c> <c><xref target="header.location"/></c>
-  <c>Proxy-Authenticate</c> <c>&header-proxy-authenticate;</c>
-  <c>Retry-After</c> <c><xref target="header.retry-after"/></c>
   <c>Server</c> <c><xref target="header.server"/></c>
-  <c>Vary</c> <c>&header-vary;</c>
-  <c>WWW-Authenticate</c> <c>&header-www-authenticate;</c>
 </texttable>
+</section>
 </section>