Changeset 648 for draft-ietf-httpbis/latest

Timestamp:

Jul 28, 2009, 8:37:35 AM (10 years ago)

Author:

julian.reschke@…

Message:

update collected ABNFs

Location:

draft-ietf-httpbis/latest

Files:

• p1-messaging.html (modified) (4 diffs)
• p1-messaging.xml (modified) (4 diffs)
• p2-semantics.html (modified) (4 diffs)
• p2-semantics.xml (modified) (4 diffs)
• p3-payload.html (modified) (3 diffs)
• p3-payload.xml (modified) (3 diffs)
• p4-conditional.html (modified) (1 diff)
• p5-range.html (modified) (7 diffs)
• p6-cache.html (modified) (2 diffs)
• p6-cache.xml (modified) (2 diffs)
• p7-auth.html (modified) (1 diff)

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

@@ -2656 +2656 @@
 <a href="#http.version" class="smpl">HTTP-Version</a> = HTTP-Prot-Name "/" 1*DIGIT "." 1*DIGIT
 <a href="#date.time.formats.full.date" class="smpl">HTTP-date</a> = rfc1123-date / obs-date
-<a href="#http.message" class="smpl">HTTP-message</a> = start-line *( header-field CRLF ) CRLF [
- message-body ]
+<a href="#http.message" class="smpl">HTTP-message</a> = start-line *( header-field CRLF ) CRLF [ message-body
+ ]
 <a href="#header.host" class="smpl">Host</a> = "Host:" OWS Host-v
 <a href="#header.host" class="smpl">Host-v</a> = uri-host [ ":" port ]
@@ -2746 +2746 @@
  / Transfer-Encoding / Upgrade / Via / Warning
 
+<a href="#header.fields" class="smpl">header-field</a> = field-name ":" OWS [ field-value ] OWS
 <a href="#preferred.date.format" class="smpl">hour</a> = 2DIGIT
 <a href="#http.uri" class="smpl">http-URI</a> = "http://" authority path-abempty [ "?" query ]
@@ -2754 +2755 @@
 <a href="#message.body" class="smpl">message-body</a> = entity-body /
  &lt;entity-body encoded as per Transfer-Encoding&gt;
-<a href="#header.fields" class="smpl">header-field</a> = field-name ":" OWS [ field-value ] OWS
 <a href="#preferred.date.format" class="smpl">minute</a> = 2DIGIT
 <a href="#preferred.date.format" class="smpl">month</a> = %x4A.61.6E ; Jan
@@ -2827 +2827 @@
 ; HTTP-message defined but not used
 ; Host defined but not used
+; Request defined but not used
+; Response defined but not used
 ; TE defined but not used
 ; URI defined but not used
 ; URI-reference defined but not used
 ; fragment defined but not used
-; generic-message defined but not used
 ; http-URI defined but not used
 ; https-URI defined but not used

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

@@ -4417 +4417 @@
 <x:ref>HTTP-Version</x:ref> = HTTP-Prot-Name "/" 1*DIGIT "." 1*DIGIT
 <x:ref>HTTP-date</x:ref> = rfc1123-date / obs-date
-<x:ref>HTTP-message</x:ref> = start-line *( header-field CRLF ) CRLF [
- message-body ]
+<x:ref>HTTP-message</x:ref> = start-line *( header-field CRLF ) CRLF [ message-body
+ ]
 <x:ref>Host</x:ref> = "Host:" OWS Host-v
 <x:ref>Host-v</x:ref> = uri-host [ ":" port ]
@@ -4507 +4507 @@
  / Transfer-Encoding / Upgrade / Via / Warning
 
+<x:ref>header-field</x:ref> = field-name ":" OWS [ field-value ] OWS
 <x:ref>hour</x:ref> = 2DIGIT
 <x:ref>http-URI</x:ref> = "http://" authority path-abempty [ "?" query ]
@@ -4515 +4516 @@
 <x:ref>message-body</x:ref> = entity-body /
  &lt;entity-body encoded as per Transfer-Encoding&gt;
-<x:ref>header-field</x:ref> = field-name ":" OWS [ field-value ] OWS
 <x:ref>minute</x:ref> = 2DIGIT
 <x:ref>month</x:ref> = %x4A.61.6E ; Jan
@@ -4590 +4590 @@
 ; HTTP-message defined but not used
 ; Host defined but not used
+; Request defined but not used
+; Response defined but not used
 ; TE defined but not used
 ; URI defined but not used
 ; URI-reference defined but not used
 ; fragment defined but not used
