Changeset 198

Timestamp:

Feb 4, 2008, 6:45:26 PM (12 years ago)

Author:

fielding@…

Message:

Clarify that a client SHOULD ignore the Reason Phrase; related to #57.

Location:

draft-ietf-httpbis/latest

Files:

• p1-messaging.html (modified) (1 diff)
• p1-messaging.xml (modified) (1 diff)

draft-ietf-httpbis/latest/p1-messaging.html

@@ -1433 +1433 @@
 </pre><h3 id="rfc.section.6.1.1"><a href="#rfc.section.6.1.1">6.1.1</a>&nbsp;<a id="status.code.and.reason.phrase" href="#status.code.and.reason.phrase">Status Code and Reason Phrase</a></h3>
       <p id="rfc.section.6.1.1.p.1">The Status-Code element is a 3-digit integer result code of the attempt to understand and satisfy the request. These codes
-         are fully defined in <a href="p2-semantics.html#status.codes" title="Status Code Definitions">Section 8</a> of <a href="#Part2" id="rfc.xref.Part2.8"><cite title="HTTP/1.1, part 2: Message Semantics">[Part2]</cite></a>. The Reason-Phrase is intended to give a short textual description of the Status-Code. The Status-Code is intended for use
-         by automata and the Reason-Phrase is intended for the human user. The client is not required to examine or display the Reason-Phrase.
+         are fully defined in <a href="p2-semantics.html#status.codes" title="Status Code Definitions">Section 8</a> of <a href="#Part2" id="rfc.xref.Part2.8"><cite title="HTTP/1.1, part 2: Message Semantics">[Part2]</cite></a>. The Reason Phrase exists for the sole purpose of providing a textual description associated with the numeric status code,
+         out of deference to earlier Internet application protocols that were more frequently used with interactive text clients. A
+         client <em class="bcp14">SHOULD</em> ignore the content of the Reason Phrase.
       </p>
       <p id="rfc.section.6.1.1.p.2">The first digit of the Status-Code defines the class of response. The last two digits do not have any categorization role.

draft-ietf-httpbis/latest/p1-messaging.xml

@@ -1807 +1807 @@
    The Status-Code element is a 3-digit integer result code of the
    attempt to understand and satisfy the request. These codes are fully
-   defined in &status-codes;. The Reason-Phrase is intended to give a short
-   textual description of the Status-Code. The Status-Code is intended
-   for use by automata and the Reason-Phrase is intended for the human
-   user. The client is not required to examine or display the Reason-Phrase.
+   defined in &status-codes;.  The Reason Phrase exists for the sole
+   purpose of providing a textual description associated with the numeric
+   status code, out of deference to earlier Internet application protocols
+   that were more frequently used with interactive text clients.
+   A client &SHOULD; ignore the content of the Reason Phrase.
 </t>
 <t>