Changeset 698 for draft-ietf-httpbis/latest/p4-conditional.xml

Timestamp:

26/09/09 10:09:09 (14 years ago)

Author:

julian.reschke@…

Message:

editorial: enhance readability of header introductions

File:

• draft-ietf-httpbis/latest/p4-conditional.xml (modified) (5 diffs)

draft-ietf-httpbis/latest/p4-conditional.xml

@@ -689 +689 @@
 <t>
    The "ETag" response-header field provides the current value of the
-   entity tag (see <xref target="entity.tags"/>) for the requested variant.
-   The headers used with entity
-   tags are described in Sections <xref target="header.if-match" format="counter"/>
-   and <xref target="header.if-none-match" format="counter"/> of this document,
-   and in &header-if-range;. The entity tag
-   &MAY; be used for comparison with other entities from the same resource
+   entity tag (see <xref target="entity.tags"/>) for the requested variant,
+   which may be used for comparison with other entities from the same resource
    (see <xref target="weak.and.strong.validators"/>).
 </t>
@@ -734 +730 @@
   <x:anchor-alias value="If-Match-v"/>
 <t>
-   The "If-Match" request-header field is used with a method to make it
+   The "If-Match" request-header field is used to make a request method
    conditional. A client that has one or more entities previously
    obtained from the resource can verify that one of those entities is
    current by including a list of their associated entity tags in the
-   If-Match header field. Entity tags are defined in <xref target="entity.tags"/>. The
-   purpose of this feature is to allow efficient updates of cached
-   information with a minimum amount of transaction overhead. It is also
-   used, on updating requests, to prevent inadvertent modification of
-   the wrong version of a resource. As a special case, the value "*"
-   matches any current entity of the resource.
+   If-Match header field.
+</t>
+<t>
+   This allows efficient updates of cached information with a minimum amount of
+   transaction overhead. It is also used when updating resources, to prevent
+   inadvertent modification of the wrong version of a resource. As a special
+   case, the value "*" matches any current entity of the resource.
 </t>
 <figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="If-Match"/><iref primary="true" item="Grammar" subitem="If-Match-v"/>
@@ -803 +800 @@
   <x:anchor-alias value="If-Modified-Since-v"/>
 <t>
-   The "If-Modified-Since" request-header field is used with a method to
-   make it conditional: if the requested variant has not been modified
-   since the time specified in this field, an entity will not be
-   returned from the server; instead, a 304 (Not Modified) response will
-   be returned without any message-body.
+   The "If-Modified-Since" request-header field is used to make a request 
+   method conditional: if the requested variant has not been modified since the
+   time specified in this field, the server will not return an entity; instead,
+   a 304 (Not Modified) response will be returned.
 </t>
 <figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="If-Modified-Since"/><iref primary="true" item="Grammar" subitem="If-Modified-Since-v"/>
@@ -888 +884 @@
   <x:anchor-alias value="If-None-Match-v"/>
 <t>
-   The "If-None-Match" request-header field is used with a method to make
-   it conditional. A client that has one or more entities previously
+   The "If-None-Match" request-header field is used to make a request method
+   conditional. A client that has one or more entities previously
    obtained from the resource can verify that none of those entities is
    current by including a list of their associated entity tags in the
-   If-None-Match header field. The purpose of this feature is to allow
-   efficient updates of cached information with a minimum amount of
+   If-None-Match header field.
+</t>
+<t>
+   This allows efficient updates of cached information with a minimum amount of
    transaction overhead. It is also used to prevent a method (e.g. PUT)
    from inadvertently modifying an existing resource when the client
@@ -965 +963 @@
   <x:anchor-alias value="If-Unmodified-Since-v"/>
 <t>
-   The "If-Unmodified-Since" request-header field is used with a method to
-   make it conditional. If the requested resource has not been modified
+   The "If-Unmodified-Since" request-header field is used to make a request
+   method conditional. If the requested resource has not been modified
    since the time specified in this field, the server &SHOULD; perform the
    requested operation as if the If-Unmodified-Since header were not