-; generic-message defined but not used
 ; http-URI defined but not used
 ; https-URI defined but not used

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

@@ -2274 +2274 @@
 
 <a href="#abnf.dependencies" class="smpl">HTTP-date</a> = &lt;HTTP-date, defined in [Part1], Section 6.1&gt;
-<a href="#abnf.dependencies" class="smpl">Host</a> = &lt;Host, defined in [Part1], Section 2.3&gt;
+<a href="#abnf.dependencies" class="smpl">Host</a> = &lt;Host, defined in [Part1], Section 2.6&gt;
 
 <a href="#abnf.dependencies" class="smpl">If-Match</a> = &lt;If-Match, defined in [Part4], Section 6.2&gt;
@@ -2325 +2325 @@
 <a href="#abnf.dependencies" class="smpl">TE</a> = &lt;TE, defined in [Part1], Section 8.8&gt;
 
-<a href="#abnf.dependencies" class="smpl">URI</a> = &lt;URI, defined in [Part1], Section 2.3&gt;
+<a href="#abnf.dependencies" class="smpl">URI</a> = &lt;URI, defined in [Part1], Section 2.6&gt;
 <a href="#header.user-agent" class="smpl">User-Agent</a> = "User-Agent:" OWS User-Agent-v
 <a href="#header.user-agent" class="smpl">User-Agent-v</a> = product *( RWS ( product / comment ) )
@@ -2334 +2334 @@
  &lt;WWW-Authenticate, defined in [Part7], Section 3.4&gt;
 
-<a href="#abnf.dependencies" class="smpl">absolute-URI</a> = &lt;absolute-URI, defined in [Part1], Section 2.3&gt;
+<a href="#abnf.dependencies" class="smpl">absolute-URI</a> = &lt;absolute-URI, defined in [Part1], Section 2.6&gt;
 
 <a href="#core.rules" class="smpl">comment</a> = &lt;comment, defined in [Part1], Section 1.2.2&gt;
@@ -2351 +2351 @@
 <a href="#core.rules" class="smpl">obs-text</a> = &lt;obs-text, defined in [Part1], Section 1.2.2&gt;
 
-<a href="#abnf.dependencies" class="smpl">partial-URI</a> = &lt;partial-URI, defined in [Part1], Section 2.3&gt;
+<a href="#abnf.dependencies" class="smpl">partial-URI</a> = &lt;partial-URI, defined in [Part1], Section 2.6&gt;
 <a href="#abnf.dependencies" class="smpl">product</a> = &lt;product, defined in [Part1], Section 6.3&gt;
 

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

@@ -3268 +3268 @@
 
 <x:ref>HTTP-date</x:ref> = &lt;HTTP-date, defined in [Part1], Section 6.1&gt;
-<x:ref>Host</x:ref> = &lt;Host, defined in [Part1], Section 2.3&gt;
+<x:ref>Host</x:ref> = &lt;Host, defined in [Part1], Section 2.6&gt;
 
 <x:ref>If-Match</x:ref> = &lt;If-Match, defined in [Part4], Section 6.2&gt;
@@ -3319 +3319 @@
 <x:ref>TE</x:ref> = &lt;TE, defined in [Part1], Section 8.8&gt;
 
-<x:ref>URI</x:ref> = &lt;URI, defined in [Part1], Section 2.3&gt;
+<x:ref>URI</x:ref> = &lt;URI, defined in [Part1], Section 2.6&gt;
 <x:ref>User-Agent</x:ref> = "User-Agent:" OWS User-Agent-v
 <x:ref>User-Agent-v</x:ref> = product *( RWS ( product / comment ) )
@@ -3328 +3328 @@
  &lt;WWW-Authenticate, defined in [Part7], Section 3.4&gt;
 
-<x:ref>absolute-URI</x:ref> = &lt;absolute-URI, defined in [Part1], Section 2.3&gt;
+<x:ref>absolute-URI</x:ref> = &lt;absolute-URI, defined in [Part1], Section 2.6&gt;
 
 <x:ref>comment</x:ref> = &lt;comment, defined in [Part1], Section 1.2.2&gt;
@@ -3345 +3345 @@
 <x:ref>obs-text</x:ref> = &lt;obs-text, defined in [Part1], Section 1.2.2&gt;
 
-<x:ref>partial-URI</x:ref> = &lt;partial-URI, defined in [Part1], Section 2.3&gt;
+<x:ref>partial-URI</x:ref> = &lt;partial-URI, defined in [Part1], Section 2.6&gt;
 <x:ref>product</x:ref> = &lt;product, defined in [Part1], Section 6.3&gt;
 

