Ignore:
Timestamp:
Mar 29, 2011, 5:57:19 AM (9 years ago)
Author:
julian.reschke@…
Message:

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

File:
1 edited

Legend:

Unmodified
Added
Removed
  • draft-ietf-httpbis/latest/p5-range.xml

    r1180 r1232  
    471471  <iref primary="true" item="Header Fields" subitem="Accept-Ranges" x:for-anchor=""/>
    472472  <x:anchor-alias value="Accept-Ranges"/>
    473   <x:anchor-alias value="Accept-Ranges-v"/>
    474473  <x:anchor-alias value="acceptable-ranges"/>
    475474<t>
     
    477476   its acceptance of range requests.
    478477</t>
    479 <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"/>
    480   <x:ref>Accept-Ranges</x:ref>     = "Accept-Ranges" ":" <x:ref>OWS</x:ref> <x:ref>Accept-Ranges-v</x:ref>
    481   <x:ref>Accept-Ranges-v</x:ref>   = <x:ref>acceptable-ranges</x:ref>
     478<figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="Accept-Ranges"/><iref primary="true" item="Grammar" subitem="acceptable-ranges"/>
     479  <x:ref>Accept-Ranges</x:ref>     = <x:ref>acceptable-ranges</x:ref>
    482480  <x:ref>acceptable-ranges</x:ref> = 1#<x:ref>range-unit</x:ref> / "none"
    483481</artwork></figure>
     
    511509  <x:anchor-alias value="byte-range-resp-spec"/>
    512510  <x:anchor-alias value="Content-Range"/>
    513   <x:anchor-alias value="Content-Range-v"/>
    514511  <x:anchor-alias value="content-range-spec"/>
    515512  <x:anchor-alias value="instance-length"/>
     
    524521   Range units are defined in <xref target="range.units"/>.
    525522</t>
    526 <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"/>
    527   <x:ref>Content-Range</x:ref> = "Content-Range" ":" <x:ref>OWS</x:ref> <x:ref>Content-Range-v</x:ref>
    528   <x:ref>Content-Range-v</x:ref> = <x:ref>content-range-spec</x:ref>
     523<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"/>
     524  <x:ref>Content-Range</x:ref> = <x:ref>content-range-spec</x:ref>
    529525 
    530526  <x:ref>content-range-spec</x:ref>      = <x:ref>byte-content-range-spec</x:ref>
     
    663659  <iref primary="true" item="Header Fields" subitem="If-Range" x:for-anchor=""/>
    664660  <x:anchor-alias value="If-Range"/>
    665   <x:anchor-alias value="If-Range-v"/>
    666661<t>
    667662   If a client has a partial copy of a representation in its cache, and wishes
     
    679674   representation".
    680675</t>
    681 <figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="If-Range"/><iref primary="true" item="Grammar" subitem="If-Range-v"/>
    682   <x:ref>If-Range</x:ref>   = "If-Range" ":" <x:ref>OWS</x:ref> <x:ref>If-Range-v</x:ref>
    683   <x:ref>If-Range-v</x:ref> = <x:ref>entity-tag</x:ref> / <x:ref>HTTP-date</x:ref>
     676<figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="If-Range"/>
     677  <x:ref>If-Range</x:ref> = <x:ref>entity-tag</x:ref> / <x:ref>HTTP-date</x:ref>
    684678</artwork></figure>
    685679<t>
     
    822816<section title="Range Retrieval Requests" anchor="range.retrieval.requests">
    823817  <x:anchor-alias value="Range"/>
    824   <x:anchor-alias value="Range-v"/>
    825818  <x:anchor-alias value="other-ranges-specifier"/>
    826819  <x:anchor-alias value="other-range-set"/>
     
    831824</t>
    832825<figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="Range"/>
    833   <x:ref>Range</x:ref>   = "Range" ":" <x:ref>OWS</x:ref> <x:ref>Range-v</x:ref>
    834   <x:ref>Range-v</x:ref> = <x:ref>byte-ranges-specifier</x:ref>
    835           / <x:ref>other-ranges-specifier</x:ref>
     826  <x:ref>Range</x:ref> = <x:ref>byte-ranges-specifier</x:ref> / <x:ref>other-ranges-specifier</x:ref>
    836827  <x:ref>other-ranges-specifier</x:ref> = <x:ref>other-range-unit</x:ref> "=" <x:ref>other-range-set</x:ref>
    837828  <x:ref>other-range-set</x:ref> = 1*<x:ref>CHAR</x:ref>
     
    13691360</t>
    13701361<t>
     1362  Change ABNF productions for header fields to only define the field value.
     1363  (<xref target="header.fields"/>)
     1364</t>
     1365<t>
    13711366  Clarify that multipart/byteranges can consist of a single part.
    13721367  (<xref target="internet.media.type.multipart.byteranges"/>)
    13731368</t>
    1374 
    13751369</section>
    13761370
     
    13811375<figure>
    13821376<artwork type="abnf" name="p5-range.parsed-abnf">
    1383 <x:ref>Accept-Ranges</x:ref> = "Accept-Ranges:" OWS Accept-Ranges-v
    1384 <x:ref>Accept-Ranges-v</x:ref> = acceptable-ranges
    1385 
    1386 <x:ref>Content-Range</x:ref> = "Content-Range:" OWS Content-Range-v
    1387 <x:ref>Content-Range-v</x:ref> = content-range-spec
     1377<x:ref>Accept-Ranges</x:ref> = acceptable-ranges
     1378
     1379<x:ref>Content-Range</x:ref> = content-range-spec
    13881380
    13891381<x:ref>HTTP-date</x:ref> = &lt;HTTP-date, defined in [Part1], Section 6.1&gt;
    13901382
    1391 <x:ref>If-Range</x:ref> = "If-Range:" OWS If-Range-v
    1392 <x:ref>If-Range-v</x:ref> = entity-tag / HTTP-date
     1383<x:ref>If-Range</x:ref> = entity-tag / HTTP-date
    13931384
    13941385<x:ref>OWS</x:ref> = &lt;OWS, defined in [Part1], Section 1.2.2&gt;
    13951386
    1396 <x:ref>Range</x:ref> = "Range:" OWS Range-v
    1397 <x:ref>Range-v</x:ref> = byte-ranges-specifier / other-ranges-specifier
     1387<x:ref>Range</x:ref> = byte-ranges-specifier / other-ranges-specifier
    13981388
    13991389<x:ref>acceptable-ranges</x:ref> = ( *( "," OWS ) range-unit *( OWS "," [ OWS
     
    15071497<section title="Since draft-ietf-httpbis-p5-range-03" anchor="changes.since.03">
    15081498<t>
     1499  None.
    15091500</t>
    15101501</section>
     
    16651656<section title="Since draft-ietf-httpbis-p5-range-13" anchor="changes.since.13">
    16661657<t>
    1667   None yet.
     1658  Closed issues:
     1659  <list style="symbols">
     1660    <t>
     1661      <eref target="http://tools.ietf.org/wg/httpbis/trac/ticket/276"/>:
     1662      "untangle ABNFs for header fields"
     1663    </t>
     1664  </list>
    16681665</t>
    16691666</section>
Note: See TracChangeset for help on using the changeset viewer.