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

Timestamp:

29/12/12 03:20:00 (10 years ago)

Author:

fielding@…

Message:

(editorial) rephrase OPTIONS for better targeting of subject requirements

File:

• draft-ietf-httpbis/latest/p2-semantics.xml (modified) (2 diffs)

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

@@ -1628 +1628 @@
 </t>
 <t>
-   If the OPTIONS request includes a payload,
-   then the media type &MUST; be indicated by a <x:ref>Content-Type</x:ref>
-   field. Although this specification does not define any use for such a body,
-   future extensions to HTTP might use the OPTIONS body to make more detailed
-   queries on the server.
-</t>
-<t>
-   If the request-target (&request-target;) is an asterisk ("*"),
-   the OPTIONS request is
-   intended to apply to the server in general rather than to a specific
-   resource. Since a server's communication options typically depend on
-   the resource, the "*" request is only useful as a "ping" or "no-op"
+   A client that generates an OPTIONS request containing a payload body
+   &MUST; send a valid <x:ref>Content-Type</x:ref> header field describing
+   the representation media type. Although this specification does not define
+   any use for such a payload, future extensions to HTTP might use the OPTIONS
+   body to make more detailed queries about the target resource.
+</t>
+<t>
+   An OPTIONS request with an asterisk ("*") as the request-target
+   (&request-target;) applies to the server in general rather than to a
+   specific resource. Since a server's communication options typically depend
+   on the resource, the "*" request is only useful as a "ping" or "no-op"
    type of method; it does nothing beyond allowing the client to test
    the capabilities of the server. For example, this can be used to test
@@ -1646 +1645 @@
 <t>
    If the request-target is not an asterisk, the OPTIONS request applies
-   only to the options that are available when communicating with that
+   to the options that are available when communicating with the target
    resource.
 </t>
 <t>
-   A <x:ref>200 (OK)</x:ref> response &SHOULD; include any header fields that
-   indicate optional features implemented by the server and applicable to that
-   resource (e.g., <x:ref>Allow</x:ref>), possibly including extensions not
-   defined by this specification. The response payload, if any, &SHOULD; also
-   include information about the communication options. The format for such a
+   A server generating a successful response to OPTIONS &SHOULD; send any
+   header fields that might indicate optional features implemented by the
+   server and applicable to the target resource (e.g., <x:ref>Allow</x:ref>),
+   including potential extensions not defined by this specification.
+   The response payload, if any, might also describe the communication options
+   in a machine or human-readable representation. A standard format for such a
    payload is not defined by this specification, but might be defined by
-   future extensions to HTTP. Content negotiation &MAY; be used to select
-   the appropriate representation. If no payload body is included, the
-   response &MUST; include a <x:ref>Content-Length</x:ref> field with a
-   field-value of "0".
-</t>
-<t>
-   The <x:ref>Max-Forwards</x:ref> header field &MAY; be used to target a
-   specific proxy in the request chain (see <xref target="header.max-forwards"/>).
-   If no Max-Forwards field is present in the request, then the forwarded
-   request &MUST-NOT; include a Max-Forwards field.
+   future extensions to HTTP.
+   A server &MUST; generate a <x:ref>Content-Length</x:ref> field with a value
+   of "0" if no payload body is to be sent in the response.
+</t>
+<t>
+   A client &MAY; send a <x:ref>Max-Forwards</x:ref> header field in an
+   OPTIONS request to target a specific recipient in the request chain (see
+   <xref target="header.max-forwards"/>). A proxy &MUST-NOT; generate a
+   Max-Forwards header field while forwarding a request unless that request
+   was received with a Max-Forwards field.
 </t>
 </section>