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

Timestamp:

29/03/11 12:57:19 (12 years ago)

Author:

julian.reschke@…

Message:

rewrite header field ABNFs to only specify the field value (see #276)

File:

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

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

@@ -471 +471 @@
   <iref primary="true" item="Header Fields" subitem="Accept-Ranges" x:for-anchor=""/>
   <x:anchor-alias value="Accept-Ranges"/>
-  <x:anchor-alias value="Accept-Ranges-v"/>
   <x:anchor-alias value="acceptable-ranges"/>
 <t>
@@ -477 +476 @@
    its acceptance of range requests.
 </t>
-<figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="Accept-Ranges"/><iref primary="true" item="Grammar" subitem="Accept-Ranges-v"/><iref primary="true" item="Grammar" subitem="acceptable-ranges"/>
-  <x:ref>Accept-Ranges</x:ref>     = "Accept-Ranges" ":" <x:ref>OWS</x:ref> <x:ref>Accept-Ranges-v</x:ref>
-  <x:ref>Accept-Ranges-v</x:ref>   = <x:ref>acceptable-ranges</x:ref>
+<figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="Accept-Ranges"/><iref primary="true" item="Grammar" subitem="acceptable-ranges"/>
+  <x:ref>Accept-Ranges</x:ref>     = <x:ref>acceptable-ranges</x:ref>
   <x:ref>acceptable-ranges</x:ref> = 1#<x:ref>range-unit</x:ref> / "none"
 </artwork></figure>
@@ -511 +509 @@
   <x:anchor-alias value="byte-range-resp-spec"/>
   <x:anchor-alias value="Content-Range"/>
-  <x:anchor-alias value="Content-Range-v"/>
   <x:anchor-alias value="content-range-spec"/>
   <x:anchor-alias value="instance-length"/>
@@ -524 +521 @@
    Range units are defined in <xref target="range.units"/>.
 </t>
-<figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="Content-Range"/><iref primary="true" item="Grammar" subitem="Content-Range-v"/><iref primary="true" item="Grammar" subitem="content-range-spec"/><iref primary="true" item="Grammar" subitem="byte-content-range-spec"/><iref primary="true" item="Grammar" subitem="byte-range-resp-spec"/><iref primary="true" item="Grammar" subitem="instance-length"/>
-  <x:ref>Content-Range</x:ref> = "Content-Range" ":" <x:ref>OWS</x:ref> <x:ref>Content-Range-v</x:ref>
-  <x:ref>Content-Range-v</x:ref> = <x:ref>content-range-spec</x:ref>
+<figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="Content-Range"/><iref primary="true" item="Grammar" subitem="content-range-spec"/><iref primary="true" item="Grammar" subitem="byte-content-range-spec"/><iref primary="true" item="Grammar" subitem="byte-range-resp-spec"/><iref primary="true" item="Grammar" subitem="instance-length"/>
+  <x:ref>Content-Range</x:ref> = <x:ref>content-range-spec</x:ref>
   
   <x:ref>content-range-spec</x:ref>      = <x:ref>byte-content-range-spec</x:ref>
@@ -663 +659 @@
   <iref primary="true" item="Header Fields" subitem="If-Range" x:for-anchor=""/>
   <x:anchor-alias value="If-Range"/>
-  <x:anchor-alias value="If-Range-v"/>
 <t>
    If a client has a partial copy of a representation in its cache, and wishes
@@ -679 +674 @@
    representation".
 </t>
-<figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="If-Range"/><iref primary="true" item="Grammar" subitem="If-Range-v"/>
-  <x:ref>If-Range</x:ref>   = "If-Range" ":" <x:ref>OWS</x:ref> <x:ref>If-Range-v</x:ref>
-  <x:ref>If-Range-v</x:ref> = <x:ref>entity-tag</x:ref> / <x:ref>HTTP-date</x:ref>
+<figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="If-Range"/>
+  <x:ref>If-Range</x:ref> = <x:ref>entity-tag</x:ref> / <x:ref>HTTP-date</x:ref>
 </artwork></figure>
 <t>
@@ -822 +816 @@
 <section title="Range Retrieval Requests" anchor="range.retrieval.requests">
   <x:anchor-alias value="Range"/>
-  <x:anchor-alias value="Range-v"/>
   <x:anchor-alias value="other-ranges-specifier"/>
   <x:anchor-alias value="other-range-set"/>
@@ -831 +824 @@
 </t>
 <figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="Range"/>
-  <x:ref>Range</x:ref>   = "Range" ":" <x:ref>OWS</x:ref> <x:ref>Range-v</x:ref>
-  <x:ref>Range-v</x:ref> = <x:ref>byte-ranges-specifier</x:ref>
-          / <x:ref>other-ranges-specifier</x:ref>
+  <x:ref>Range</x:ref> = <x:ref>byte-ranges-specifier</x:ref> / <x:ref>other-ranges-specifier</x:ref>
   <x:ref>other-ranges-specifier</x:ref> = <x:ref>other-range-unit</x:ref> "=" <x:ref>other-range-set</x:ref>
   <x:ref>other-range-set</x:ref> = 1*<x:ref>CHAR</x:ref>
@@ -1369 +1360 @@
 </t>
 <t>
+  Change ABNF productions for header fields to only define the field value.
+  (<xref target="header.fields"/>)
+</t>
+<t>
   Clarify that multipart/byteranges can consist of a single part.
   (<xref target="internet.media.type.multipart.byteranges"/>)
 </t>
-
 </section>
 
@@ -1381 +1375 @@
 <figure>
 <artwork type="abnf" name="p5-range.parsed-abnf">
-<x:ref>Accept-Ranges</x:ref> = "Accept-Ranges:" OWS Accept-Ranges-v
-<x:ref>Accept-Ranges-v</x:ref> = acceptable-ranges
-
-<x:ref>Content-Range</x:ref> = "Content-Range:" OWS Content-Range-v
-<x:ref>Content-Range-v</x:ref> = content-range-spec
+<x:ref>Accept-Ranges</x:ref> = acceptable-ranges
+
+<x:ref>Content-Range</x:ref> = content-range-spec
 
 <x:ref>HTTP-date</x:ref> = &lt;HTTP-date, defined in [Part1], Section 6.1&gt;
 
-<x:ref>If-Range</x:ref> = "If-Range:" OWS If-Range-v
-<x:ref>If-Range-v</x:ref> = entity-tag / HTTP-date
+<x:ref>If-Range</x:ref> = entity-tag / HTTP-date
 
 <x:ref>OWS</x:ref> = &lt;OWS, defined in [Part1], Section 1.2.2&gt;
 
-<x:ref>Range</x:ref> = "Range:" OWS Range-v
-<x:ref>Range-v</x:ref> = byte-ranges-specifier / other-ranges-specifier
+<x:ref>Range</x:ref> = byte-ranges-specifier / other-ranges-specifier
 
 <x:ref>acceptable-ranges</x:ref> = ( *( "," OWS ) range-unit *( OWS "," [ OWS
@@ -1507 +1497 @@
 <section title="Since draft-ietf-httpbis-p5-range-03" anchor="changes.since.03">
 <t>
+  None.
 </t>
 </section>
@@ -1665 +1656 @@
 <section title="Since draft-ietf-httpbis-p5-range-13" anchor="changes.since.13">
 <t>
-  None yet.
+  Closed issues:
+  <list style="symbols">
+    <t>
+      <eref target="http://tools.ietf.org/wg/httpbis/trac/ticket/276"/>:
+      "untangle ABNFs for header fields"
+    </t>
+  </list>
 </t>
 </section>