draft-ietf-httpbis/latest/p3-payload.html

@@ -1766 +1766 @@
 <a href="#core.rules" class="smpl">OWS</a> = &lt;OWS, defined in [Part1], Section 1.2.2&gt;
 
-<a href="#abnf.dependencies" class="smpl">absolute-URI</a> = &lt;absolute-URI, defined in [Part1], Section 2.3&gt;
+<a href="#abnf.dependencies" class="smpl">absolute-URI</a> = &lt;absolute-URI, defined in [Part1], Section 2.6&gt;
 <a href="#header.accept" class="smpl">accept-ext</a> = OWS ";" OWS token [ "=" ( token / quoted-string ) ]
 <a href="#header.accept" class="smpl">accept-params</a> = OWS ";" OWS "q=" qvalue *accept-ext
@@ -1792 +1792 @@
 <a href="#content-disposition" class="smpl">filename-parm</a> = "filename=" quoted-string
 
+<a href="#abnf.dependencies" class="smpl">header-field</a> = &lt;header-field, defined in [Part1], Section 3.2&gt;
+
 <a href="#header.accept-language" class="smpl">language-range</a> = &lt;language-range, defined in [RFC4647], Section 2.1&gt;
 <a href="#language.tags" class="smpl">language-tag</a> = &lt;Language-Tag, defined in [RFC4646bis], Section 2.1&gt;
@@ -1798 +1800 @@
  ";" OWS parameter )
 <a href="#media.types" class="smpl">media-type</a> = type "/" subtype *( OWS ";" OWS parameter )
-<a href="#abnf.dependencies" class="smpl">header-field</a> = &lt;header-field, defined in [Part1], Section 3.2&gt;
 
 <a href="#rule.parameter" class="smpl">parameter</a> = attribute "=" value
-<a href="#abnf.dependencies" class="smpl">partial-URI</a> = &lt;partial-URI, defined in [Part1], Section 2.3&gt;
+<a href="#abnf.dependencies" class="smpl">partial-URI</a> = &lt;partial-URI, defined in [Part1], Section 2.6&gt;
 
 <a href="#core.rules" class="smpl">quoted-string</a> = &lt;quoted-string, defined in [Part1], Section 1.2.2&gt;

draft-ietf-httpbis/latest/p3-payload.xml

@@ -2707 +2707 @@
 <x:ref>OWS</x:ref> = &lt;OWS, defined in [Part1], Section 1.2.2&gt;
 
-<x:ref>absolute-URI</x:ref> = &lt;absolute-URI, defined in [Part1], Section 2.3&gt;
+<x:ref>absolute-URI</x:ref> = &lt;absolute-URI, defined in [Part1], Section 2.6&gt;
 <x:ref>accept-ext</x:ref> = OWS ";" OWS token [ "=" ( token / quoted-string ) ]
 <x:ref>accept-params</x:ref> = OWS ";" OWS "q=" qvalue *accept-ext
@@ -2733 +2733 @@
 <x:ref>filename-parm</x:ref> = "filename=" quoted-string
 
+<x:ref>header-field</x:ref> = &lt;header-field, defined in [Part1], Section 3.2&gt;
+
 <x:ref>language-range</x:ref> = &lt;language-range, defined in [RFC4647], Section 2.1&gt;
 <x:ref>language-tag</x:ref> = &lt;Language-Tag, defined in [RFC4646bis], Section 2.1&gt;
@@ -2739 +2741 @@
  ";" OWS parameter )
 <x:ref>media-type</x:ref> = type "/" subtype *( OWS ";" OWS parameter )
-<x:ref>header-field</x:ref> = &lt;header-field, defined in [Part1], Section 3.2&gt;
 
 <x:ref>parameter</x:ref> = attribute "=" value
-<x:ref>partial-URI</x:ref> = &lt;partial-URI, defined in [Part1], Section 2.3&gt;
+<x:ref>partial-URI</x:ref> = &lt;partial-URI, defined in [Part1], Section 2.6&gt;
 
 <x:ref>quoted-string</x:ref> = &lt;quoted-string, defined in [Part1], Section 1.2.2&gt;

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

@@ -467 +467 @@
          <tr>
             <td class="header left"></td>
-            <td class="header right">July 27, 2009</td>
+            <td class="header right">July 28, 2009</td>
          </tr>
       </table>

