Ignore:
Timestamp:
Jan 1, 2008, 9:15:17 AM (12 years ago)
Author:
julian.reschke@…
Message:

Consistent indentation for all ABNF rules (addresses #36)

File:
1 edited

Legend:

Unmodified
Added
Removed
  • draft-ietf-httpbis/latest/p6-cache.html

    r131 r135  
    648648         the time that the message was received.
    649649      </p>
    650       <div id="rfc.figure.u.1"></div><pre class="inline"><span id="rfc.iref.g.1"></span>    delta-seconds  = 1*DIGIT
     650      <div id="rfc.figure.u.1"></div><pre class="inline"><span id="rfc.iref.g.1"></span>  delta-seconds  = 1*DIGIT
    651651</pre><h1 id="rfc.section.2"><a href="#rfc.section.2">2.</a>&nbsp;<a id="caching" href="#caching">Caching in HTTP</a></h1>
    652652      <h2 id="rfc.section.2.1"><a href="#rfc.section.2.1">2.1</a>&nbsp;<a id="caching.overview" href="#caching.overview">Overview</a></h2>
     
    12281228         are calculated as specified in <a href="#age.calculations" title="Age Calculations">Section&nbsp;2.2.3</a>.
    12291229      </p>
    1230       <div id="rfc.figure.u.10"></div><pre class="inline"><span id="rfc.iref.g.2"></span><span id="rfc.iref.g.3"></span>        Age = "Age" ":" age-value
    1231         age-value = delta-seconds
     1230      <div id="rfc.figure.u.10"></div><pre class="inline"><span id="rfc.iref.g.2"></span><span id="rfc.iref.g.3"></span>  Age = "Age" ":" age-value
     1231  age-value = delta-seconds
    12321232</pre><p id="rfc.section.3.1.p.3">Age values are non-negative decimal integers, representing time in seconds.</p>
    12331233      <p id="rfc.section.3.1.p.4">If a cache receives a value larger than the largest positive integer it can represent, or if any of its age calculations overflows,
     
    12501250         a specific cache.
    12511251      </p>
    1252       <div id="rfc.figure.u.11"></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><span id="rfc.iref.g.7"></span><span id="rfc.iref.g.8"></span>   Cache-Control   = "Cache-Control" ":" 1#cache-directive
     1252      <div id="rfc.figure.u.11"></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><span id="rfc.iref.g.7"></span><span id="rfc.iref.g.8"></span>  Cache-Control   = "Cache-Control" ":" 1#cache-directive
    12531253
    1254    cache-directive = cache-request-directive
    1255         | cache-response-directive
     1254  cache-directive = cache-request-directive
     1255       | cache-response-directive
    12561256
    1257    cache-request-directive =
    1258           "no-cache"                          ; <a href="#what.is.cacheable" title="What is Cacheable">Section&nbsp;3.2.1</a>
    1259         | "no-store"                          ; <a href="#what.may.be.stored.by.caches" title="What May be Stored by Caches">Section&nbsp;3.2.2</a>
    1260         | "max-age" "=" delta-seconds         ; <a href="#modifications.of.the.basic.expiration.mechanism" title="Modifications of the Basic Expiration Mechanism">Section&nbsp;3.2.3</a>, <a href="#cache.revalidation.and.reload.controls" title="Cache Revalidation and Reload Controls">3.2.4</a>
    1261         | "max-stale" [ "=" delta-seconds ]   ; <a href="#modifications.of.the.basic.expiration.mechanism" title="Modifications of the Basic Expiration Mechanism">Section&nbsp;3.2.3</a>
    1262         | "min-fresh" "=" delta-seconds       ; <a href="#modifications.of.the.basic.expiration.mechanism" title="Modifications of the Basic Expiration Mechanism">Section&nbsp;3.2.3</a>
    1263         | "no-transform"                      ; <a href="#no-transform.directive" title="No-Transform Directive">Section&nbsp;3.2.5</a>
    1264         | "only-if-cached"                    ; <a href="#cache.revalidation.and.reload.controls" title="Cache Revalidation and Reload Controls">Section&nbsp;3.2.4</a>
    1265         | cache-extension                     ; <a href="#cache.control.extensions" title="Cache Control Extensions">Section&nbsp;3.2.6</a>
     1257  cache-request-directive =
     1258         "no-cache"                          ; <a href="#what.is.cacheable" title="What is Cacheable">Section&nbsp;3.2.1</a>
     1259       | "no-store"                          ; <a href="#what.may.be.stored.by.caches" title="What May be Stored by Caches">Section&nbsp;3.2.2</a>
     1260       | "max-age" "=" delta-seconds         ; <a href="#modifications.of.the.basic.expiration.mechanism" title="Modifications of the Basic Expiration Mechanism">Section&nbsp;3.2.3</a>, <a href="#cache.revalidation.and.reload.controls" title="Cache Revalidation and Reload Controls">3.2.4</a>
     1261       | "max-stale" [ "=" delta-seconds ]   ; <a href="#modifications.of.the.basic.expiration.mechanism" title="Modifications of the Basic Expiration Mechanism">Section&nbsp;3.2.3</a>
     1262       | "min-fresh" "=" delta-seconds       ; <a href="#modifications.of.the.basic.expiration.mechanism" title="Modifications of the Basic Expiration Mechanism">Section&nbsp;3.2.3</a>
     1263       | "no-transform"                      ; <a href="#no-transform.directive" title="No-Transform Directive">Section&nbsp;3.2.5</a>
     1264       | "only-if-cached"                    ; <a href="#cache.revalidation.and.reload.controls" title="Cache Revalidation and Reload Controls">Section&nbsp;3.2.4</a>
     1265       | cache-extension                     ; <a href="#cache.control.extensions" title="Cache Control Extensions">Section&nbsp;3.2.6</a>
    12661266
    1267     cache-response-directive =
    1268           "public"                               ; <a href="#what.is.cacheable" title="What is Cacheable">Section&nbsp;3.2.1</a>
    1269         | "private" [ "=" &lt;"&gt; 1#field-name &lt;"&gt; ] ; <a href="#what.is.cacheable" title="What is Cacheable">Section&nbsp;3.2.1</a>
    1270         | "no-cache" [ "=" &lt;"&gt; 1#field-name &lt;"&gt; ]; <a href="#what.is.cacheable" title="What is Cacheable">Section&nbsp;3.2.1</a>
    1271         | "no-store"                             ; <a href="#what.may.be.stored.by.caches" title="What May be Stored by Caches">Section&nbsp;3.2.2</a>
    1272         | "no-transform"                         ; <a href="#no-transform.directive" title="No-Transform Directive">Section&nbsp;3.2.5</a>
    1273         | "must-revalidate"                      ; <a href="#cache.revalidation.and.reload.controls" title="Cache Revalidation and Reload Controls">Section&nbsp;3.2.4</a>
    1274         | "proxy-revalidate"                     ; <a href="#cache.revalidation.and.reload.controls" title="Cache Revalidation and Reload Controls">Section&nbsp;3.2.4</a>
    1275         | "max-age" "=" delta-seconds            ; <a href="#modifications.of.the.basic.expiration.mechanism" title="Modifications of the Basic Expiration Mechanism">Section&nbsp;3.2.3</a>
    1276         | "s-maxage" "=" delta-seconds           ; <a href="#modifications.of.the.basic.expiration.mechanism" title="Modifications of the Basic Expiration Mechanism">Section&nbsp;3.2.3</a>
    1277         | cache-extension                        ; <a href="#cache.control.extensions" title="Cache Control Extensions">Section&nbsp;3.2.6</a>
     1267  cache-response-directive =
     1268         "public"                               ; <a href="#what.is.cacheable" title="What is Cacheable">Section&nbsp;3.2.1</a>
     1269       | "private" [ "=" &lt;"&gt; 1#field-name &lt;"&gt; ] ; <a href="#what.is.cacheable" title="What is Cacheable">Section&nbsp;3.2.1</a>
     1270       | "no-cache" [ "=" &lt;"&gt; 1#field-name &lt;"&gt; ]; <a href="#what.is.cacheable" title="What is Cacheable">Section&nbsp;3.2.1</a>
     1271       | "no-store"                             ; <a href="#what.may.be.stored.by.caches" title="What May be Stored by Caches">Section&nbsp;3.2.2</a>
     1272       | "no-transform"                         ; <a href="#no-transform.directive" title="No-Transform Directive">Section&nbsp;3.2.5</a>
     1273       | "must-revalidate"                      ; <a href="#cache.revalidation.and.reload.controls" title="Cache Revalidation and Reload Controls">Section&nbsp;3.2.4</a>
     1274       | "proxy-revalidate"                     ; <a href="#cache.revalidation.and.reload.controls" title="Cache Revalidation and Reload Controls">Section&nbsp;3.2.4</a>
     1275       | "max-age" "=" delta-seconds            ; <a href="#modifications.of.the.basic.expiration.mechanism" title="Modifications of the Basic Expiration Mechanism">Section&nbsp;3.2.3</a>
     1276       | "s-maxage" "=" delta-seconds           ; <a href="#modifications.of.the.basic.expiration.mechanism" title="Modifications of the Basic Expiration Mechanism">Section&nbsp;3.2.3</a>
     1277       | cache-extension                        ; <a href="#cache.control.extensions" title="Cache Control Extensions">Section&nbsp;3.2.6</a>
    12781278
    1279    cache-extension = token [ "=" ( token | quoted-string ) ]
     1279  cache-extension = token [ "=" ( token | quoted-string ) ]
    12801280</pre><p id="rfc.section.3.2.p.4">When a directive appears without any 1#field-name parameter, the directive applies to the entire request or response. When
    12811281         such a directive appears with a 1#field-name parameter, it applies only to the named field or fields, and not to the rest
     
    15541554      <p id="rfc.section.3.3.p.3">The format is an absolute date and time as defined by HTTP-date in <a href="p1-messaging.html#full.date" title="Full Date">Section 3.3.1</a> of <a href="#Part1" id="rfc.xref.Part1.6"><cite title="HTTP/1.1, part 1: URIs, Connections, and Message Parsing">[Part1]</cite></a>; it <em class="bcp14">MUST</em> be sent in rfc1123-date format.
    15551555      </p>
    1556       <div id="rfc.figure.u.13"></div><pre class="inline"><span id="rfc.iref.g.9"></span>   Expires = "Expires" ":" HTTP-date
     1556      <div id="rfc.figure.u.13"></div><pre class="inline"><span id="rfc.iref.g.9"></span>  Expires = "Expires" ":" HTTP-date
    15571557</pre><p id="rfc.section.3.3.p.5">An example of its use is</p>
    15581558      <div id="rfc.figure.u.14"></div><pre class="text">   Expires: Thu, 01 Dec 1994 16:00:00 GMT
     
    15811581         systems <em class="bcp14">MAY</em> require that behavior be consistent with the directives.
    15821582      </p>
    1583       <div id="rfc.figure.u.15"></div><pre class="inline"><span id="rfc.iref.g.10"></span><span id="rfc.iref.g.11"></span><span id="rfc.iref.g.12"></span>    Pragma            = "Pragma" ":" 1#pragma-directive
    1584     pragma-directive  = "no-cache" | extension-pragma
    1585     extension-pragma  = token [ "=" ( token | quoted-string ) ]
     1583      <div id="rfc.figure.u.15"></div><pre class="inline"><span id="rfc.iref.g.10"></span><span id="rfc.iref.g.11"></span><span id="rfc.iref.g.12"></span>  Pragma            = "Pragma" ":" 1#pragma-directive
     1584  pragma-directive  = "no-cache" | extension-pragma
     1585  extension-pragma  = token [ "=" ( token | quoted-string ) ]
    15861586</pre><p id="rfc.section.3.4.p.3">When the no-cache directive is present in a request message, an application <em class="bcp14">SHOULD</em> forward the request toward the origin server even if it has a cached copy of what is being requested. This pragma directive
    15871587         has the same semantics as the no-cache cache-directive (see <a href="#header.cache-control" id="rfc.xref.header.cache-control.10" title="Cache-Control">Section&nbsp;3.2</a>) and is defined here for backward compatibility with HTTP/1.0. Clients <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.
     
    16081608         appropriate representation. See <a href="#caching.negotiated.responses" title="Caching Negotiated Responses">Section&nbsp;2.6</a> for use of the Vary header field by caches.
    16091609      </p>
    1610       <div id="rfc.figure.u.16"></div><pre class="inline"><span id="rfc.iref.g.13"></span>    Vary  = "Vary" ":" ( "*" | 1#field-name )
     1610      <div id="rfc.figure.u.16"></div><pre class="inline"><span id="rfc.iref.g.13"></span>  Vary  = "Vary" ":" ( "*" | 1#field-name )
    16111611</pre><p id="rfc.section.3.5.p.3">An HTTP/1.1 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
    16121612         to properly interpret future requests on that resource and informs the user agent about the presence of negotiation on that
     
    16331633      </p>
    16341634      <p id="rfc.section.3.6.p.2">Warning headers are sent with responses using:</p>
    1635       <div id="rfc.figure.u.17"></div><pre class="inline"><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><span id="rfc.iref.g.18"></span><span id="rfc.iref.g.19"></span>    Warning    = "Warning" ":" 1#warning-value
    1636 
    1637     warning-value = warn-code SP warn-agent SP warn-text
    1638                                           [SP warn-date]
    1639 
    1640     warn-code  = 3DIGIT
    1641     warn-agent = ( host [ ":" port ] ) | pseudonym
    1642                     ; the name or pseudonym of the server adding
    1643                     ; the Warning header, for use in debugging
    1644     warn-text  = quoted-string
    1645     warn-date  = &lt;"&gt; HTTP-date &lt;"&gt;
     1635      <div id="rfc.figure.u.17"></div><pre class="inline"><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><span id="rfc.iref.g.18"></span><span id="rfc.iref.g.19"></span>  Warning    = "Warning" ":" 1#warning-value
     1636 
     1637  warning-value = warn-code SP warn-agent SP warn-text
     1638                                        [SP warn-date]
     1639 
     1640  warn-code  = 3DIGIT
     1641  warn-agent = ( host [ ":" port ] ) | pseudonym
     1642                  ; the name or pseudonym of the server adding
     1643                  ; the Warning header, for use in debugging
     1644  warn-text  = quoted-string
     1645  warn-date  = &lt;"&gt; HTTP-date &lt;"&gt;
    16461646</pre><p id="rfc.section.3.6.p.4">A response <em class="bcp14">MAY</em> carry more than one Warning header.
    16471647      </p>
Note: See TracChangeset for help on using the changeset viewer.