Ignore:
Timestamp:
Dec 22, 2007, 11:14:28 AM (12 years ago)
Author:
julian.reschke@…
Message:

Add "Requirements" subsection everywhere (including reference to RFC2119), add missing bcp14 markup.

File:
1 edited

Legend:

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

    r95 r96  
    483483      <ul class="toc">
    484484         <li class="tocline0">1.&nbsp;&nbsp;&nbsp;<a href="#introduction">Introduction</a><ul class="toc">
    485                <li class="tocline1">1.1&nbsp;&nbsp;&nbsp;<a href="#intro.terminology">Terminology</a></li>
    486                <li class="tocline1">1.2&nbsp;&nbsp;&nbsp;<a href="#delta.seconds">Delta Seconds</a></li>
     485               <li class="tocline1">1.1&nbsp;&nbsp;&nbsp;<a href="#intro.requirements">Requirements</a></li>
     486               <li class="tocline1">1.2&nbsp;&nbsp;&nbsp;<a href="#intro.terminology">Terminology</a></li>
     487               <li class="tocline1">1.3&nbsp;&nbsp;&nbsp;<a href="#delta.seconds">Delta Seconds</a></li>
    487488            </ul>
    488489         </li>
     
    559560         sections of <a href="#RFC2616">RFC 2616</a> <cite title="Hypertext Transfer Protocol -- HTTP/1.1" id="rfc.xref.RFC2616.2">[RFC2616]</cite> without edit.
    560561      </p>
    561       <h2 id="rfc.section.1.1"><a href="#rfc.section.1.1">1.1</a>&nbsp;<a id="intro.terminology" href="#intro.terminology">Terminology</a></h2>
    562       <p id="rfc.section.1.1.p.1">This specification uses a number of terms to refer to the roles played by participants in, and objects of, the HTTP communication.</p>
    563       <p id="rfc.section.1.1.p.2"> <span id="rfc.iref.c.1"></span>  <dfn>cache</dfn> 
     562      <h2 id="rfc.section.1.1"><a href="#rfc.section.1.1">1.1</a>&nbsp;<a id="intro.requirements" href="#intro.requirements">Requirements</a></h2>
     563      <p id="rfc.section.1.1.p.1">The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL"
     564         in this document are to be interpreted as described in <a href="#RFC2119" id="rfc.xref.RFC2119.1"><cite title="Key words for use in RFCs to Indicate Requirement Levels">[RFC2119]</cite></a>.
     565      </p>
     566      <p id="rfc.section.1.1.p.2">An implementation is not compliant if it fails to satisfy one or more of the <em class="bcp14">MUST</em> or <em class="bcp14">REQUIRED</em> level requirements for the protocols it implements. An implementation that satisfies all the <em class="bcp14">MUST</em> or <em class="bcp14">REQUIRED</em> level and all the <em class="bcp14">SHOULD</em> level requirements for its protocols is said to be "unconditionally compliant"; one that satisfies all the <em class="bcp14">MUST</em> level requirements but not all the <em class="bcp14">SHOULD</em> level requirements for its protocols is said to be "conditionally compliant."
     567      </p>
     568      <h2 id="rfc.section.1.2"><a href="#rfc.section.1.2">1.2</a>&nbsp;<a id="intro.terminology" href="#intro.terminology">Terminology</a></h2>
     569      <p id="rfc.section.1.2.p.1">This specification uses a number of terms to refer to the roles played by participants in, and objects of, the HTTP communication.</p>
     570      <p id="rfc.section.1.2.p.2"> <span id="rfc.iref.c.1"></span>  <dfn>cache</dfn> 
    564571      </p>
    565572      <dl class="empty">
     
    569576         </dd>
    570577      </dl>
    571       <p id="rfc.section.1.1.p.3"> <span id="rfc.iref.c.2"></span>  <dfn>cacheable</dfn> 
     578      <p id="rfc.section.1.2.p.3"> <span id="rfc.iref.c.2"></span>  <dfn>cacheable</dfn> 
    572579      </p>
    573580      <dl class="empty">
     
    577584         </dd>
    578585      </dl>
    579       <p id="rfc.section.1.1.p.4"> <span id="rfc.iref.f.1"></span>  <dfn>first-hand</dfn> 
     586      <p id="rfc.section.1.2.p.4"> <span id="rfc.iref.f.1"></span>  <dfn>first-hand</dfn> 
    580587      </p>
    581588      <dl class="empty">
     
    584591         </dd>
    585592      </dl>
    586       <p id="rfc.section.1.1.p.5"> <span id="rfc.iref.e.1"></span>  <dfn>explicit expiration time</dfn> 
     593      <p id="rfc.section.1.2.p.5"> <span id="rfc.iref.e.1"></span>  <dfn>explicit expiration time</dfn> 
    587594      </p>
    588595      <dl class="empty">
    589596         <dd>The time at which the origin server intends that an entity should no longer be returned by a cache without further validation.</dd>
    590597      </dl>
    591       <p id="rfc.section.1.1.p.6"> <span id="rfc.iref.h.1"></span>  <dfn>heuristic expiration time</dfn> 
     598      <p id="rfc.section.1.2.p.6"> <span id="rfc.iref.h.1"></span>  <dfn>heuristic expiration time</dfn> 
    592599      </p>
    593600      <dl class="empty">
    594601         <dd>An expiration time assigned by a cache when no explicit expiration time is available.</dd>
    595602      </dl>
    596       <p id="rfc.section.1.1.p.7"> <span id="rfc.iref.a.1"></span>  <dfn>age</dfn> 
     603      <p id="rfc.section.1.2.p.7"> <span id="rfc.iref.a.1"></span>  <dfn>age</dfn> 
    597604      </p>
    598605      <dl class="empty">
    599606         <dd>The age of a response is the time since it was sent by, or successfully validated with, the origin server.</dd>
    600607      </dl>
    601       <p id="rfc.section.1.1.p.8"> <span id="rfc.iref.f.2"></span>  <dfn>freshness lifetime</dfn> 
     608      <p id="rfc.section.1.2.p.8"> <span id="rfc.iref.f.2"></span>  <dfn>freshness lifetime</dfn> 
    602609      </p>
    603610      <dl class="empty">
    604611         <dd>The length of time between the generation of a response and its expiration time.</dd>
    605612      </dl>
    606       <p id="rfc.section.1.1.p.9"> <span id="rfc.iref.f.3"></span>  <dfn>fresh</dfn> 
     613      <p id="rfc.section.1.2.p.9"> <span id="rfc.iref.f.3"></span>  <dfn>fresh</dfn> 
    607614      </p>
    608615      <dl class="empty">
    609616         <dd>A response is fresh if its age has not yet exceeded its freshness lifetime.</dd>
    610617      </dl>
    611       <p id="rfc.section.1.1.p.10"> <span id="rfc.iref.s.1"></span>  <dfn>stale</dfn> 
     618      <p id="rfc.section.1.2.p.10"> <span id="rfc.iref.s.1"></span>  <dfn>stale</dfn> 
    612619      </p>
    613620      <dl class="empty">
    614621         <dd>A response is stale if its age has passed its freshness lifetime.</dd>
    615622      </dl>
    616       <p id="rfc.section.1.1.p.11"> <span id="rfc.iref.s.2"></span>  <dfn>semantically transparent</dfn> 
     623      <p id="rfc.section.1.2.p.11"> <span id="rfc.iref.s.2"></span>  <dfn>semantically transparent</dfn> 
    617624      </p>
    618625      <dl class="empty">
     
    623630         </dd>
    624631      </dl>
    625       <p id="rfc.section.1.1.p.12"> <span id="rfc.iref.v.1"></span>  <dfn>validator</dfn> 
     632      <p id="rfc.section.1.2.p.12"> <span id="rfc.iref.v.1"></span>  <dfn>validator</dfn> 
    626633      </p>
    627634      <dl class="empty">
     
    630637         </dd>
    631638      </dl>
    632       <h2 id="rfc.section.1.2"><a href="#rfc.section.1.2">1.2</a>&nbsp;<a id="delta.seconds" href="#delta.seconds">Delta Seconds</a></h2>
    633       <p id="rfc.section.1.2.p.1">Some HTTP header fields allow a time value to be specified as an integer number of seconds, represented in decimal, after
     639      <h2 id="rfc.section.1.3"><a href="#rfc.section.1.3">1.3</a>&nbsp;<a id="delta.seconds" href="#delta.seconds">Delta Seconds</a></h2>
     640      <p id="rfc.section.1.3.p.1">Some HTTP header fields allow a time value to be specified as an integer number of seconds, represented in decimal, after
    634641         the time that the message was received.
    635642      </p>
     
    17161723      <h1 id="rfc.references"><a href="#rfc.section.7" id="rfc.section.7">7.</a> References
    17171724      </h1>
    1718       <table summary="References">                 
     1725      <table summary="References">                   
    17191726         <tr>
    17201727            <td class="reference"><b id="Part1">[Part1]</b></td>
     
    17551762            <td class="reference"><b id="RFC2047">[RFC2047]</b></td>
    17561763            <td class="top"><a title="University of Tennessee">Moore, K.</a>, “<a href="http://tools.ietf.org/html/rfc2047">MIME (Multipurpose Internet Mail Extensions) Part Three: Message Header Extensions for Non-ASCII Text</a>”, RFC&nbsp;2047, November&nbsp;1996.
     1764            </td>
     1765         </tr>
     1766         <tr>
     1767            <td class="reference"><b id="RFC2119">[RFC2119]</b></td>
     1768            <td class="top"><a title="Harvard University">Bradner, S.</a>, “<a href="http://tools.ietf.org/html/rfc2119">Key words for use in RFCs to Indicate Requirement Levels</a>”, BCP&nbsp;14, RFC&nbsp;2119, March&nbsp;1997.
    17571769            </td>
    17581770         </tr>
     
    18191831         <ul class="ind">
    18201832            <li class="indline0"><a id="rfc.index.A" href="#rfc.index.A"><b>A</b></a><ul class="ind">
    1821                   <li class="indline1">age&nbsp;&nbsp;<a class="iref" href="#rfc.iref.a.1">1.1</a></li>
     1833                  <li class="indline1">age&nbsp;&nbsp;<a class="iref" href="#rfc.iref.a.1">1.2</a></li>
    18221834                  <li class="indline1">Age header&nbsp;&nbsp;<a class="iref" href="#rfc.iref.a.2"><b>3.1</b></a></li>
    18231835               </ul>
    18241836            </li>
    18251837            <li class="indline0"><a id="rfc.index.C" href="#rfc.index.C"><b>C</b></a><ul class="ind">
    1826                   <li class="indline1">cache&nbsp;&nbsp;<a class="iref" href="#rfc.iref.c.1">1.1</a></li>
     1838                  <li class="indline1">cache&nbsp;&nbsp;<a class="iref" href="#rfc.iref.c.1">1.2</a></li>
    18271839                  <li class="indline1">Cache Directives&nbsp;&nbsp;
    18281840                     <ul class="ind">
     
    18421854                  </li>
    18431855                  <li class="indline1">Cache-Control header&nbsp;&nbsp;<a class="iref" href="#rfc.xref.header.cache-control.1">2.1.1</a>, <a class="iref" href="#rfc.xref.header.cache-control.2">2.1.1</a>, <a class="iref" href="#rfc.xref.header.cache-control.3">2.1.3</a>, <a class="iref" href="#rfc.xref.header.cache-control.4">2.2.1</a>, <a class="iref" href="#rfc.xref.header.cache-control.5">2.2.5</a>, <a class="iref" href="#rfc.xref.header.cache-control.6">2.4</a>, <a class="iref" href="#rfc.xref.header.cache-control.7">2.4</a>, <a class="iref" href="#rfc.xref.header.cache-control.8">2.8</a>, <a class="iref" href="#rfc.iref.c.3"><b>3.2</b></a>, <a class="iref" href="#rfc.xref.header.cache-control.9">3.3</a>, <a class="iref" href="#rfc.xref.header.cache-control.10">3.4</a>, <a class="iref" href="#rfc.xref.header.cache-control.11">A</a></li>
    1844                   <li class="indline1">cacheable&nbsp;&nbsp;<a class="iref" href="#rfc.iref.c.2">1.1</a></li>
     1856                  <li class="indline1">cacheable&nbsp;&nbsp;<a class="iref" href="#rfc.iref.c.2">1.2</a></li>
    18451857               </ul>
    18461858            </li>
    18471859            <li class="indline0"><a id="rfc.index.E" href="#rfc.index.E"><b>E</b></a><ul class="ind">
    18481860                  <li class="indline1">Expires header&nbsp;&nbsp;<a class="iref" href="#rfc.xref.header.expires.1">2.4</a>, <a class="iref" href="#rfc.xref.header.expires.2">3.2.3</a>, <a class="iref" href="#rfc.iref.e.2"><b>3.3</b></a></li>
    1849                   <li class="indline1">explicit expiration time&nbsp;&nbsp;<a class="iref" href="#rfc.iref.e.1">1.1</a></li>
     1861                  <li class="indline1">explicit expiration time&nbsp;&nbsp;<a class="iref" href="#rfc.iref.e.1">1.2</a></li>
    18501862               </ul>
    18511863            </li>
    18521864            <li class="indline0"><a id="rfc.index.F" href="#rfc.index.F"><b>F</b></a><ul class="ind">
    1853                   <li class="indline1">first-hand&nbsp;&nbsp;<a class="iref" href="#rfc.iref.f.1">1.1</a></li>
    1854                   <li class="indline1">fresh&nbsp;&nbsp;<a class="iref" href="#rfc.iref.f.3">1.1</a></li>
    1855                   <li class="indline1">freshness lifetime&nbsp;&nbsp;<a class="iref" href="#rfc.iref.f.2">1.1</a></li>
     1865                  <li class="indline1">first-hand&nbsp;&nbsp;<a class="iref" href="#rfc.iref.f.1">1.2</a></li>
     1866                  <li class="indline1">fresh&nbsp;&nbsp;<a class="iref" href="#rfc.iref.f.3">1.2</a></li>
     1867                  <li class="indline1">freshness lifetime&nbsp;&nbsp;<a class="iref" href="#rfc.iref.f.2">1.2</a></li>
    18561868               </ul>
    18571869            </li>
     
    18661878                        <li class="indline1"><tt>cache-request-directive</tt>&nbsp;&nbsp;<a class="iref" href="#rfc.iref.g.6"><b>3.2</b></a></li>
    18671879                        <li class="indline1"><tt>cache-response-directive</tt>&nbsp;&nbsp;<a class="iref" href="#rfc.iref.g.7"><b>3.2</b></a></li>
    1868                         <li class="indline1"><tt>delta-seconds</tt>&nbsp;&nbsp;<a class="iref" href="#rfc.iref.g.1"><b>1.2</b></a></li>
     1880                        <li class="indline1"><tt>delta-seconds</tt>&nbsp;&nbsp;<a class="iref" href="#rfc.iref.g.1"><b>1.3</b></a></li>
    18691881                        <li class="indline1"><tt>Expires</tt>&nbsp;&nbsp;<a class="iref" href="#rfc.iref.g.9"><b>3.3</b></a></li>
    18701882                        <li class="indline1"><tt>extension-pragma</tt>&nbsp;&nbsp;<a class="iref" href="#rfc.iref.g.12"><b>3.4</b></a></li>
     
    18931905                     </ul>
    18941906                  </li>
    1895                   <li class="indline1">heuristic expiration time&nbsp;&nbsp;<a class="iref" href="#rfc.iref.h.1">1.1</a></li>
     1907                  <li class="indline1">heuristic expiration time&nbsp;&nbsp;<a class="iref" href="#rfc.iref.h.1">1.2</a></li>
    18961908               </ul>
    18971909            </li>
     
    19972009                  <li class="indline1"><em>RFC1305</em>&nbsp;&nbsp;<a class="iref" href="#rfc.xref.RFC1305.1">2.2.3</a>, <a class="iref" href="#RFC1305"><b>7</b></a></li>
    19982010                  <li class="indline1"><em>RFC2047</em>&nbsp;&nbsp;<a class="iref" href="#rfc.xref.RFC2047.1">3.6</a>, <a class="iref" href="#RFC2047"><b>7</b></a></li>
     2011                  <li class="indline1"><em>RFC2119</em>&nbsp;&nbsp;<a class="iref" href="#rfc.xref.RFC2119.1">1.1</a>, <a class="iref" href="#RFC2119"><b>7</b></a></li>
    19992012                  <li class="indline1"><em>RFC2616</em>&nbsp;&nbsp;<a class="iref" href="#rfc.xref.RFC2616.1">§</a>, <a class="iref" href="#rfc.xref.RFC2616.2">1</a>, <a class="iref" href="#RFC2616"><b>7</b></a></li>
    20002013               </ul>
     
    20062019                     </ul>
    20072020                  </li>
    2008                   <li class="indline1">semantically transparent&nbsp;&nbsp;<a class="iref" href="#rfc.iref.s.2">1.1</a></li>
    2009                   <li class="indline1">stale&nbsp;&nbsp;<a class="iref" href="#rfc.iref.s.1">1.1</a></li>
     2021                  <li class="indline1">semantically transparent&nbsp;&nbsp;<a class="iref" href="#rfc.iref.s.2">1.2</a></li>
     2022                  <li class="indline1">stale&nbsp;&nbsp;<a class="iref" href="#rfc.iref.s.1">1.2</a></li>
    20102023               </ul>
    20112024            </li>
    20122025            <li class="indline0"><a id="rfc.index.V" href="#rfc.index.V"><b>V</b></a><ul class="ind">
    2013                   <li class="indline1">validator&nbsp;&nbsp;<a class="iref" href="#rfc.iref.v.1">1.1</a></li>
     2026                  <li class="indline1">validator&nbsp;&nbsp;<a class="iref" href="#rfc.iref.v.1">1.2</a></li>
    20142027                  <li class="indline1">Vary header&nbsp;&nbsp;<a class="iref" href="#rfc.xref.header.vary.1">2.6</a>, <a class="iref" href="#rfc.iref.v.2"><b>3.5</b></a></li>
    20152028               </ul>
Note: See TracChangeset for help on using the changeset viewer.