draft-ietf-httpbis/latest/p5-range.html

@@ -371 +371 @@
       <link rel="Appendix" title="C Collected ABNF" href="#rfc.section.C">
       <link rel="Appendix" title="D Change Log (to be removed by RFC Editor before publication)" href="#rfc.section.D">
-      <meta name="generator" content="http://greenbytes.de/tech/webdav/rfc2629.xslt, Revision 1.439, 2009-06-09 18:43:39, XSLT vendor: SAXON 8.9.0.4 from Saxonica http://www.saxonica.com/">
+      <meta name="generator" content="http://greenbytes.de/tech/webdav/rfc2629.xslt, Revision 1.439, 2009-06-09 18:43:39, XSLT vendor: SAXON 8.9 from Saxonica http://www.saxonica.com/">
       <link rel="schema.DC" href="http://purl.org/dc/elements/1.1/">
       <meta name="DC.Creator" content="Fielding, R.">
@@ -758 +758 @@
       <p id="rfc.section.5.2.p.11">A response to a request for a single range <em class="bcp14">MUST NOT</em> be sent using the multipart/byteranges media type. A response to a request for multiple ranges, whose result is a single range, <em class="bcp14">MAY</em> be sent as a multipart/byteranges media type with one part. A client that cannot decode a multipart/byteranges message <em class="bcp14">MUST NOT</em> ask for multiple ranges in a single request.
       </p>
-      <p id="rfc.section.5.2.p.12">When a client requests multiple byte-ranges in one request, the server <em class="bcp14">SHOULD</em> return them in the order that they appeared in the request.
+      <p id="rfc.section.5.2.p.12">When a client requests multiple ranges in one request, the server <em class="bcp14">SHOULD</em> return them in the order that they appeared in the request.
       </p>
       <p id="rfc.section.5.2.p.13">If the server ignores a byte-range-spec because it is syntactically invalid, the server <em class="bcp14">SHOULD</em> treat the request as if the invalid Range header field did not exist. (Normally, this means return a 200 response containing
@@ -1015 +1015 @@
          non-overlapping ranges), these are transmitted as a multipart message-body (<a href="#RFC2046" id="rfc.xref.RFC2046.1"><cite title="Multipurpose Internet Mail Extensions (MIME) Part Two: Media Types">[RFC2046]</cite></a>, <a href="http://tools.ietf.org/html/rfc2046#section-5.1">Section 5.1</a>). The media type for this purpose is called "multipart/byteranges". The following is to be registered with IANA <a href="#RFC4288" id="rfc.xref.RFC4288.1"><cite title="Media Type Specifications and Registration Procedures">[RFC4288]</cite></a>.
       </p>
-      <p id="rfc.section.A.p.2">The multipart/byteranges media type includes one or more parts, each with its own Content-Type and Content-Range fields. The
+      <div class="note"> 
+         <p> <b>Note:</b> Despite the name "multipart/byteranges" is not limited to the byte ranges only.
+         </p> 
+      </div>
+      <p id="rfc.section.A.p.3">The multipart/byteranges media type includes one or more parts, each with its own Content-Type and Content-Range fields. The
          required boundary parameter specifies the boundary string used to separate each body-part.
       </p>
-      <p id="rfc.section.A.p.3"> </p>
+      <p id="rfc.section.A.p.4"> </p>
       <dl>
          <dt>Type name:</dt>
@@ -1075 +1079 @@
   ...the second range
   --THIS_STRING_SEPARATES--
-</pre><p id="rfc.section.A.p.5">Notes: </p>
+</pre><div id="rfc.figure.u.25"></div>
+      <p>Other example:</p>  <pre class="text">  HTTP/1.1 206 Partial Content
+  Date: Tue, 14 Nov 1995 06:25:24 GMT
+  Last-Modified: Tue, 14 July 04:58:08 GMT
+  Content-type: multipart/byteranges; boundary=THIS_STRING_SEPARATES
+  
+  --THIS_STRING_SEPARATES
+  Content-type: video/example
+  Content-range: exampleunit 1.2-4.3/25
+  
+  ...the first range...
+  --THIS_STRING_SEPARATES
+  Content-type: video/example
+  Content-range: exampleunit 11.2-14.3/25
+  
+  ...the second range
+  --THIS_STRING_SEPARATES--
+</pre> <p id="rfc.section.A.p.7">Notes: </p>
       <ol>
          <li>Additional CRLFs may precede the first boundary string in the entity.</li>
