Changeset 644 for draft-ietf-httpbis/latest/p5-range.xml

Timestamp:

Jul 28, 2009, 6:36:08 AM (10 years ago)

Author:

ylafon@…

Message:

Resolve #150: Added a note and an example to clarify that multipart/byteranges is not limited to byte ranges (closes #150)

File:

• draft-ietf-httpbis/latest/p5-range.xml (modified) (4 diffs)

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

@@ -612 +612 @@
 </t>
 <t>
-   When a client requests multiple byte-ranges in one request, the
+   When a client requests multiple ranges in one request, the
    server &SHOULD; return them in the order that they appeared in the
    request.
@@ -1262 +1262 @@
    message-body (<xref target="RFC2046" x:fmt="," x:sec="5.1"/>). The media type for this purpose is called
    "multipart/byteranges".  The following is to be registered with IANA <xref target="RFC4288"/>.
-</t><t>
+</t>
+<x:note>
+  <t>
+    <x:h>Note:</x:h> Despite the name "multipart/byteranges" is not limited to the byte ranges only.
+  </t>
+</x:note>
+<t>
    The multipart/byteranges media type includes one or more parts, each
    with its own Content-Type and Content-Range fields. The required
@@ -1337 +1343 @@
   --THIS_STRING_SEPARATES--
 </artwork></figure>
+<figure><preamble>
+   Other example:
+</preamble>
+<artwork type="example">
+  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: audio/example
+  Content-range: exampleunit 11.2-14.3/120
+  
+  ...the second range
+  --THIS_STRING_SEPARATES--
+</artwork>
+</figure>
 <t>
       Notes:
@@ -1608 +1636 @@
     </t>
     <t>
+      <eref target="http://trac.tools.ietf.org/wg/httpbis/trac/ticket/150" />: "multipart/byteranges for custom range units"
+    </t>
+    <t>
       <eref target="http://trac.tools.ietf.org/wg/httpbis/trac/ticket/151" />: "range unit missing from other-ranges-specifier in Range header"
     </t>