Ignore:
Timestamp:
Jul 4, 2012, 12:22:01 PM (7 years ago)
Author:
julian.reschke@…
Message:

Work-in-progress: hyperlink status codes definitions (3xx range)

File:
1 edited

Legend:

Unmodified
Added
Removed
  • draft-ietf-httpbis/latest/p2-semantics.xml

    r1713 r1714  
    686686<t>
    687687   Note that POST caching is not widely implemented.
    688    However, the 303 (See Other) response can be used to direct the
    689    user agent to retrieve a cacheable representation of the resource.
     688   However, the <x:ref>303 (See Other)</x:ref> response can be used to direct
     689   the user agent to retrieve a cacheable representation of the resource.
    690690</t>
    691691</section>
     
    779779   wishes to have it applied to a different resource, such as when the
    780780   resource has been moved to a different URI, then the origin server
    781    &MUST; send a 301 (Moved Permanently) response; the user agent &MAY;
    782    then make its own decision regarding whether or not to redirect the
    783    request.
     781   &MUST; send a <x:ref>301 (Moved Permanently)</x:ref> response; the user
     782   agent &MAY; then make its own decision regarding whether or not to redirect
     783   the request.
    784784</t>
    785785<t>
     
    15161516          Redirects of the request to another URI, either temporarily or
    15171517          permanently. The new URI is specified in the Location header field.
    1518           In this specification, the status codes 301 (Moved Permanently),
    1519           302 (Found), and 307 (Temporary Redirect) fall under this category.
     1518          In this specification, the status codes <x:ref>301 (Moved Permanently)</x:ref>,
     1519          <x:ref>302 (Found)</x:ref>, and <x:ref>307 (Temporary Redirect)</x:ref>
     1520          fall under this category.
    15201521        </t>
    15211522      </x:lt>
     
    15241525          Redirection to a new location that represents an indirect response to
    15251526          the request, such as the result of a POST operation to be retrieved
    1526           with a subsequent GET request. This is status code 303 (See Other).
     1527          with a subsequent GET request. This is status code <x:ref>303 (See
     1528          Other)</x:ref>.
    15271529        </t>
    15281530      </x:lt>
     
    15311533          Redirection offering a choice of matching resources for use by
    15321534          agent-driven content negotiation (&agent-driven-negotiation;). This
    1533           is status code 300 (Multiple Choices).
     1535          is status code <x:ref>300 (Multiple Choices)</x:ref>.
    15341536        </t>
    15351537      </x:lt>
     
    15441546<x:note>
    15451547  <t>
    1546     &Note; In HTTP/1.0, only the status codes 301 (Moved Permanently)
    1547     and 302 (Found) were defined for the first type of redirect, and the second
    1548     type did not exist at all (<xref target="RFC1945" x:fmt="," x:sec="9.3"/>).
     1548    &Note; In HTTP/1.0, only the status codes <x:ref>301 (Moved Permanently)</x:ref>
     1549    and <x:ref>302 (Found)</x:ref> were defined for the first type of redirect,
     1550    and the second type did not exist at all (<xref target="RFC1945" x:fmt="," x:sec="9.3"/>).
    15491551    However it turned out that web forms using POST expected redirects to change
    15501552    the operation for the subsequent request to retrieval (GET). To address this
    15511553    use case, HTTP/1.1 introduced the second type of redirect with the status
    1552     code 303 (See Other) (<xref target="RFC2068" x:fmt="," x:sec="10.3.4"/>).
     1554    code <x:ref>303 (See Other)</x:ref> (<xref target="RFC2068" x:fmt="," x:sec="10.3.4"/>).
    15531555    As user agents did not change their behavior to maintain backwards
    15541556    compatibility, the first revision of HTTP/1.1 added yet another status code,
    1555     307 (Temporary Redirect), for which the backwards compatibility problems did
    1556     not apply (<xref target="RFC2616" x:fmt="," x:sec="10.3.8"/>).
     1557    <x:ref>307 (Temporary Redirect)</x:ref>, for which the backwards
     1558    compatibility problems did not apply (<xref target="RFC2616" x:fmt="," x:sec="10.3.8"/>).
    15571559    Over 10 years later, most user agents still do method rewriting for
    15581560    status codes 301 and 302, therefore this specification makes that behavior
     
    15851587  <iref primary="true" item="300 Multiple Choices (status code)" x:for-anchor=""/>
    15861588  <iref primary="true" item="Status Codes" subitem="300 Multiple Choices" x:for-anchor=""/>
     1589  <x:anchor-alias value="300 (Multiple Choices)"/>
    15871590<t>
    15881591   The target resource has more than one
     
    16171620  <iref primary="true" item="301 Moved Permanently (status code)" x:for-anchor=""/>
    16181621  <iref primary="true" item="Status Codes" subitem="301 Moved Permanently" x:for-anchor=""/>
     1622  <x:anchor-alias value="301 (Moved Permanently)"/>
    16191623<t>
    16201624   The target resource has been assigned a new permanent URI and any
     
    16371641    &Note; For historic reasons, user agents &MAY; change the
    16381642    request method from POST to GET for the subsequent request. If this
    1639     behavior is undesired, status code 307 (Temporary Redirect) can be used
    1640     instead.
     1643    behavior is undesired, status code <x:ref>307 (Temporary Redirect)</x:ref>
     1644    can be used instead.
    16411645  </t>
    16421646</x:note>
     
    16461650  <iref primary="true" item="302 Found (status code)" x:for-anchor=""/>
    16471651  <iref primary="true" item="Status Codes" subitem="302 Found" x:for-anchor=""/>
     1652  <x:anchor-alias value="302 (Found)"/>
    16481653<t>
    16491654   The target resource resides temporarily under a different URI.
     
    16601665    &Note; For historic reasons, user agents &MAY; change the
    16611666    request method from POST to GET for the subsequent request. If this
    1662     behavior is undesired, status code 307 (Temporary Redirect) can be used
    1663     instead.
     1667    behavior is undesired, status code <x:ref>307 (Temporary Redirect)</x:ref>
     1668    can be used instead.
    16641669  </t>
    16651670</x:note>
     
    16691674  <iref primary="true" item="303 See Other (status code)" x:for-anchor=""/>
    16701675  <iref primary="true" item="Status Codes" subitem="303 See Other" x:for-anchor=""/>
     1676  <x:anchor-alias value="303 (See Other)"/>
    16711677<t>
    16721678   The 303 status code indicates that the server is redirecting the
     
    17291735  <iref primary="true" item="307 Temporary Redirect (status code)" x:for-anchor=""/>
    17301736  <iref primary="true" item="Status Codes" subitem="307 Temporary Redirect" x:for-anchor=""/>
     1737  <x:anchor-alias value="307 (Temporary Redirect)"/>
    17311738<t>
    17321739   The target resource resides temporarily under a different URI.
     
    17411748<x:note>
    17421749  <t>
    1743     &Note; This status code is similar to 302 Found, except that
    1744     it does not allow rewriting the request method from POST to GET. This
    1745     specification defines no equivalent counterpart for 301 Moved Permanently
    1746     (<xref target="draft-reschke-http-status-308"/>, however, defines the
    1747     status code 308 Permanent Redirect for this purpose).
     1750    &Note; This status code is similar to <x:ref>302 (Found)</x:ref>, except
     1751    that it does not allow rewriting the request method from POST to GET. This
     1752    specification defines no equivalent counterpart for <x:ref>301 (Moved
     1753    Permanently)</x:ref> (<xref target="draft-reschke-http-status-308"/>,
     1754    however, defines the status code 308 (Permanent Redirect) for this purpose).
    17481755  </t>
    17491756</x:note>
     
    29252932</t>
    29262933<t>
    2927    This specification defines the 300 (Multiple Choices) and <x:ref>406 (Not Acceptable)</x:ref>
    2928    status codes for enabling agent-driven negotiation when the server is
    2929    unwilling or unable to provide a varying response using server-driven
    2930    negotiation.
     2934   This specification defines the <x:ref>300 (Multiple Choices)</x:ref> and
     2935   <x:ref>406 (Not Acceptable)</x:ref> status codes for enabling agent-driven
     2936   negotiation when the server is unwilling or unable to provide a varying
     2937   response using server-driven negotiation.
    29312938</t>
    29322939</section>
Note: See TracChangeset for help on using the changeset viewer.