Changeset 2263 for draft-ietf-httpbis

Timestamp:

20/05/13 00:24:21 (10 years ago)

Author:

fielding@…

Message:

Change header field trailing whitespace from BWS to OWS to be consistent with suggested in-place white-out; demote an untargeted requirement on removing leading and trailing whitespace to a suggestion on parser handling of field-value to be consistent with the ABNF; addresses #442

Location:

draft-ietf-httpbis/latest

Files:

• httpbis.abnf (modified) (1 diff)
• p1-messaging.html (modified) (3 diffs)
• p1-messaging.xml (modified) (3 diffs)

draft-ietf-httpbis/latest/httpbis.abnf

@@ -134 +134 @@
 field-value = *( field-content / obs-fold )
 first-byte-pos = 1*DIGIT
-header-field = field-name ":" OWS field-value BWS
+header-field = field-name ":" OWS field-value OWS
 hour = 2DIGIT
 http-URI = "http://" authority path-abempty [ "?" query ]

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

@@ -1195 +1195 @@
       <div id="rfc.figure.u.17"></div><pre class="inline"><span id="rfc.iref.g.33"></span>  <a href="#status.line" class="smpl">reason-phrase</a>  = *( <a href="#core.rules" class="smpl">HTAB</a> / <a href="#core.rules" class="smpl">SP</a> / <a href="#core.rules" class="smpl">VCHAR</a> / <a href="#rule.quoted-string" class="smpl">obs-text</a> )
 </pre><h2 id="rfc.section.3.2"><a href="#rfc.section.3.2">3.2</a>&nbsp;<a id="header.fields" href="#header.fields">Header Fields</a></h2>
-      <p id="rfc.section.3.2.p.1">Each HTTP header field consists of a case-insensitive field name followed by a colon (":"), optional whitespace, and the field
-         value.
-      </p>
-      <div id="rfc.figure.u.18"></div><pre class="inline"><span id="rfc.iref.g.34"></span><span id="rfc.iref.g.35"></span><span id="rfc.iref.g.36"></span><span id="rfc.iref.g.37"></span><span id="rfc.iref.g.38"></span>  <a href="#header.fields" class="smpl">header-field</a>   = <a href="#header.fields" class="smpl">field-name</a> ":" <a href="#rule.whitespace" class="smpl">OWS</a> <a href="#header.fields" class="smpl">field-value</a> <a href="#rule.whitespace" class="smpl">BWS</a>
+      <p id="rfc.section.3.2.p.1">Each HTTP header field consists of a case-insensitive field name followed by a colon (":"), optional leading whitespace, the
+         field value, and optional trailing whitespace.
+      </p>
+      <div id="rfc.figure.u.18"></div><pre class="inline"><span id="rfc.iref.g.34"></span><span id="rfc.iref.g.35"></span><span id="rfc.iref.g.36"></span><span id="rfc.iref.g.37"></span><span id="rfc.iref.g.38"></span>  <a href="#header.fields" class="smpl">header-field</a>   = <a href="#header.fields" class="smpl">field-name</a> ":" <a href="#rule.whitespace" class="smpl">OWS</a> <a href="#header.fields" class="smpl">field-value</a> <a href="#rule.whitespace" class="smpl">OWS</a>
   <a href="#header.fields" class="smpl">field-name</a>     = <a href="#rule.token.separators" class="smpl">token</a>
   <a href="#header.fields" class="smpl">field-value</a>    = *( <a href="#header.fields" class="smpl">field-content</a> / <a href="#header.fields" class="smpl">obs-fold</a> )
@@ -1269 +1269 @@
       <p id="rfc.section.3.2.4.p.2">A field value is preceded by optional whitespace (OWS); a single SP is preferred. The field value does not include any leading
          or trailing white space: OWS occurring before the first non-whitespace octet of the field value or after the last non-whitespace
-         octet of the field value is ignored and <em class="bcp14">SHOULD</em> be removed before further processing (as this does not change the meaning of the header field).
+         octet of the field value ought to be excluded by parsers when extracting the field value from a header field.
       </p>
       <p id="rfc.section.3.2.4.p.3">A recipient of field-content containing multiple sequential octets of optional (OWS) or required (RWS) whitespace <em class="bcp14">SHOULD</em> either replace the sequence with a single SP or transform any non-SP octets in the sequence to SP octets before interpreting
@@ -3019 +3019 @@
 <a href="#header.fields" class="smpl">field-value</a> = *( field-content / obs-fold )
 
-<a href="#header.fields" class="smpl">header-field</a> = field-name ":" OWS field-value BWS
+<a href="#header.fields" class="smpl">header-field</a> = field-name ":" OWS field-value OWS
 <a href="#http.uri" class="smpl">http-URI</a> = "http://" authority path-abempty [ "?" query ]
 <a href="#https.uri" class="smpl">https-URI</a> = "https://" authority path-abempty [ "?" query ]

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

@@ -1166 +1166 @@
 <t>
    Each HTTP header field consists of a case-insensitive field name
-   followed by a colon (":"), optional whitespace, and the field value.
+   followed by a colon (":"), optional leading whitespace, the field value,
+   and optional trailing whitespace.
 </t>
 <figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="header-field"/><iref primary="true" item="Grammar" subitem="field-name"/><iref primary="true" item="Grammar" subitem="field-value"/><iref primary="true" item="Grammar" subitem="field-content"/><iref primary="true" item="Grammar" subitem="obs-fold"/>
-  <x:ref>header-field</x:ref>   = <x:ref>field-name</x:ref> ":" <x:ref>OWS</x:ref> <x:ref>field-value</x:ref> <x:ref>BWS</x:ref>
+  <x:ref>header-field</x:ref>   = <x:ref>field-name</x:ref> ":" <x:ref>OWS</x:ref> <x:ref>field-value</x:ref> <x:ref>OWS</x:ref>
   <x:ref>field-name</x:ref>     = <x:ref>token</x:ref>
   <x:ref>field-value</x:ref>    = *( <x:ref>field-content</x:ref> / <x:ref>obs-fold</x:ref> )
@@ -1298 +1299 @@
    A field value is preceded by optional whitespace (OWS); a single SP is
    preferred. The field value does not include any leading or trailing white
-   space: OWS occurring before the first non-whitespace octet of the
-   field value or after the last non-whitespace octet of the field value
-   is ignored and &SHOULD; be removed before further processing (as this does
-   not change the meaning of the header field).
+   space: OWS occurring before the first non-whitespace octet of the field
+   value or after the last non-whitespace octet of the field value ought to be
+   excluded by parsers when extracting the field value from a header field.
 </t>
 <t>
@@ -5102 +5102 @@
 <x:ref>field-value</x:ref> = *( field-content / obs-fold )
 
-<x:ref>header-field</x:ref> = field-name ":" OWS field-value BWS
+<x:ref>header-field</x:ref> = field-name ":" OWS field-value OWS
 <x:ref>http-URI</x:ref> = "http://" authority path-abempty [ "?" query ]
 <x:ref>https-URI</x:ref> = "https://" authority path-abempty [ "?" query ]