@@ -1106 +1127 @@
       </p>
       <h1 id="rfc.section.C"><a href="#rfc.section.C">C.</a>&nbsp;<a id="collected.abnf" href="#collected.abnf">Collected ABNF</a></h1>
-      <div id="rfc.figure.u.25"></div> <pre class="inline"><a href="#header.accept-ranges" class="smpl">Accept-Ranges</a> = "Accept-Ranges:" OWS Accept-Ranges-v
+      <div id="rfc.figure.u.26"></div> <pre class="inline"><a href="#header.accept-ranges" class="smpl">Accept-Ranges</a> = "Accept-Ranges:" OWS Accept-Ranges-v
 <a href="#header.accept-ranges" class="smpl">Accept-Ranges-v</a> = acceptable-ranges
 
@@ -1158 +1179 @@
 
 <a href="#core.rules" class="smpl">token</a> = &lt;token, defined in [Part1], Section 1.2.2&gt;
-</pre> <div id="rfc.figure.u.26"></div>
+</pre> <div id="rfc.figure.u.27"></div>
       <p>ABNF diagnostics:</p><pre class="inline">; Accept-Ranges defined but not used
 ; Content-Range defined but not used
@@ -1237 +1258 @@
       <ul>
          <li>Fixed discrepancy in the If-Range definition about allowed validators.</li>
+         <li> &lt;<a href="http://trac.tools.ietf.org/wg/httpbis/trac/ticket/150">http://trac.tools.ietf.org/wg/httpbis/trac/ticket/150</a>&gt;: "multipart/byteranges for custom range units"
+         </li>
          <li> &lt;<a href="http://trac.tools.ietf.org/wg/httpbis/trac/ticket/151">http://trac.tools.ietf.org/wg/httpbis/trac/ticket/151</a>&gt;: "range unit missing from other-ranges-specifier in Range header"
          </li>

draft-ietf-httpbis/latest/p6-cache.html

@@ -1604 +1604 @@
 <a href="#abnf.dependencies" class="smpl">field-name</a> = &lt;field-name, defined in [Part1], Section 3.2&gt;
 
-<a href="#abnf.dependencies" class="smpl">port</a> = &lt;port, defined in [Part1], Section 2.3&gt;
+<a href="#abnf.dependencies" class="smpl">port</a> = &lt;port, defined in [Part1], Section 2.6&gt;
 <a href="#header.pragma" class="smpl">pragma-directive</a> = "no-cache" / extension-pragma
 <a href="#abnf.dependencies" class="smpl">pseudonym</a> = &lt;pseudonym, defined in [Part1], Section 8.9&gt;
@@ -1612 +1612 @@
 <a href="#core.rules" class="smpl">token</a> = &lt;token, defined in [Part1], Section 1.2.2&gt;
 
-<a href="#abnf.dependencies" class="smpl">uri-host</a> = &lt;uri-host, defined in [Part1], Section 2.3&gt;
+<a href="#abnf.dependencies" class="smpl">uri-host</a> = &lt;uri-host, defined in [Part1], Section 2.6&gt;
 
 <a href="#header.warning" class="smpl">warn-agent</a> = ( uri-host [ ":" port ] ) / pseudonym

draft-ietf-httpbis/latest/p6-cache.xml

@@ -2172 +2172 @@
 <x:ref>field-name</x:ref> = &lt;field-name, defined in [Part1], Section 3.2&gt;
 
-<x:ref>port</x:ref> = &lt;port, defined in [Part1], Section 2.3&gt;
+<x:ref>port</x:ref> = &lt;port, defined in [Part1], Section 2.6&gt;
 <x:ref>pragma-directive</x:ref> = "no-cache" / extension-pragma
 <x:ref>pseudonym</x:ref> = &lt;pseudonym, defined in [Part1], Section 8.9&gt;
@@ -2180 +2180 @@
 <x:ref>token</x:ref> = &lt;token, defined in [Part1], Section 1.2.2&gt;
 
-<x:ref>uri-host</x:ref> = &lt;uri-host, defined in [Part1], Section 2.3&gt;
+<x:ref>uri-host</x:ref> = &lt;uri-host, defined in [Part1], Section 2.6&gt;
 
 <x:ref>warn-agent</x:ref> = ( uri-host [ ":" port ] ) / pseudonym

draft-ietf-httpbis/latest/p7-auth.html

@@ -462 +462 @@
          <tr>
             <td class="header left"></td>
-            <td class="header right">July 27, 2009</td>
+            <td class="header right">July 28, 2009</td>
          </tr>
       </table>