Ignore:
Timestamp:
Dec 5, 2011, 5:24:57 AM (8 years ago)
Author:
julian.reschke@…
Message:

Editorial: make IANA table handling consistent between warn codes and status codes (this includes giving each warn code a subsection to be referenced) (see #274)

Location:
draft-ietf-httpbis/latest
Files:
1 added
4 edited

Legend:

Unmodified
Added
Removed

  • draft-ietf-httpbis/latest

    • Property svn:ignore

      •  

        old new  
         1*.abnf
         2*.abnf-appendix
         3*.cache-directives
         4*.diff
         5*.iana-status-codes
         6*.iana-warn-codes
        17*.redxml
         8*.xhtml
         9p1-messaging.iana-headers
         10p1-messaging.iana-headers.xml
         11p1-messaging.parsed-abnf
        212p1-messaging.txt
         13p2-semantics.iana-headers
         14p2-semantics.iana-headers.xml
         15p2-semantics.iana-methods
         16p2-semantics.iana-methods.xml
         17p2-semantics.iana-status-codes
         18p2-semantics.iana-status-codes.xml
         19p2-semantics.parsed-abnf
        320p2-semantics.txt
         21p3-payload.iana-headers
         22p3-payload.iana-headers.xml
         23p3-payload.parsed-abnf
        424p3-payload.txt
         25p4-conditional.iana-headers
         26p4-conditional.iana-headers.xml
         27p4-conditional.parsed-abnf
        528p4-conditional.txt
         29p5-range.iana-headers
         30p5-range.iana-headers.xml
         31p5-range.parsed-abnf
        632p5-range.txt
         33p6-cache.iana-headers
         34p6-cache.iana-headers.xml
         35p6-cache.parsed-abnf
        736p6-cache.txt
         37p7-auth.iana-headers
         38p7-auth.iana-headers.xml
         39p7-auth.parsed-abnf
        840p7-auth.txt
        941p8-cookies.txt
        10 p2-semantics.iana-methods.xml
        11 p2-semantics.iana-status-codes.xml
        12 p1-messaging.iana-headers.xml
        13 p2-semantics.iana-headers.xml
        14 p3-payload.iana-headers.xml
        15 p4-conditional.iana-headers.xml
        16 p5-range.iana-headers.xml
        17 p6-cache.iana-headers.xml
        18 p7-auth.iana-headers.xml
        19 *.abnf
        20 p1-messaging.iana-headers
        21 p1-messaging.parsed-abnf
        22 p2-semantics.iana-headers
        23 p2-semantics.iana-methods
        24 p2-semantics.iana-status-codes
        25 p2-semantics.parsed-abnf
        26 p3-payload.iana-headers
        27 p3-payload.parsed-abnf
        28 p4-conditional.iana-headers
        29 p4-conditional.parsed-abnf
        30 p5-range.iana-headers
        31 p5-range.parsed-abnf
        32 p6-cache.iana-headers
        33 p6-cache.parsed-abnf
        34 p7-auth.iana-headers
        35 p7-auth.parsed-abnf
        36 *.abnf-appendix
        37 *.iana-status-codes
        38 *.cache-directives
        39 *.xhtml
        40 *.diff

  • draft-ietf-httpbis/latest/Makefile

    r1147 r1487  
    3939          p5-range.iana-status-codes \
    4040          p6-cache.iana-headers \
     41          p6-cache.iana-warn-codes \
    4142          p6-cache.cache-directives \
    4243          p7-auth.iana-headers \
    … …  
    7980        $(saxon) $< extract-status-code-defs.xslt > $@
    8081
     82%.iana-warn-codes: %.xml extract-warn-code-defs.xslt
     83        $(saxon) $< extract-warn-code-defs.xslt > $@
     84
    8185%.cache-directives: %.xml extract-cache-directives.xslt
    8286        $(saxon) $< extract-cache-directives.xslt > $@

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

    r1485 r1487  
    593593               <li>3.5&nbsp;&nbsp;&nbsp;<a href="#header.vary">Vary</a></li>
    594594               <li>3.6&nbsp;&nbsp;&nbsp;<a href="#header.warning">Warning</a><ul>
    595                      <li>3.6.1&nbsp;&nbsp;&nbsp;<a href="#warn.code.extensions">Warn Code Extensions</a></li>
     595                     <li>3.6.1&nbsp;&nbsp;&nbsp;<a href="#warn.110">110 Response is Stale</a></li>
     596                     <li>3.6.2&nbsp;&nbsp;&nbsp;<a href="#warn.111">111 Revalidation Failed</a></li>
     597                     <li>3.6.3&nbsp;&nbsp;&nbsp;<a href="#warn.112">112 Disconnected Operation</a></li>
     598                     <li>3.6.4&nbsp;&nbsp;&nbsp;<a href="#warn.113">113 Heuristic Expiration</a></li>
     599                     <li>3.6.5&nbsp;&nbsp;&nbsp;<a href="#warn.199">199 Miscellaneous Warning</a></li>
     600                     <li>3.6.6&nbsp;&nbsp;&nbsp;<a href="#warn.214">214 Transformation Applied</a></li>
     601                     <li>3.6.7&nbsp;&nbsp;&nbsp;<a href="#warn.299">299 Miscellaneous Persistent Warning</a></li>
     602                     <li>3.6.8&nbsp;&nbsp;&nbsp;<a href="#warn.code.extensions">Warn Code Extensions</a></li>
    596603                  </ul>
    597604               </li>
    … …  
    15191526         of its meaning.
    15201527      </p>
    1521       <p id="rfc.section.3.6.p.12"> 110 Response is stale </p>
    1522       <ul class="empty">
    1523          <li>A cache <em class="bcp14">SHOULD</em> include this whenever the returned response is stale.
    1524          </li>
    1525       </ul>
    1526       <p id="rfc.section.3.6.p.13"> 111 Revalidation failed </p>
    1527       <ul class="empty">
    1528          <li>A cache <em class="bcp14">SHOULD</em> include this when returning a stale response because an attempt to validate the response failed, due to an inability to reach
    1529             the server.
    1530          </li>
    1531       </ul>
    1532       <p id="rfc.section.3.6.p.14"> 112 Disconnected operation </p>
    1533       <ul class="empty">
    1534          <li>A cache <em class="bcp14">SHOULD</em> include this if it is intentionally disconnected from the rest of the network for a period of time.
    1535          </li>
    1536       </ul>
    1537       <p id="rfc.section.3.6.p.15"> 113 Heuristic expiration </p>
    1538       <ul class="empty">
    1539          <li>A cache <em class="bcp14">SHOULD</em> include this if it heuristically chose a freshness lifetime greater than 24 hours and the response's age is greater than 24
    1540             hours.
    1541          </li>
    1542       </ul>
    1543       <p id="rfc.section.3.6.p.16"> 199 Miscellaneous warning </p>
    1544       <ul class="empty">
    1545          <li>The warning text can include arbitrary information to be presented to a human user, or logged. A system receiving this warning <em class="bcp14">MUST NOT</em> take any automated action, besides presenting the warning to the user.
    1546          </li>
    1547       </ul>
    1548       <p id="rfc.section.3.6.p.17"> 214 Transformation applied </p>
    1549       <ul class="empty">
    1550          <li><em class="bcp14">MUST</em> be added by a proxy if it applies any transformation to the representation, such as changing the content-coding, media-type,
    1551             or modifying the representation data, unless this Warning code already appears in the response.
    1552          </li>
    1553       </ul>
    1554       <p id="rfc.section.3.6.p.18"> 299 Miscellaneous persistent warning </p>
    1555       <ul class="empty">
    1556          <li>The warning text can include arbitrary information to be presented to a human user, or logged. A system receiving this warning <em class="bcp14">MUST NOT</em> take any automated action.
    1557          </li>
    1558       </ul>
    1559       <h3 id="rfc.section.3.6.1"><a href="#rfc.section.3.6.1">3.6.1</a>&nbsp;<a id="warn.code.extensions" href="#warn.code.extensions">Warn Code Extensions</a></h3>
    1560       <p id="rfc.section.3.6.1.p.1">The HTTP Warn Code Registry defines the name space for warn codes.</p>
    1561       <p id="rfc.section.3.6.1.p.2">A registration <em class="bcp14">MUST</em> include the following fields:
     1528      <div id="rfc.iref.78"></div>
     1529      <div id="rfc.iref.w.2"></div>
     1530      <h3 id="rfc.section.3.6.1"><a href="#rfc.section.3.6.1">3.6.1</a>&nbsp;<a id="warn.110" href="#warn.110">110 Response is Stale</a></h3>
     1531      <p id="rfc.section.3.6.1.p.1">A cache <em class="bcp14">SHOULD</em> include this whenever the returned response is stale.
     1532      </p>
     1533      <div id="rfc.iref.79"></div>
     1534      <div id="rfc.iref.w.3"></div>
     1535      <h3 id="rfc.section.3.6.2"><a href="#rfc.section.3.6.2">3.6.2</a>&nbsp;<a id="warn.111" href="#warn.111">111 Revalidation Failed</a></h3>
     1536      <p id="rfc.section.3.6.2.p.1">A cache <em class="bcp14">SHOULD</em> include this when returning a stale response because an attempt to validate the response failed, due to an inability to reach
     1537         the server.
     1538      </p>
     1539      <div id="rfc.iref.80"></div>
     1540      <div id="rfc.iref.w.4"></div>
     1541      <h3 id="rfc.section.3.6.3"><a href="#rfc.section.3.6.3">3.6.3</a>&nbsp;<a id="warn.112" href="#warn.112">112 Disconnected Operation</a></h3>
     1542      <p id="rfc.section.3.6.3.p.1">A cache <em class="bcp14">SHOULD</em> include this if it is intentionally disconnected from the rest of the network for a period of time.
     1543      </p>
     1544      <div id="rfc.iref.81"></div>
     1545      <div id="rfc.iref.w.5"></div>
     1546      <h3 id="rfc.section.3.6.4"><a href="#rfc.section.3.6.4">3.6.4</a>&nbsp;<a id="warn.113" href="#warn.113">113 Heuristic Expiration</a></h3>
     1547      <p id="rfc.section.3.6.4.p.1">A cache <em class="bcp14">SHOULD</em> include this if it heuristically chose a freshness lifetime greater than 24 hours and the response's age is greater than 24
     1548         hours.
     1549      </p>
     1550      <div id="rfc.iref.82"></div>
     1551      <div id="rfc.iref.w.6"></div>
     1552      <h3 id="rfc.section.3.6.5"><a href="#rfc.section.3.6.5">3.6.5</a>&nbsp;<a id="warn.199" href="#warn.199">199 Miscellaneous Warning</a></h3>
     1553      <p id="rfc.section.3.6.5.p.1">The warning text can include arbitrary information to be presented to a human user, or logged. A system receiving this warning <em class="bcp14">MUST NOT</em> take any automated action, besides presenting the warning to the user.
     1554      </p>
     1555      <div id="rfc.iref.83"></div>
     1556      <div id="rfc.iref.w.7"></div>
     1557      <h3 id="rfc.section.3.6.6"><a href="#rfc.section.3.6.6">3.6.6</a>&nbsp;<a id="warn.214" href="#warn.214">214 Transformation Applied</a></h3>
     1558      <p id="rfc.section.3.6.6.p.1"> <em class="bcp14">MUST</em> be added by a proxy if it applies any transformation to the representation, such as changing the content-coding, media-type,
     1559         or modifying the representation data, unless this Warning code already appears in the response.
     1560      </p>
     1561      <div id="rfc.iref.84"></div>
     1562      <div id="rfc.iref.w.8"></div>
     1563      <h3 id="rfc.section.3.6.7"><a href="#rfc.section.3.6.7">3.6.7</a>&nbsp;<a id="warn.299" href="#warn.299">299 Miscellaneous Persistent Warning</a></h3>
     1564      <p id="rfc.section.3.6.7.p.1">The warning text can include arbitrary information to be presented to a human user, or logged. A system receiving this warning <em class="bcp14">MUST NOT</em> take any automated action.
     1565      </p>
     1566      <h3 id="rfc.section.3.6.8"><a href="#rfc.section.3.6.8">3.6.8</a>&nbsp;<a id="warn.code.extensions" href="#warn.code.extensions">Warn Code Extensions</a></h3>
     1567      <p id="rfc.section.3.6.8.p.1">The HTTP Warn Code Registry defines the name space for warn codes.</p>
     1568      <p id="rfc.section.3.6.8.p.2">A registration <em class="bcp14">MUST</em> include the following fields:
    15621569      </p>
    15631570      <ul>
    … …  
    15661573         <li>Pointer to specification text</li>
    15671574      </ul>
    1568       <p id="rfc.section.3.6.1.p.3">Values to be added to this name space are subject to IETF review (<a href="#RFC5226" id="rfc.xref.RFC5226.2"><cite title="Guidelines for Writing an IANA Considerations Section in RFCs">[RFC5226]</cite></a>, <a href="http://tools.ietf.org/html/rfc5226#section-4.1">Section 4.1</a>).
    1569       </p>
    1570       <p id="rfc.section.3.6.1.p.4">The registry itself is maintained at &lt;<a href="http://www.iana.org/assignments/http-warn-codes">http://www.iana.org/assignments/http-warn-codes</a>&gt;.
     1575      <p id="rfc.section.3.6.8.p.3">Values to be added to this name space are subject to IETF review (<a href="#RFC5226" id="rfc.xref.RFC5226.2"><cite title="Guidelines for Writing an IANA Considerations Section in RFCs">[RFC5226]</cite></a>, <a href="http://tools.ietf.org/html/rfc5226#section-4.1">Section 4.1</a>).
     1576      </p>
     1577      <p id="rfc.section.3.6.8.p.4">The registry itself is maintained at &lt;<a href="http://www.iana.org/assignments/http-warn-codes">http://www.iana.org/assignments/http-warn-codes</a>&gt;.
    15711578      </p>
    15721579      <h2 id="rfc.section.3.7"><a href="#rfc.section.3.7">3.7</a>&nbsp;<a id="history.lists" href="#history.lists">History Lists</a></h2>
    … …  
    16701677      </div>
    16711678      <h3 id="rfc.section.3.8.2"><a href="#rfc.section.3.8.2">3.8.2</a>&nbsp;<a id="warn.code.registration" href="#warn.code.registration">Warn Code Registry</a></h3>
    1672       <p id="rfc.section.3.8.2.p.1">The registration procedure for HTTP Warn Codes is defined by <a href="#warn.code.extensions" title="Warn Code Extensions">Section&nbsp;3.6.1</a> of this document.
     1679      <p id="rfc.section.3.8.2.p.1">The registration procedure for HTTP Warn Codes is defined by <a href="#warn.code.extensions" title="Warn Code Extensions">Section&nbsp;3.6.8</a> of this document.
    16731680      </p>
    16741681      <p id="rfc.section.3.8.2.p.2">The HTTP Warn Code Registry shall be created at &lt;<a href="http://www.iana.org/assignments/http-cache-directives">http://www.iana.org/assignments/http-cache-directives</a>&gt; and be populated with the registrations below:
    16751682      </p>
    1676       <div id="rfc.table.u.1">
     1683      <div id="rfc.table.2">
     1684         <div id="iana.warn.code.registration.table"></div>
    16771685         <table class="tt full left" cellpadding="3" cellspacing="0">
    16781686            <thead>
    … …  
    16861694               <tr>
    16871695                  <td class="left">110</td>
    1688                   <td class="left">Response is stale</td>
    1689                   <td class="left"><a href="#header.warning" id="rfc.xref.header.warning.4" title="Warning">Section&nbsp;3.6</a></td>
     1696                  <td class="left">Response is Stale</td>
     1697                  <td class="left"> <a href="#warn.110" id="rfc.xref.warn.110.1" title="110 Response is Stale">Section&nbsp;3.6.1</a>
     1698                  </td>
    16901699               </tr>
    16911700               <tr>
    16921701                  <td class="left">111</td>
    1693                   <td class="left">Revalidation failed</td>
    1694                   <td class="left"><a href="#header.warning" id="rfc.xref.header.warning.5" title="Warning">Section&nbsp;3.6</a></td>
     1702                  <td class="left">Revalidation Failed</td>
     1703                  <td class="left"> <a href="#warn.111" id="rfc.xref.warn.111.1" title="111 Revalidation Failed">Section&nbsp;3.6.2</a>
     1704                  </td>
    16951705               </tr>
    16961706               <tr>
    16971707                  <td class="left">112</td>
    1698                   <td class="left">Disconnected operation</td>
    1699                   <td class="left"><a href="#header.warning" id="rfc.xref.header.warning.6" title="Warning">Section&nbsp;3.6</a></td>
     1708                  <td class="left">Disconnected Operation</td>
     1709                  <td class="left"> <a href="#warn.112" id="rfc.xref.warn.112.1" title="112 Disconnected Operation">Section&nbsp;3.6.3</a>
     1710                  </td>
    17001711               </tr>
    17011712               <tr>
    17021713                  <td class="left">113</td>
    1703                   <td class="left">Heuristic expiration</td>
    1704                   <td class="left"><a href="#header.warning" id="rfc.xref.header.warning.7" title="Warning">Section&nbsp;3.6</a></td>
     1714                  <td class="left">Heuristic Expiration</td>
     1715                  <td class="left"> <a href="#warn.113" id="rfc.xref.warn.113.1" title="113 Heuristic Expiration">Section&nbsp;3.6.4</a>
     1716                  </td>
    17051717               </tr>
    17061718               <tr>
    17071719                  <td class="left">199</td>
    1708                   <td class="left">Miscellaneous warning</td>
    1709                   <td class="left"><a href="#header.warning" id="rfc.xref.header.warning.8" title="Warning">Section&nbsp;3.6</a></td>
     1720                  <td class="left">Miscellaneous Warning</td>
     1721                  <td class="left"> <a href="#warn.199" id="rfc.xref.warn.199.1" title="199 Miscellaneous Warning">Section&nbsp;3.6.5</a>
     1722                  </td>
    17101723               </tr>
    17111724               <tr>
    17121725                  <td class="left">214</td>
    1713                   <td class="left">Transformation applied</td>
    1714                   <td class="left"><a href="#header.warning" id="rfc.xref.header.warning.9" title="Warning">Section&nbsp;3.6</a></td>
     1726                  <td class="left">Transformation Applied</td>
     1727                  <td class="left"> <a href="#warn.214" id="rfc.xref.warn.214.1" title="214 Transformation Applied">Section&nbsp;3.6.6</a>
     1728                  </td>
    17151729               </tr>
    17161730               <tr>
    17171731                  <td class="left">299</td>
    1718                   <td class="left">Miscellaneous persistent warning</td>
    1719                   <td class="left"><a href="#header.warning" id="rfc.xref.header.warning.10" title="Warning">Section&nbsp;3.6</a></td>
     1732                  <td class="left">Miscellaneous Persistent Warning</td>
     1733                  <td class="left"> <a href="#warn.299" id="rfc.xref.warn.299.1" title="299 Miscellaneous Persistent Warning">Section&nbsp;3.6.7</a>
     1734                  </td>
    17201735               </tr>
    17211736            </tbody>
    … …  
    17251740      <p id="rfc.section.3.9.p.1">The Message Header Field Registry located at &lt;<a href="http://www.iana.org/assignments/message-headers/message-header-index.html">http://www.iana.org/assignments/message-headers/message-header-index.html</a>&gt; shall be updated with the permanent registrations below (see <a href="#RFC3864" id="rfc.xref.RFC3864.1"><cite title="Registration Procedures for Message Header Fields">[RFC3864]</cite></a>):
    17261741      </p>
    1727       <div id="rfc.table.2">
     1742      <div id="rfc.table.3">
    17281743         <div id="iana.header.registration.table"></div>
    17291744         <table class="tt full left" cellpadding="3" cellspacing="0">
    … …  
    17761791                  <td class="left">http</td>
    17771792                  <td class="left">standard</td>
    1778                   <td class="left"> <a href="#header.warning" id="rfc.xref.header.warning.11" title="Warning">Section&nbsp;3.6</a>
     1793                  <td class="left"> <a href="#header.warning" id="rfc.xref.header.warning.4" title="Warning">Section&nbsp;3.6</a>
    17791794                  </td>
    17801795               </tr>
    … …  
    18941909      </p>
    18951910      <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.
    1896          (<a href="#header.warning" id="rfc.xref.header.warning.12" title="Warning">Section&nbsp;3.6</a>)
     1911         (<a href="#header.warning" id="rfc.xref.header.warning.5" title="Warning">Section&nbsp;3.6</a>)
    18971912      </p>
    18981913      <h1 id="rfc.section.B"><a href="#rfc.section.B">B.</a>&nbsp;<a id="collected.abnf" href="#collected.abnf">Collected ABNF</a></h1>
    … …  
    21772192      </ul>
    21782193      <h1 id="rfc.index"><a href="#rfc.index">Index</a></h1>
    2179       <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>
     2194      <p class="noprint"><a href="#rfc.index.1">1</a> <a href="#rfc.index.2">2</a> <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>
    21802195      </p>
    21812196      <div class="print2col">
    21822197         <ul class="ind">
     2198            <li><a id="rfc.index.1" href="#rfc.index.1"><b>1</b></a><ul>
     2199                  <li>110 Response is Stale (warn code)&nbsp;&nbsp;<a href="#rfc.iref.78"><b>3.6.1</b></a>, <a href="#rfc.xref.warn.110.1">3.8.2</a></li>
     2200                  <li>111 Revalidation Failed (warn code)&nbsp;&nbsp;<a href="#rfc.iref.79"><b>3.6.2</b></a>, <a href="#rfc.xref.warn.111.1">3.8.2</a></li>
     2201                  <li>112 Disconnected Operation (warn code)&nbsp;&nbsp;<a href="#rfc.iref.80"><b>3.6.3</b></a>, <a href="#rfc.xref.warn.112.1">3.8.2</a></li>
     2202                  <li>113 Heuristic Expiration (warn code)&nbsp;&nbsp;<a href="#rfc.iref.81"><b>3.6.4</b></a>, <a href="#rfc.xref.warn.113.1">3.8.2</a></li>
     2203                  <li>199 Miscellaneous Warning (warn code)&nbsp;&nbsp;<a href="#rfc.iref.82"><b>3.6.5</b></a>, <a href="#rfc.xref.warn.199.1">3.8.2</a></li>
     2204               </ul>
     2205            </li>
     2206            <li><a id="rfc.index.2" href="#rfc.index.2"><b>2</b></a><ul>
     2207                  <li>214 Transformation Applied (warn code)&nbsp;&nbsp;<a href="#rfc.iref.83"><b>3.6.6</b></a>, <a href="#rfc.xref.warn.214.1">3.8.2</a></li>
     2208                  <li>299 Miscellaneous Persistent Warning (warn code)&nbsp;&nbsp;<a href="#rfc.iref.84"><b>3.6.7</b></a>, <a href="#rfc.xref.warn.299.1">3.8.2</a></li>
     2209               </ul>
     2210            </li>
    21832211            <li><a id="rfc.index.A" href="#rfc.index.A"><b>A</b></a><ul>
    21842212                  <li>age&nbsp;&nbsp;<a href="#rfc.iref.a.1">1.2</a></li>
    … …  
    22532281                        <li>Pragma&nbsp;&nbsp;<a href="#rfc.xref.header.pragma.1">2.2</a>, <a href="#rfc.xref.header.pragma.2">3.2</a>, <a href="#rfc.iref.h.5"><b>3.4</b></a>, <a href="#rfc.xref.header.pragma.3">3.9</a></li>
    22542282                        <li>Vary&nbsp;&nbsp;<a href="#rfc.xref.header.vary.1">2.7</a>, <a href="#rfc.iref.h.6"><b>3.5</b></a>, <a href="#rfc.xref.header.vary.2">3.9</a></li>
    2255                         <li>Warning&nbsp;&nbsp;<a href="#rfc.xref.header.warning.1">2.3.3</a>, <a href="#rfc.xref.header.warning.2">2.4.1</a>, <a href="#rfc.xref.header.warning.3">2.8</a>, <a href="#rfc.iref.h.7"><b>3.6</b></a>, <a href="#rfc.xref.header.warning.4">3.8.2</a>, <a href="#rfc.xref.header.warning.5">3.8.2</a>, <a href="#rfc.xref.header.warning.6">3.8.2</a>, <a href="#rfc.xref.header.warning.7">3.8.2</a>, <a href="#rfc.xref.header.warning.8">3.8.2</a>, <a href="#rfc.xref.header.warning.9">3.8.2</a>, <a href="#rfc.xref.header.warning.10">3.8.2</a>, <a href="#rfc.xref.header.warning.11">3.9</a>, <a href="#rfc.xref.header.warning.12">A</a></li>
     2283                        <li>Warning&nbsp;&nbsp;<a href="#rfc.xref.header.warning.1">2.3.3</a>, <a href="#rfc.xref.header.warning.2">2.4.1</a>, <a href="#rfc.xref.header.warning.3">2.8</a>, <a href="#rfc.iref.h.7"><b>3.6</b></a>, <a href="#rfc.xref.header.warning.4">3.9</a>, <a href="#rfc.xref.header.warning.5">A</a></li>
    22562284                     </ul>
    22572285                  </li>
    … …  
    23702398                  </li>
    23712399                  <li><em>RFC3864</em>&nbsp;&nbsp;<a href="#rfc.xref.RFC3864.1">3.9</a>, <a href="#RFC3864"><b>6.2</b></a></li>
    2372                   <li><em>RFC5226</em>&nbsp;&nbsp;<a href="#rfc.xref.RFC5226.1">3.2.3</a>, <a href="#rfc.xref.RFC5226.2">3.6.1</a>, <a href="#RFC5226"><b>6.2</b></a><ul>
    2373                         <li><em>Section 4.1</em>&nbsp;&nbsp;<a href="#rfc.xref.RFC5226.1">3.2.3</a>, <a href="#rfc.xref.RFC5226.2">3.6.1</a></li>
     2400                  <li><em>RFC5226</em>&nbsp;&nbsp;<a href="#rfc.xref.RFC5226.1">3.2.3</a>, <a href="#rfc.xref.RFC5226.2">3.6.8</a>, <a href="#RFC5226"><b>6.2</b></a><ul>
     2401                        <li><em>Section 4.1</em>&nbsp;&nbsp;<a href="#rfc.xref.RFC5226.1">3.2.3</a>, <a href="#rfc.xref.RFC5226.2">3.6.8</a></li>
    23742402                     </ul>
    23752403                  </li>
    … …  
    24052433            </li>
    24062434            <li><a id="rfc.index.W" href="#rfc.index.W"><b>W</b></a><ul>
    2407                   <li>Warning header field&nbsp;&nbsp;<a href="#rfc.xref.header.warning.1">2.3.3</a>, <a href="#rfc.xref.header.warning.2">2.4.1</a>, <a href="#rfc.xref.header.warning.3">2.8</a>, <a href="#rfc.iref.w.1"><b>3.6</b></a>, <a href="#rfc.xref.header.warning.4">3.8.2</a>, <a href="#rfc.xref.header.warning.5">3.8.2</a>, <a href="#rfc.xref.header.warning.6">3.8.2</a>, <a href="#rfc.xref.header.warning.7">3.8.2</a>, <a href="#rfc.xref.header.warning.8">3.8.2</a>, <a href="#rfc.xref.header.warning.9">3.8.2</a>, <a href="#rfc.xref.header.warning.10">3.8.2</a>, <a href="#rfc.xref.header.warning.11">3.9</a>, <a href="#rfc.xref.header.warning.12">A</a></li>
     2435                  <li>Warn Codes&nbsp;&nbsp;
     2436                     <ul>
     2437                        <li>110 Response is Stale&nbsp;&nbsp;<a href="#rfc.iref.w.2"><b>3.6.1</b></a>, <a href="#rfc.xref.warn.110.1">3.8.2</a></li>
     2438                        <li>111 Revalidation Failed&nbsp;&nbsp;<a href="#rfc.iref.w.3"><b>3.6.2</b></a>, <a href="#rfc.xref.warn.111.1">3.8.2</a></li>
     2439                        <li>112 Disconnected Operation&nbsp;&nbsp;<a href="#rfc.iref.w.4"><b>3.6.3</b></a>, <a href="#rfc.xref.warn.112.1">3.8.2</a></li>
     2440                        <li>113 Heuristic Expiration&nbsp;&nbsp;<a href="#rfc.iref.w.5"><b>3.6.4</b></a>, <a href="#rfc.xref.warn.113.1">3.8.2</a></li>
     2441                        <li>199 Miscellaneous Warning&nbsp;&nbsp;<a href="#rfc.iref.w.6"><b>3.6.5</b></a>, <a href="#rfc.xref.warn.199.1">3.8.2</a></li>
     2442                        <li>214 Transformation Applied&nbsp;&nbsp;<a href="#rfc.iref.w.7"><b>3.6.6</b></a>, <a href="#rfc.xref.warn.214.1">3.8.2</a></li>
     2443                        <li>299 Miscellaneous Persistent Warning&nbsp;&nbsp;<a href="#rfc.iref.w.8"><b>3.6.7</b></a>, <a href="#rfc.xref.warn.299.1">3.8.2</a></li>
     2444                     </ul>
     2445                  </li>
     2446                  <li>Warning header field&nbsp;&nbsp;<a href="#rfc.xref.header.warning.1">2.3.3</a>, <a href="#rfc.xref.header.warning.2">2.4.1</a>, <a href="#rfc.xref.header.warning.3">2.8</a>, <a href="#rfc.iref.w.1"><b>3.6</b></a>, <a href="#rfc.xref.header.warning.4">3.9</a>, <a href="#rfc.xref.header.warning.5">A</a></li>
    24082447               </ul>
    24092448            </li>

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

    r1485 r1487  
    18671867   recommended warn-text in English, and a description of its meaning.
    18681868</t>
    1869 <t><?rfc needLines="4"?>
    1870    110 Response is stale
    1871    <list>
    1872       <t>A cache &SHOULD; include this whenever the returned response is stale.</t>
    1873    </list>
    1874 </t>
    1875 <t><?rfc needLines="4"?>
    1876    111 Revalidation failed
    1877    <list>
    1878       <t>A cache &SHOULD; include this when returning a stale response because an
    1879       attempt to validate the response failed, due to an inability to reach
    1880       the server.</t>
    1881    </list>
    1882 </t>
    1883 <t><?rfc needLines="4"?>
    1884    112 Disconnected operation
    1885    <list>
    1886       <t>A cache &SHOULD; include this if it is intentionally disconnected from
    1887       the rest of the network for a period of time.</t>
    1888    </list>
    1889 </t>
    1890 <t><?rfc needLines="4"?>
    1891    113 Heuristic expiration
    1892    <list>
    1893       <t>A cache &SHOULD; include this if it heuristically chose a freshness
    1894       lifetime greater than 24 hours and the response's age is greater than 24
    1895       hours.</t>
    1896    </list>
    1897 </t>
    1898 <t><?rfc needLines="4"?>
    1899    199 Miscellaneous warning
    1900    <list>
    1901       <t>The warning text can include arbitrary information to be presented to
    1902       a human user, or logged. A system receiving this warning &MUST-NOT; take
    1903       any automated action, besides presenting the warning to the user.</t>
    1904    </list>
    1905 </t>
    1906 <t><?rfc needLines="4"?>
    1907    214 Transformation applied
    1908    <list>
    1909       <t>&MUST; be added by a proxy if it applies any
    1910       transformation to the representation, such as changing the
    1911       content-coding, media-type, or modifying the representation data, unless
    1912       this Warning code already appears in the response.</t>
    1913    </list>
    1914 </t>
    1915 <t><?rfc needLines="4"?>
    1916    299 Miscellaneous persistent warning
    1917    <list>
    1918       <t>The warning text can include arbitrary information to be presented to
    1919       a human user, or logged. A system receiving this warning &MUST-NOT; take
    1920       any automated action.</t>
    1921    </list>
    1922 </t>
     1869
     1870<section title="110 Response is Stale" anchor="warn.110">
     1871  <iref primary="true" item="110 Response is Stale (warn code)" x:for-anchor=""/>
     1872  <iref primary="true" item="Warn Codes" subitem="110 Response is Stale" x:for-anchor=""/>
     1873<t>
     1874   A cache &SHOULD; include this whenever the returned response is stale.
     1875</t>
     1876</section>
     1877
     1878<section title="111 Revalidation Failed" anchor="warn.111">
     1879  <iref primary="true" item="111 Revalidation Failed (warn code)" x:for-anchor=""/>
     1880  <iref primary="true" item="Warn Codes" subitem="111 Revalidation Failed" x:for-anchor=""/>
     1881<t>
     1882   A cache &SHOULD; include this when returning a stale response because an
     1883   attempt to validate the response failed, due to an inability to reach
     1884   the server.
     1885</t>
     1886</section>
     1887
     1888<section title="112 Disconnected Operation" anchor="warn.112">
     1889  <iref primary="true" item="112 Disconnected Operation (warn code)" x:for-anchor=""/>
     1890  <iref primary="true" item="Warn Codes" subitem="112 Disconnected Operation" x:for-anchor=""/>
     1891<t>
     1892   A cache &SHOULD; include this if it is intentionally disconnected from
     1893   the rest of the network for a period of time.
     1894</t>
     1895</section>
     1896
     1897<section title="113 Heuristic Expiration" anchor="warn.113">
     1898  <iref primary="true" item="113 Heuristic Expiration (warn code)" x:for-anchor=""/>
     1899  <iref primary="true" item="Warn Codes" subitem="113 Heuristic Expiration" x:for-anchor=""/>
     1900<t>
     1901   A cache &SHOULD; include this if it heuristically chose a freshness
     1902   lifetime greater than 24 hours and the response's age is greater than 24
     1903   hours.
     1904</t>
     1905</section>
     1906
     1907<section title="199 Miscellaneous Warning" anchor="warn.199">
     1908  <iref primary="true" item="199 Miscellaneous Warning (warn code)" x:for-anchor=""/>
     1909  <iref primary="true" item="Warn Codes" subitem="199 Miscellaneous Warning" x:for-anchor=""/>
     1910<t>
     1911   The warning text can include arbitrary information to be presented to
     1912   a human user, or logged. A system receiving this warning &MUST-NOT; take
     1913   any automated action, besides presenting the warning to the user.
     1914</t>
     1915</section>
     1916
     1917<section title="214 Transformation Applied" anchor="warn.214">
     1918  <iref primary="true" item="214 Transformation Applied (warn code)" x:for-anchor=""/>
     1919  <iref primary="true" item="Warn Codes" subitem="214 Transformation Applied" x:for-anchor=""/>
     1920<t>
     1921   &MUST; be added by a proxy if it applies any transformation to the
     1922   representation, such as changing the content-coding, media-type, or
     1923   modifying the representation data, unless this Warning code already appears
     1924   in the response.
     1925</t>
     1926</section>
     1927
     1928<section title="299 Miscellaneous Persistent Warning" anchor="warn.299">
     1929  <iref primary="true" item="299 Miscellaneous Persistent Warning (warn code)" x:for-anchor=""/>
     1930  <iref primary="true" item="Warn Codes" subitem="299 Miscellaneous Persistent Warning" x:for-anchor=""/>
     1931<t>
     1932   The warning text can include arbitrary information to be presented to
     1933   a human user, or logged. A system receiving this warning &MUST-NOT; take
     1934   any automated action.
     1935</t>
     1936</section>
     1937
    19231938<section title="Warn Code Extensions" anchor="warn.code.extensions">
    19241939<t>
    … …  
    20562071   populated with the registrations below:
    20572072</t>
    2058    
    2059 <texttable align="left" suppress-title="true">
     2073<?BEGININC p6-cache.iana-warn-codes ?>
     2074<!--AUTOGENERATED FROM extract-warn-code-defs.xslt, do not edit manually-->
     2075<texttable align="left" suppress-title="true" anchor="iana.warn.code.registration.table">
    20602076   <ttcol>Warn Code</ttcol>
    20612077   <ttcol>Short Description</ttcol>
    20622078   <ttcol>Reference</ttcol>
    2063 
    20642079   <c>110</c>
    2065    <c>Response is stale</c>
    2066    <c><xref target="header.warning"/></c>
    2067 
     2080   <c>Response is Stale</c>
     2081   <c>
     2082      <xref target="warn.110"/>
     2083   </c>
    20682084   <c>111</c>
    2069    <c>Revalidation failed</c>
    2070    <c><xref target="header.warning"/></c>
    2071 
     2085   <c>Revalidation Failed</c>
     2086   <c>
     2087      <xref target="warn.111"/>
     2088   </c>
    20722089   <c>112</c>
    2073    <c>Disconnected operation</c>
    2074    <c><xref target="header.warning"/></c>
    2075 
     2090   <c>Disconnected Operation</c>
     2091   <c>
     2092      <xref target="warn.112"/>
     2093   </c>
    20762094   <c>113</c>
    2077    <c>Heuristic expiration</c>
    2078    <c><xref target="header.warning"/></c>
    2079 
     2095   <c>Heuristic Expiration</c>
     2096   <c>
     2097      <xref target="warn.113"/>
     2098   </c>
    20802099   <c>199</c>
    2081    <c>Miscellaneous warning</c>
    2082    <c><xref target="header.warning"/></c>
    2083 
     2100   <c>Miscellaneous Warning</c>
     2101   <c>
     2102      <xref target="warn.199"/>
     2103   </c>
    20842104   <c>214</c>
    2085    <c>Transformation applied</c>
    2086    <c><xref target="header.warning"/></c>
    2087 
     2105   <c>Transformation Applied</c>
     2106   <c>
     2107      <xref target="warn.214"/>
     2108   </c>
    20882109   <c>299</c>
    2089    <c>Miscellaneous persistent warning</c>
    2090    <c><xref target="header.warning"/></c>
     2110   <c>Miscellaneous Persistent Warning</c>
     2111   <c>
     2112      <xref target="warn.299"/>
     2113   </c>
    20912114</texttable>
     2115<!--(END)-->
     2116<?ENDINC p6-cache.iana-warn-codes ?>
    20922117</section>
    20932118</section>
Note: See TracChangeset for help on using the changeset viewer.