Ignore:
Timestamp:
29/03/11 12:42:31 (10 years ago)
Author:
julian.reschke@…
Message:

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

Location:
draft-ietf-httpbis/latest
Files:
3 edited

Legend:

Unmodified
Added
Removed

  • draft-ietf-httpbis/latest/httpbis.abnf

    r1230 r1231  
    1313Accept-Ranges-v = acceptable-ranges
    1414Accept-v = [ ( "," / ( media-range [ accept-params ] ) ) *( OWS "," [ OWS media-range [ accept-params ] ] ) ]
    15 Age = "Age:" OWS Age-v
    16 Age-v = delta-seconds
     15Age = delta-seconds
    1716Allow = "Allow:" OWS Allow-v
    1817Allow-v = [ ( "," / Method ) *( OWS "," [ OWS Method ] ) ]
    1918Authorization = credentials
    2019BWS = OWS
    21 Cache-Control = "Cache-Control:" OWS Cache-Control-v
    22 Cache-Control-v = *( "," OWS ) cache-directive *( OWS "," [ OWS cache-directive ] )
     20Cache-Control = *( "," OWS ) cache-directive *( OWS "," [ OWS cache-directive ] )
    2321Chunked-Body = *chunk last-chunk trailer-part CRLF
    2422Connection = "Connection:" OWS Connection-v
    … …  
    4442Expect = "Expect:" OWS Expect-v
    4543Expect-v = *( "," OWS ) expectation *( OWS "," [ OWS expectation ] )
    46 Expires = "Expires:" OWS Expires-v
    47 Expires-v = HTTP-date
     44Expires = HTTP-date
    4845From = "From:" OWS From-v
    4946From-v = mailbox
    … …  
    7774Method = token
    7875OWS = *( [ obs-fold ] WSP )
    79 Pragma = "Pragma:" OWS Pragma-v
    80 Pragma-v = *( "," OWS ) pragma-directive *( OWS "," [ OWS pragma-directive ] )
     76Pragma = *( "," OWS ) pragma-directive *( OWS "," [ OWS pragma-directive ] )
    8177Proxy-Authenticate = *( "," OWS ) challenge *( OWS "," [ OWS challenge ] )
    8278Proxy-Authorization = credentials
    … …  
    107103User-Agent = "User-Agent:" OWS User-Agent-v
    108104User-Agent-v = product *( RWS ( product / comment ) )
    109 Vary = "Vary:" OWS Vary-v
    110 Vary-v = "*" / ( *( "," OWS ) field-name *( OWS "," [ OWS field-name ] ) )
     105Vary = "*" / ( *( "," OWS ) field-name *( OWS "," [ OWS field-name ] ) )
    111106Via = "Via:" OWS Via-v
    112107Via-v = *( "," OWS ) received-protocol RWS received-by [ RWS comment ] *( OWS "," [ OWS received-protocol RWS received-by [ RWS comment ] ] )
    113108WWW-Authenticate = *( "," OWS ) challenge *( OWS "," [ OWS challenge ] )
    114 Warning = "Warning:" OWS Warning-v
    115 Warning-v = *( "," OWS ) warning-value *( OWS "," [ OWS warning-value ] )
     109Warning = *( "," OWS ) warning-value *( OWS "," [ OWS warning-value ] )
    116110absolute-URI = <absolute-URI, defined in [RFC3986], Section 4.3>
    117111accept-ext = OWS ";" OWS token [ "=" word ]

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

    r1215 r1231  
    362362  }
    363363  @bottom-center {
    364        content: "Expires September 28, 2011";
     364       content: "Expires September 30, 2011";
    365365  }
    366366  @bottom-right {
    … …  
    408408      <meta name="dct.creator" content="Reschke, J. F.">
    409409      <meta name="dct.identifier" content="urn:ietf:id:draft-ietf-httpbis-p6-cache-latest">
    410       <meta name="dct.issued" scheme="ISO8601" content="2011-03-27">
     410      <meta name="dct.issued" scheme="ISO8601" content="2011-03-29">
    411411      <meta name="dct.replaces" content="urn:ietf:rfc:2616">
    412412      <meta name="dct.abstract" content="The Hypertext Transfer Protocol (HTTP) is an application-level protocol for distributed, collaborative, hypermedia information systems. This document is Part 6 of the seven-part specification that defines the protocol referred to as &#34;HTTP/1.1&#34; and, taken together, obsoletes RFC 2616. Part 6 defines requirements on HTTP caches and the associated header fields that control cache behavior or indicate cacheable response messages.">
    … …  
    434434            </tr>
    435435            <tr>
    436                <td class="left">Expires: September 28, 2011</td>
     436               <td class="left">Expires: September 30, 2011</td>
    437437               <td class="right">J. Mogul</td>
    438438            </tr>
    … …  
    495495            <tr>
    496496               <td class="left"></td>
    497                <td class="right">March 27, 2011</td>
     497               <td class="right">March 29, 2011</td>
    498498            </tr>
    499499         </tbody>
    … …  
    521521         in progress”.
    522522      </p>
    523       <p>This Internet-Draft will expire on September 28, 2011.</p>
     523      <p>This Internet-Draft will expire on September 30, 2011.</p>
    524524      <h1><a id="rfc.copyrightnotice" href="#rfc.copyrightnotice">Copyright Notice</a></h1>
    525525      <p>Copyright © 2011 IETF Trust and the persons identified as the document authors. All rights reserved.</p>
    … …  
    10441044         validated at the origin server. Age values are calculated as specified in <a href="#age.calculations" title="Calculating Age">Section&nbsp;2.3.2</a>.
    10451045      </p>
    1046       <div id="rfc.figure.u.7"></div><pre class="inline"><span id="rfc.iref.g.1"></span><span id="rfc.iref.g.2"></span>  <a href="#header.age" class="smpl">Age</a>   = "Age" ":" <a href="#core.rules" class="smpl">OWS</a> <a href="#header.age" class="smpl">Age-v</a>
    1047   <a href="#header.age" class="smpl">Age-v</a> = <a href="#rule.delta-seconds" class="smpl">delta-seconds</a>
     1046      <div id="rfc.figure.u.7"></div><pre class="inline"><span id="rfc.iref.g.1"></span>  <a href="#header.age" class="smpl">Age</a> = <a href="#rule.delta-seconds" class="smpl">delta-seconds</a>
    10481047</pre><div id="rule.delta-seconds">
    10491048         <p id="rfc.section.3.1.p.3">  Age field-values are non-negative integers, representing time in seconds.</p>
    10501049      </div>
    1051       <div id="rfc.figure.u.8"></div><pre class="inline"><span id="rfc.iref.g.3"></span>  <a href="#rule.delta-seconds" class="smpl">delta-seconds</a>  = 1*<a href="#notation" class="smpl">DIGIT</a>
     1050      <div id="rfc.figure.u.8"></div><pre class="inline"><span id="rfc.iref.g.2"></span>  <a href="#rule.delta-seconds" class="smpl">delta-seconds</a>  = 1*<a href="#notation" class="smpl">DIGIT</a>
    10521051</pre><p id="rfc.section.3.1.p.5">If a cache receives a value larger than the largest positive integer it can represent, or if any of its age calculations overflows,
    10531052         it <em class="bcp14">MUST</em> transmit an Age header field with a field-value of 2147483648 (2<sup>31</sup>). Recipients parsing the Age header field-value <em class="bcp14">SHOULD</em> use an arithmetic type of at least 31 bits of range.
    … …  
    10731072         cache.
    10741073      </p>
    1075       <div id="rfc.figure.u.9"></div><pre class="inline"><span id="rfc.iref.g.4"></span><span id="rfc.iref.g.5"></span><span id="rfc.iref.g.6"></span>  <a href="#header.cache-control" class="smpl">Cache-Control</a>   = "Cache-Control" ":" <a href="#core.rules" class="smpl">OWS</a> <a href="#header.cache-control" class="smpl">Cache-Control-v</a>
    1076   <a href="#header.cache-control" class="smpl">Cache-Control-v</a> = 1#<a href="#header.cache-control" class="smpl">cache-directive</a>
     1074      <div id="rfc.figure.u.9"></div><pre class="inline"><span id="rfc.iref.g.3"></span><span id="rfc.iref.g.4"></span>  <a href="#header.cache-control" class="smpl">Cache-Control</a>   = 1#<a href="#header.cache-control" class="smpl">cache-directive</a>
    10771075
    10781076  <a href="#header.cache-control" class="smpl">cache-directive</a> = <a href="#header.cache-control" class="smpl">cache-request-directive</a>
    … …  
    10811079  <a href="#header.cache-control" class="smpl">cache-extension</a> = <a href="#core.rules" class="smpl">token</a> [ "=" ( <a href="#core.rules" class="smpl">token</a> / <a href="#core.rules" class="smpl">quoted-string</a> ) ]
    10821080</pre><h3 id="rfc.section.3.2.1"><a href="#rfc.section.3.2.1">3.2.1</a>&nbsp;<a id="cache-request-directive" href="#cache-request-directive">Request Cache-Control Directives</a></h3>
    1083       <div id="rfc.figure.u.10"></div><pre class="inline"><span id="rfc.iref.g.7"></span>  <a href="#header.cache-control" class="smpl">cache-request-directive</a> =
     1081      <div id="rfc.figure.u.10"></div><pre class="inline"><span id="rfc.iref.g.5"></span>  <a href="#header.cache-control" class="smpl">cache-request-directive</a> =
    10841082       "no-cache"
    10851083     / "no-store"
    … …  
    11481146      </ul>
    11491147      <h3 id="rfc.section.3.2.2"><a href="#rfc.section.3.2.2">3.2.2</a>&nbsp;<a id="cache-response-directive" href="#cache-response-directive">Response Cache-Control Directives</a></h3>
    1150       <div id="rfc.figure.u.11"></div><pre class="inline"><span id="rfc.iref.g.8"></span>  <a href="#header.cache-control" class="smpl">cache-response-directive</a> =
     1148      <div id="rfc.figure.u.11"></div><pre class="inline"><span id="rfc.iref.g.6"></span>  <a href="#header.cache-control" class="smpl">cache-response-directive</a> =
    11511149       "public"
    11521150     / "private" [ "=" <a href="#notation" class="smpl">DQUOTE</a> 1#<a href="#abnf.dependencies" class="smpl">field-name</a> <a href="#notation" class="smpl">DQUOTE</a> ]
    … …  
    12901288      <p id="rfc.section.3.3.p.3">The field-value is an absolute date and time as defined by HTTP-date in <a href="p1-messaging.html#date.time.formats.full.date" title="Date/Time Formats: Full Date">Section 6.1</a> of <a href="#Part1" id="rfc.xref.Part1.17"><cite title="HTTP/1.1, part 1: URIs, Connections, and Message Parsing">[Part1]</cite></a>; a sender <em class="bcp14">MUST</em> use the rfc1123-date format.
    12911289      </p>
    1292       <div id="rfc.figure.u.13"></div><pre class="inline"><span id="rfc.iref.g.9"></span><span id="rfc.iref.g.10"></span>  <a href="#header.expires" class="smpl">Expires</a>   = "Expires" ":" <a href="#core.rules" class="smpl">OWS</a> <a href="#header.expires" class="smpl">Expires-v</a>
    1293   <a href="#header.expires" class="smpl">Expires-v</a> = <a href="#abnf.dependencies" class="smpl">HTTP-date</a>
     1290      <div id="rfc.figure.u.13"></div><pre class="inline"><span id="rfc.iref.g.7"></span>  <a href="#header.expires" class="smpl">Expires</a> = <a href="#abnf.dependencies" class="smpl">HTTP-date</a>
    12941291</pre><div id="rfc.figure.u.14"></div>
    12951292      <p>For example</p>  <pre class="text">  Expires: Thu, 01 Dec 1994 16:00:00 GMT
    … …  
    13091306         systems <em class="bcp14">MAY</em> require that behavior be consistent with the directives.
    13101307      </p>
    1311       <div id="rfc.figure.u.15"></div><pre class="inline"><span id="rfc.iref.g.11"></span><span id="rfc.iref.g.12"></span><span id="rfc.iref.g.13"></span><span id="rfc.iref.g.14"></span>  <a href="#header.pragma" class="smpl">Pragma</a>            = "Pragma" ":" <a href="#core.rules" class="smpl">OWS</a> <a href="#header.pragma" class="smpl">Pragma-v</a>
    1312   <a href="#header.pragma" class="smpl">Pragma-v</a>          = 1#<a href="#header.pragma" class="smpl">pragma-directive</a>
    1313   <a href="#header.pragma" class="smpl">pragma-directive</a>  = "no-cache" / <a href="#header.pragma" class="smpl">extension-pragma</a>
    1314   <a href="#header.pragma" class="smpl">extension-pragma</a>  = <a href="#core.rules" class="smpl">token</a> [ "=" ( <a href="#core.rules" class="smpl">token</a> / <a href="#core.rules" class="smpl">quoted-string</a> ) ]
     1308      <div id="rfc.figure.u.15"></div><pre class="inline"><span id="rfc.iref.g.8"></span><span id="rfc.iref.g.9"></span><span id="rfc.iref.g.10"></span>  <a href="#header.pragma" class="smpl">Pragma</a>           = 1#<a href="#header.pragma" class="smpl">pragma-directive</a>
     1309  <a href="#header.pragma" class="smpl">pragma-directive</a> = "no-cache" / <a href="#header.pragma" class="smpl">extension-pragma</a>
     1310  <a href="#header.pragma" class="smpl">extension-pragma</a> = <a href="#core.rules" class="smpl">token</a> [ "=" ( <a href="#core.rules" class="smpl">token</a> / <a href="#core.rules" class="smpl">quoted-string</a> ) ]
    13151311</pre><p id="rfc.section.3.4.p.3">When the no-cache directive is present in a request message, a cache <em class="bcp14">SHOULD</em> forward the request toward the origin server even if it has a stored copy of what is being requested. This pragma directive
    13161312         has the same semantics as the no-cache response directive (see <a href="#cache-response-directive" title="Response Cache-Control Directives">Section&nbsp;3.2.2</a>) and is defined here for backward compatibility with HTTP/1.0. A client <em class="bcp14">SHOULD</em> include both header fields when a no-cache request is sent to a server not known to be HTTP/1.1 compliant. A cache <em class="bcp14">SHOULD</em> treat "Pragma: no-cache" as if the client had sent "Cache-Control: no-cache".
    … …  
    13321328         the representation.
    13331329      </p>
    1334       <div id="rfc.figure.u.16"></div><pre class="inline"><span id="rfc.iref.g.15"></span><span id="rfc.iref.g.16"></span>  <a href="#header.vary" class="smpl">Vary</a>   = "Vary" ":" <a href="#core.rules" class="smpl">OWS</a> <a href="#header.vary" class="smpl">Vary-v</a>
    1335   <a href="#header.vary" class="smpl">Vary-v</a> = "*" / 1#<a href="#abnf.dependencies" class="smpl">field-name</a>
     1330      <div id="rfc.figure.u.16"></div><pre class="inline"><span id="rfc.iref.g.11"></span>  <a href="#header.vary" class="smpl">Vary</a> = "*" / 1#<a href="#abnf.dependencies" class="smpl">field-name</a>
    13361331</pre><p id="rfc.section.3.5.p.5">The set of header fields named by the Vary field value is known as the selecting header fields.</p>
    13371332      <p id="rfc.section.3.5.p.6">A server <em class="bcp14">SHOULD</em> include a Vary header field with any cacheable response that is subject to server-driven negotiation. Doing so allows a cache
    … …  
    13601355         be applied to response messages.
    13611356      </p>
    1362       <div id="rfc.figure.u.17"></div><pre class="inline"><span id="rfc.iref.g.17"></span><span id="rfc.iref.g.18"></span><span id="rfc.iref.g.19"></span><span id="rfc.iref.g.20"></span><span id="rfc.iref.g.21"></span><span id="rfc.iref.g.22"></span><span id="rfc.iref.g.23"></span>  <a href="#header.warning" class="smpl">Warning</a>    = "Warning" ":" <a href="#core.rules" class="smpl">OWS</a> <a href="#header.warning" class="smpl">Warning-v</a>
    1363   <a href="#header.warning" class="smpl">Warning-v</a>  = 1#<a href="#header.warning" class="smpl">warning-value</a>
     1357      <div id="rfc.figure.u.17"></div><pre class="inline"><span id="rfc.iref.g.12"></span><span id="rfc.iref.g.13"></span><span id="rfc.iref.g.14"></span><span id="rfc.iref.g.15"></span><span id="rfc.iref.g.16"></span><span id="rfc.iref.g.17"></span>  <a href="#header.warning" class="smpl">Warning</a>       = 1#<a href="#header.warning" class="smpl">warning-value</a>
    13641358 
    13651359  <a href="#header.warning" class="smpl">warning-value</a> = <a href="#header.warning" class="smpl">warn-code</a> <a href="#notation" class="smpl">SP</a> <a href="#header.warning" class="smpl">warn-agent</a> <a href="#notation" class="smpl">SP</a> <a href="#header.warning" class="smpl">warn-text</a>
    … …  
    17061700      <p id="rfc.section.A.p.3">Clarify denial of service attack avoidance requirement. (<a href="#invalidation.after.updates.or.deletions" title="Request Methods that Invalidate">Section&nbsp;2.5</a>)
    17071701      </p>
    1708       <p id="rfc.section.A.p.4">Do not mention RFC 2047 encoding and multiple languages in Warning header fields anymore, as these aspects never were implemented.
     1702      <p id="rfc.section.A.p.4">Change ABNF productions for header fields to only define the field value. (<a href="#header.fields" title="Header Field Definitions">Section&nbsp;3</a>)
     1703      </p>
     1704      <p id="rfc.section.A.p.5">Do not mention RFC 2047 encoding and multiple languages in Warning header fields anymore, as these aspects never were implemented.
    17091705         (<a href="#header.warning" id="rfc.xref.header.warning.4" title="Warning">Section&nbsp;3.6</a>)
    17101706      </p>
    17111707      <h1 id="rfc.section.B"><a href="#rfc.section.B">B.</a>&nbsp;<a id="collected.abnf" href="#collected.abnf">Collected ABNF</a></h1>
    1712       <div id="rfc.figure.u.18"></div> <pre class="inline"><a href="#header.age" class="smpl">Age</a> = "Age:" OWS Age-v
    1713 <a href="#header.age" class="smpl">Age-v</a> = delta-seconds
    1714 
    1715 <a href="#header.cache-control" class="smpl">Cache-Control</a> = "Cache-Control:" OWS Cache-Control-v
    1716 <a href="#header.cache-control" class="smpl">Cache-Control-v</a> = *( "," OWS ) cache-directive *( OWS "," [ OWS
     1708      <div id="rfc.figure.u.18"></div> <pre class="inline"><a href="#header.age" class="smpl">Age</a> = delta-seconds
     1709
     1710<a href="#header.cache-control" class="smpl">Cache-Control</a> = *( "," OWS ) cache-directive *( OWS "," [ OWS
    17171711 cache-directive ] )
    17181712
    1719 <a href="#header.expires" class="smpl">Expires</a> = "Expires:" OWS Expires-v
    1720 <a href="#header.expires" class="smpl">Expires-v</a> = HTTP-date
     1713<a href="#header.expires" class="smpl">Expires</a> = HTTP-date
    17211714
    17221715<a href="#abnf.dependencies" class="smpl">HTTP-date</a> = &lt;HTTP-date, defined in [Part1], Section 6.1&gt;
    … …  
    17241717<a href="#core.rules" class="smpl">OWS</a> = &lt;OWS, defined in [Part1], Section 1.2.2&gt;
    17251718
    1726 <a href="#header.pragma" class="smpl">Pragma</a> = "Pragma:" OWS Pragma-v
    1727 <a href="#header.pragma" class="smpl">Pragma-v</a> = *( "," OWS ) pragma-directive *( OWS "," [ OWS
     1719<a href="#header.pragma" class="smpl">Pragma</a> = *( "," OWS ) pragma-directive *( OWS "," [ OWS
    17281720 pragma-directive ] )
    17291721
    1730 <a href="#header.vary" class="smpl">Vary</a> = "Vary:" OWS Vary-v
    1731 <a href="#header.vary" class="smpl">Vary-v</a> = "*" / ( *( "," OWS ) field-name *( OWS "," [ OWS field-name
    1732  ] ) )
    1733 
    1734 <a href="#header.warning" class="smpl">Warning</a> = "Warning:" OWS Warning-v
    1735 <a href="#header.warning" class="smpl">Warning-v</a> = *( "," OWS ) warning-value *( OWS "," [ OWS warning-value
    1736  ] )
     1722<a href="#header.vary" class="smpl">Vary</a> = "*" / ( *( "," OWS ) field-name *( OWS "," [ OWS field-name ]
     1723 ) )
     1724
     1725<a href="#header.warning" class="smpl">Warning</a> = *( "," OWS ) warning-value *( OWS "," [ OWS warning-value ]
     1726 )
    17371727
    17381728<a href="#header.cache-control" class="smpl">cache-directive</a> = cache-request-directive / cache-response-directive
    … …  
    19501940      </ul>
    19511941      <h2 id="rfc.section.C.15"><a href="#rfc.section.C.15">C.15</a>&nbsp;<a id="changes.since.13" href="#changes.since.13">Since draft-ietf-httpbis-p6-cache-13</a></h2>
    1952       <p id="rfc.section.C.15.p.1">None yet.</p>
     1942      <p id="rfc.section.C.15.p.1">Closed issues: </p>
     1943      <ul>
     1944         <li> &lt;<a href="http://tools.ietf.org/wg/httpbis/trac/ticket/276">http://tools.ietf.org/wg/httpbis/trac/ticket/276</a>&gt;: "untangle ABNFs for header fields"
     1945         </li>
     1946      </ul>
    19531947      <h1 id="rfc.index"><a href="#rfc.index">Index</a></h1>
    19541948      <p class="noprint"><a href="#rfc.index.A">A</a> <a href="#rfc.index.C">C</a> <a href="#rfc.index.E">E</a> <a href="#rfc.index.F">F</a> <a href="#rfc.index.G">G</a> <a href="#rfc.index.H">H</a> <a href="#rfc.index.M">M</a> <a href="#rfc.index.N">N</a> <a href="#rfc.index.O">O</a> <a href="#rfc.index.P">P</a> <a href="#rfc.index.R">R</a> <a href="#rfc.index.S">S</a> <a href="#rfc.index.V">V</a> <a href="#rfc.index.W">W</a>
    … …  
    19981992                     <ul>
    19991993                        <li><tt>Age</tt>&nbsp;&nbsp;<a href="#rfc.iref.g.1"><b>3.1</b></a></li>
    2000                         <li><tt>Age-v</tt>&nbsp;&nbsp;<a href="#rfc.iref.g.2"><b>3.1</b></a></li>
    2001                         <li><tt>Cache-Control</tt>&nbsp;&nbsp;<a href="#rfc.iref.g.4"><b>3.2</b></a></li>
    2002                         <li><tt>Cache-Control-v</tt>&nbsp;&nbsp;<a href="#rfc.iref.g.5"><b>3.2</b></a></li>
    2003                         <li><tt>cache-extension</tt>&nbsp;&nbsp;<a href="#rfc.iref.g.6"><b>3.2</b></a></li>
    2004                         <li><tt>cache-request-directive</tt>&nbsp;&nbsp;<a href="#rfc.iref.g.7"><b>3.2.1</b></a></li>
    2005                         <li><tt>cache-response-directive</tt>&nbsp;&nbsp;<a href="#rfc.iref.g.8"><b>3.2.2</b></a></li>
    2006                         <li><tt>delta-seconds</tt>&nbsp;&nbsp;<a href="#rfc.iref.g.3"><b>3.1</b></a></li>
    2007                         <li><tt>Expires</tt>&nbsp;&nbsp;<a href="#rfc.iref.g.9"><b>3.3</b></a></li>
    2008                         <li><tt>Expires-v</tt>&nbsp;&nbsp;<a href="#rfc.iref.g.10"><b>3.3</b></a></li>
    2009                         <li><tt>extension-pragma</tt>&nbsp;&nbsp;<a href="#rfc.iref.g.14"><b>3.4</b></a></li>
    2010                         <li><tt>Pragma</tt>&nbsp;&nbsp;<a href="#rfc.iref.g.11"><b>3.4</b></a></li>
    2011                         <li><tt>pragma-directive</tt>&nbsp;&nbsp;<a href="#rfc.iref.g.13"><b>3.4</b></a></li>
    2012                         <li><tt>Pragma-v</tt>&nbsp;&nbsp;<a href="#rfc.iref.g.12"><b>3.4</b></a></li>
    2013                         <li><tt>Vary</tt>&nbsp;&nbsp;<a href="#rfc.iref.g.15"><b>3.5</b></a></li>
    2014                         <li><tt>Vary-v</tt>&nbsp;&nbsp;<a href="#rfc.iref.g.16"><b>3.5</b></a></li>
    2015                         <li><tt>warn-agent</tt>&nbsp;&nbsp;<a href="#rfc.iref.g.21"><b>3.6</b></a></li>
    2016                         <li><tt>warn-code</tt>&nbsp;&nbsp;<a href="#rfc.iref.g.20"><b>3.6</b></a></li>
    2017                         <li><tt>warn-date</tt>&nbsp;&nbsp;<a href="#rfc.iref.g.23"><b>3.6</b></a></li>
    2018                         <li><tt>warn-text</tt>&nbsp;&nbsp;<a href="#rfc.iref.g.22"><b>3.6</b></a></li>
    2019                         <li><tt>Warning</tt>&nbsp;&nbsp;<a href="#rfc.iref.g.17"><b>3.6</b></a></li>
    2020                         <li><tt>Warning-v</tt>&nbsp;&nbsp;<a href="#rfc.iref.g.18"><b>3.6</b></a></li>
    2021                         <li><tt>warning-value</tt>&nbsp;&nbsp;<a href="#rfc.iref.g.19"><b>3.6</b></a></li>
     1994                        <li><tt>Cache-Control</tt>&nbsp;&nbsp;<a href="#rfc.iref.g.3"><b>3.2</b></a></li>
     1995                        <li><tt>cache-extension</tt>&nbsp;&nbsp;<a href="#rfc.iref.g.4"><b>3.2</b></a></li>
     1996                        <li><tt>cache-request-directive</tt>&nbsp;&nbsp;<a href="#rfc.iref.g.5"><b>3.2.1</b></a></li>
     1997                        <li><tt>cache-response-directive</tt>&nbsp;&nbsp;<a href="#rfc.iref.g.6"><b>3.2.2</b></a></li>
     1998                        <li><tt>delta-seconds</tt>&nbsp;&nbsp;<a href="#rfc.iref.g.2"><b>3.1</b></a></li>
     1999                        <li><tt>Expires</tt>&nbsp;&nbsp;<a href="#rfc.iref.g.7"><b>3.3</b></a></li>
     2000                        <li><tt>extension-pragma</tt>&nbsp;&nbsp;<a href="#rfc.iref.g.10"><b>3.4</b></a></li>
     2001                        <li><tt>Pragma</tt>&nbsp;&nbsp;<a href="#rfc.iref.g.8"><b>3.4</b></a></li>
     2002                        <li><tt>pragma-directive</tt>&nbsp;&nbsp;<a href="#rfc.iref.g.9"><b>3.4</b></a></li>
     2003                        <li><tt>Vary</tt>&nbsp;&nbsp;<a href="#rfc.iref.g.11"><b>3.5</b></a></li>
     2004                        <li><tt>warn-agent</tt>&nbsp;&nbsp;<a href="#rfc.iref.g.15"><b>3.6</b></a></li>
     2005                        <li><tt>warn-code</tt>&nbsp;&nbsp;<a href="#rfc.iref.g.14"><b>3.6</b></a></li>
     2006                        <li><tt>warn-date</tt>&nbsp;&nbsp;<a href="#rfc.iref.g.17"><b>3.6</b></a></li>
     2007                        <li><tt>warn-text</tt>&nbsp;&nbsp;<a href="#rfc.iref.g.16"><b>3.6</b></a></li>
     2008                        <li><tt>Warning</tt>&nbsp;&nbsp;<a href="#rfc.iref.g.12"><b>3.6</b></a></li>
     2009                        <li><tt>warning-value</tt>&nbsp;&nbsp;<a href="#rfc.iref.g.13"><b>3.6</b></a></li>
    20222010                     </ul>
    20232011                  </li>

  • 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.