Ignore:
Timestamp:
Mar 29, 2011, 5:42:31 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/p6-cache.xml

    r1184 r1231  
    10371037   <iref item="Header Fields" primary="true" subitem="Age" x:for-anchor="" />
    10381038   <x:anchor-alias value="Age"/>
    1039    <x:anchor-alias value="Age-v"/>
    10401039   <x:anchor-alias value="age-value"/>
    10411040<t>
    … …  
    10451044   target="age.calculations" />.
    10461045</t>
    1047 <figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="Age"/><iref primary="true" item="Grammar" subitem="Age-v"/>
    1048   <x:ref>Age</x:ref>   = "Age" ":" <x:ref>OWS</x:ref> <x:ref>Age-v</x:ref>
    1049   <x:ref>Age-v</x:ref> = <x:ref>delta-seconds</x:ref>
     1046<figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="Age"/>
     1047  <x:ref>Age</x:ref> = <x:ref>delta-seconds</x:ref>
    10501048</artwork></figure>
    10511049<t anchor="rule.delta-seconds">
    … …  
    10751073      x:for-anchor="" />
    10761074   <x:anchor-alias value="Cache-Control"/>
    1077    <x:anchor-alias value="Cache-Control-v"/>
    10781075   <x:anchor-alias value="cache-directive"/>
    10791076   <x:anchor-alias value="cache-extension"/>
    … …  
    11061103   target a directive to a specific cache.
    11071104</t>
    1108 <figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="Cache-Control"/><iref primary="true" item="Grammar" subitem="Cache-Control-v"/><iref primary="true" item="Grammar" subitem="cache-extension"/>
    1109   <x:ref>Cache-Control</x:ref>   = "Cache-Control" ":" <x:ref>OWS</x:ref> <x:ref>Cache-Control-v</x:ref>
    1110   <x:ref>Cache-Control-v</x:ref> = 1#<x:ref>cache-directive</x:ref>
     1105<figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="Cache-Control"/><iref primary="true" item="Grammar" subitem="cache-extension"/>
     1106  <x:ref>Cache-Control</x:ref>   = 1#<x:ref>cache-directive</x:ref>
    11111107
    11121108  <x:ref>cache-directive</x:ref> = <x:ref>cache-request-directive</x:ref>
    … …  
    14561452   <iref item="Header Fields" primary="true" subitem="Expires" x:for-anchor="" />
    14571453   <x:anchor-alias value="Expires"/>
    1458    <x:anchor-alias value="Expires-v"/>
    14591454<t>
    14601455   The "Expires" header field gives the date/time after which the
    … …  
    14701465   &full-date;; a sender &MUST; use the rfc1123-date format.
    14711466</t>
    1472 <figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="Expires"/><iref primary="true" item="Grammar" subitem="Expires-v"/>
    1473   <x:ref>Expires</x:ref>   = "Expires" ":" <x:ref>OWS</x:ref> <x:ref>Expires-v</x:ref>
    1474   <x:ref>Expires-v</x:ref> = <x:ref>HTTP-date</x:ref>
     1467<figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="Expires"/>
     1468  <x:ref>Expires</x:ref> = <x:ref>HTTP-date</x:ref>
    14751469</artwork></figure>
    14761470<figure>
    … …  
    15031497   <x:anchor-alias value="extension-pragma"/>
    15041498   <x:anchor-alias value="Pragma"/>
    1505    <x:anchor-alias value="Pragma-v"/>
    15061499   <x:anchor-alias value="pragma-directive"/>
    15071500<t>
    … …  
    15121505   that behavior be consistent with the directives.
    15131506</t>
    1514 <figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="Pragma"/><iref primary="true" item="Grammar" subitem="Pragma-v"/><iref primary="true" item="Grammar" subitem="pragma-directive"/><iref primary="true" item="Grammar" subitem="extension-pragma"/>
    1515   <x:ref>Pragma</x:ref>            = "Pragma" ":" <x:ref>OWS</x:ref> <x:ref>Pragma-v</x:ref>
    1516   <x:ref>Pragma-v</x:ref>          = 1#<x:ref>pragma-directive</x:ref>
    1517   <x:ref>pragma-directive</x:ref>  = "no-cache" / <x:ref>extension-pragma</x:ref>
    1518   <x:ref>extension-pragma</x:ref>  = <x:ref>token</x:ref> [ "=" ( <x:ref>token</x:ref> / <x:ref>quoted-string</x:ref> ) ]
     1507<figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="Pragma"/><iref primary="true" item="Grammar" subitem="pragma-directive"/><iref primary="true" item="Grammar" subitem="extension-pragma"/>
     1508  <x:ref>Pragma</x:ref>           = 1#<x:ref>pragma-directive</x:ref>
     1509  <x:ref>pragma-directive</x:ref> = "no-cache" / <x:ref>extension-pragma</x:ref>
     1510  <x:ref>extension-pragma</x:ref> = <x:ref>token</x:ref> [ "=" ( <x:ref>token</x:ref> / <x:ref>quoted-string</x:ref> ) ]
    15191511</artwork></figure>
    15201512<t>
    … …  
    15461538   <iref item="Header Fields" primary="true" subitem="Vary" x:for-anchor="" />
    15471539   <x:anchor-alias value="Vary"/>
    1548    <x:anchor-alias value="Vary-v"/>
    15491540<t>
    15501541   The "Vary" header field conveys the set of header fields
    … …  
    15631554   agent about the criteria that were used to select the representation.
    15641555</t>
    1565 <figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="Vary"/><iref primary="true" item="Grammar" subitem="Vary-v"/>
    1566   <x:ref>Vary</x:ref>   = "Vary" ":" <x:ref>OWS</x:ref> <x:ref>Vary-v</x:ref>
    1567   <x:ref>Vary-v</x:ref> = "*" / 1#<x:ref>field-name</x:ref>
     1556<figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="Vary"/>
     1557  <x:ref>Vary</x:ref> = "*" / 1#<x:ref>field-name</x:ref>
    15681558</artwork></figure>
    15691559<t>
    … …  
    15981588   <iref item="Header Fields" primary="true" subitem="Warning" x:for-anchor="" />
    15991589   <x:anchor-alias value="Warning"/>
    1600    <x:anchor-alias value="Warning-v"/>
    16011590   <x:anchor-alias value="warning-value"/>
    16021591   <x:anchor-alias value="warn-agent"/>
    … …  
    16211610   messages.
    16221611</t>
    1623 <figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="Warning"/><iref primary="true" item="Grammar" subitem="Warning-v"/><iref primary="true" item="Grammar" subitem="warning-value"/><iref primary="true" item="Grammar" subitem="warn-code"/><iref primary="true" item="Grammar" subitem="warn-agent"/><iref primary="true" item="Grammar" subitem="warn-text"/><iref primary="true" item="Grammar" subitem="warn-date"/>
    1624   <x:ref>Warning</x:ref>    = "Warning" ":" <x:ref>OWS</x:ref> <x:ref>Warning-v</x:ref>
    1625   <x:ref>Warning-v</x:ref>  = 1#<x:ref>warning-value</x:ref>
     1612<figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="Warning"/><iref primary="true" item="Grammar" subitem="warning-value"/><iref primary="true" item="Grammar" subitem="warn-code"/><iref primary="true" item="Grammar" subitem="warn-agent"/><iref primary="true" item="Grammar" subitem="warn-text"/><iref primary="true" item="Grammar" subitem="warn-date"/>
     1613  <x:ref>Warning</x:ref>       = 1#<x:ref>warning-value</x:ref>
    16261614 
    16271615  <x:ref>warning-value</x:ref> = <x:ref>warn-code</x:ref> <x:ref>SP</x:ref> <x:ref>warn-agent</x:ref> <x:ref>SP</x:ref> <x:ref>warn-text</x:ref>
    … …  
    23032291</t>
    23042292<t>
     2293  Change ABNF productions for header fields to only define the field value.
     2294  (<xref target="header.fields"/>)
     2295</t>
     2296<t>
    23052297  Do not mention RFC 2047 encoding and multiple languages in Warning header fields
    23062298  anymore, as these aspects never were implemented.
    … …  
    23132305<figure>
    23142306<artwork type="abnf" name="p6-cache.parsed-abnf">
    2315 <x:ref>Age</x:ref> = "Age:" OWS Age-v
    2316 <x:ref>Age-v</x:ref> = delta-seconds
    2317 
    2318 <x:ref>Cache-Control</x:ref> = "Cache-Control:" OWS Cache-Control-v
    2319 <x:ref>Cache-Control-v</x:ref> = *( "," OWS ) cache-directive *( OWS "," [ OWS
     2307<x:ref>Age</x:ref> = delta-seconds
     2308
     2309<x:ref>Cache-Control</x:ref> = *( "," OWS ) cache-directive *( OWS "," [ OWS
    23202310 cache-directive ] )
    23212311
    2322 <x:ref>Expires</x:ref> = "Expires:" OWS Expires-v
    2323 <x:ref>Expires-v</x:ref> = HTTP-date
     2312<x:ref>Expires</x:ref> = HTTP-date
    23242313
    23252314<x:ref>HTTP-date</x:ref> = &lt;HTTP-date, defined in [Part1], Section 6.1&gt;
    … …  
    23272316<x:ref>OWS</x:ref> = &lt;OWS, defined in [Part1], Section 1.2.2&gt;
    23282317
    2329 <x:ref>Pragma</x:ref> = "Pragma:" OWS Pragma-v
    2330 <x:ref>Pragma-v</x:ref> = *( "," OWS ) pragma-directive *( OWS "," [ OWS
     2318<x:ref>Pragma</x:ref> = *( "," OWS ) pragma-directive *( OWS "," [ OWS
    23312319 pragma-directive ] )
    23322320
    2333 <x:ref>Vary</x:ref> = "Vary:" OWS Vary-v
    2334 <x:ref>Vary-v</x:ref> = "*" / ( *( "," OWS ) field-name *( OWS "," [ OWS field-name
    2335  ] ) )
    2336 
    2337 <x:ref>Warning</x:ref> = "Warning:" OWS Warning-v
    2338 <x:ref>Warning-v</x:ref> = *( "," OWS ) warning-value *( OWS "," [ OWS warning-value
    2339  ] )
     2321<x:ref>Vary</x:ref> = "*" / ( *( "," OWS ) field-name *( OWS "," [ OWS field-name ]
     2322 ) )
     2323
     2324<x:ref>Warning</x:ref> = *( "," OWS ) warning-value *( OWS "," [ OWS warning-value ]
     2325 )
    23402326
    23412327<x:ref>cache-directive</x:ref> = cache-request-directive / cache-response-directive
    … …  
    26832669<section title="Since draft-ietf-httpbis-p6-cache-13" anchor="changes.since.13">
    26842670<t>
    2685   None yet.
     2671  Closed issues:
     2672  <list style="symbols">
     2673    <t>
     2674      <eref target="http://tools.ietf.org/wg/httpbis/trac/ticket/276"/>:
     2675      "untangle ABNFs for header fields"
     2676    </t>
     2677  </list>
    26862678</t>
    26872679</section>
Note: See TracChangeset for help on using the changeset viewer.