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:
2 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/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.