Ignore:
Timestamp:
Mar 10, 2010, 2:28:36 AM (10 years ago)
Author:
julian.reschke@…
Message:

Allow URI-reference instead of URI in Location; state that there are currently no defined precedence rules for fragment identifiers (relates to #43 and #185)

File:
1 edited

Legend:

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

    r773 r785  
    362362  <x:anchor-alias value="Range"/>
    363363  <x:anchor-alias value="TE"/>
    364   <x:anchor-alias value="URI"/>
     364  <x:anchor-alias value="URI-reference"/>
    365365  <x:anchor-alias value="Vary"/>
    366366  <x:anchor-alias value="WWW-Authenticate"/>
     
    376376  <x:ref>product</x:ref>       = &lt;product, defined in &product-tokens;&gt;
    377377  <x:ref>TE</x:ref>            = &lt;TE, defined in &header-te;&gt;
    378   <x:ref>URI</x:ref>           = &lt;URI, defined in &uri;&gt;
     378  <x:ref>URI-reference</x:ref> = &lt;URI-reference, defined in &uri;&gt;
    379379</artwork></figure>
    380380<figure><!--Part3--><artwork type="abnf2616">
     
    20422042</t>
    20432043<t>
    2044    The field value consists of a single URI.
     2044   The field value consists of a single URI-reference. When it has the form
     2045   of a relative reference (<xref target="RFC3986" x:fmt="," x:sec="4.2"/>),
     2046   the final value is computed by resolving it against the effective request
     2047   URI (<xref target="RFC3986" x:fmt="," x:sec="5"/>).
    20452048</t>
    20462049<figure><artwork type="abnf2616"><iref primary="true" item="Grammar" subitem="Location"/><iref primary="true" item="Grammar" subitem="Location-v"/>
    20472050  <x:ref>Location</x:ref>       = "Location" ":" <x:ref>OWS</x:ref> <x:ref>Location-v</x:ref>
    2048   <x:ref>Location-v</x:ref>     = <x:ref>URI</x:ref>
     2051  <x:ref>Location-v</x:ref>     = <x:ref>URI-reference</x:ref>
    20492052</artwork></figure>
    2050 <t>
    2051    An example is:
    2052 </t>
    2053 <figure><artwork type="example">
    2054   Location: http://www.example.org/pub/WWW/People.html
     2053<figure>
     2054<preamble>Examples are:</preamble><!--DO NOT DARE changing the vertical WSP below, it's necessary this way for xml2rfc-->
     2055<artwork type="example">
     2056  Location: http://www.example.org/pub/WWW/People.html#tim
     2057</artwork></figure><figure><artwork type="example">  Location: /index.html
    20552058</artwork></figure>
    20562059<t>
    2057    There are circumstances in which a fragment identifier in a Location URI would not be appropriate:
     2060   There are circumstances in which a fragment identifier in a Location URI
     2061   would not be appropriate:
    20582062   <list style="symbols">
    2059       <t>With a 201 Created response, because in this usage the Location header specifies the URI for the entire created resource.</t>
     2063      <t>With a 201 Created response, because in this usage the Location header
     2064      specifies the URI for the entire created resource.</t>
    20602065      <t>With 305 Use Proxy.</t>
    20612066   </list>
    20622067</t>
     2068<x:note>
     2069  <t>
     2070    <x:h>Note:</x:h> This specification does not define precedence rules
     2071    for the case where the original URI, as navigated to be the user
     2072    agent, and the Location header field value both contain fragment
     2073    identifiers.
     2074  </t>
     2075</x:note>
    20632076<x:note>
    20642077  <t>
     
    30023015</reference>
    30033016
     3017<reference anchor="RFC3986">
     3018 <front>
     3019  <title abbrev='URI Generic Syntax'>Uniform Resource Identifier (URI): Generic Syntax</title>
     3020  <author initials='T.' surname='Berners-Lee' fullname='Tim Berners-Lee'>
     3021    <organization abbrev="W3C/MIT">World Wide Web Consortium</organization>
     3022    <address>
     3023       <email>timbl@w3.org</email>
     3024       <uri>http://www.w3.org/People/Berners-Lee/</uri>
     3025    </address>
     3026  </author>
     3027  <author initials='R.' surname='Fielding' fullname='Roy T. Fielding'>
     3028    <organization abbrev="Day Software">Day Software</organization>
     3029    <address>
     3030      <email>fielding@gbiv.com</email>
     3031      <uri>http://roy.gbiv.com/</uri>
     3032    </address>
     3033  </author>
     3034  <author initials='L.' surname='Masinter' fullname='Larry Masinter'>
     3035    <organization abbrev="Adobe Systems">Adobe Systems Incorporated</organization>
     3036    <address>
     3037      <email>LMM@acm.org</email>
     3038      <uri>http://larry.masinter.net/</uri>
     3039    </address>
     3040  </author>
     3041  <date month='January' year='2005'></date>
     3042 </front>
     3043 <seriesInfo name="RFC" value="3986"/>
     3044 <seriesInfo name="STD" value="66"/>
     3045</reference>
     3046
    30043047<reference anchor="RFC5234">
    30053048  <front>
     
    32703313</t>
    32713314<t>
    3272   Correct syntax of Location header to allow fragment,
    3273   as referred symbol wasn't what was expected, and add some
    3274   clarifications as to when it would not be appropriate.
     3315  Correct syntax of Location header to allow URI references (including
     3316  relative references and fragments), as referred symbol "absoluteURI" wasn't
     3317  what was expected, and add some clarifications as to when use of fragments
     3318  would not be appropriate.
    32753319  (<xref target="header.location"/>)
    32763320</t>
     
    33223366
    33233367<x:ref>Location</x:ref> = "Location:" OWS Location-v
    3324 <x:ref>Location-v</x:ref> = URI
     3368<x:ref>Location-v</x:ref> = URI-reference
    33253369
    33263370<x:ref>Max-Forwards</x:ref> = "Max-Forwards:" OWS Max-Forwards-v
     
    33623406<x:ref>TE</x:ref> = &lt;TE, defined in [Part1], Section 9.8&gt;
    33633407
    3364 <x:ref>URI</x:ref> = &lt;URI, defined in [Part1], Section 2.6&gt;
     3408<x:ref>URI-reference</x:ref> = &lt;URI-reference, defined in [Part1], Section 2.6&gt;
    33653409<x:ref>User-Agent</x:ref> = "User-Agent:" OWS User-Agent-v
    33663410<x:ref>User-Agent-v</x:ref> = product *( RWS ( product / comment ) )
     
    37213765<section title="Since draft-ietf-httpbis-p2-semantics-09" anchor="changes.since.09">
    37223766<t>
    3723   None yet.
     3767  Closed issues:
     3768  <list style="symbols">
     3769    <t>
     3770      <eref target="http://tools.ietf.org/wg/httpbis/trac/ticket/43"/>:
     3771      "Fragment combination / precedence during redirects"
     3772    </t>
     3773  </list>
     3774</t>
     3775<t>
     3776  Partly resolved issues:
     3777  <list style="symbols">
     3778    <t>
     3779      <eref target="http://tools.ietf.org/wg/httpbis/trac/ticket/185"/>:
     3780      "Location header payload handling"
     3781    </t>
     3782  </list>
    37243783</t>
    37253784</section>
Note: See TracChangeset for help on using the changeset viewer.