Ticket #43: i43resolution.diff

p2-semantics.xml

@@ -3959 +3959 @@
 
 </references>
 
+<section title="Base Fragment Aware Relative Resolution">
+<t>
+  <xref target="RFC3986" x:fmt="of" x:sec="5.2"/> defines the Relative Resolution
+  of a URI reference against a Base URI. That algorithm however does not take a
+  fragment identifier on the Base URI into account.
+</t>
+<t>
+  However in some cases, as when following a redirect from a URI "Base" based
+  on a Location header field containing the URI reference "R", it can be
+  necessary to preserve a fragment identifier present on "Base". The algorithm described below does this:
+</t>
+<t>
+  Given a URI reference "R" and a base URI "Base", to transform R into its
+  target URI "T":
+</t>
+<t>
+  (1) Pre-parse the Base URI as defined in <xref target="RFC3986" x:fmt="of" x:sec="5.2.1"/>.
+</t>
+<t>
+  (2) Transform references as defined in <xref target="RFC3986" x:fmt="of" x:sec="5.2.2"/>.
+  If the T.fragment is undefined and Base.fragment is defined, then set
+  T.fragment to Base.fragment:
+</t>
+<figure><artwork type="text/plain">
+  if defined(Base.fragment) and not(defined(T.fragment)) then
+    T.fragment = Base.fragment;
+  endif;
+</artwork></figure>
+<t>
+  (3) Merge paths as defined in <xref target="RFC3986" x:fmt="of" x:sec="5.2.3"/>.
+</t>
+<t>
+  (4) Remove dot segments as defined in <xref target="RFC3986" x:fmt="of" x:sec="5.2.4"/>.
+</t>
+<t>
+  (5) Finally, recompose the components as defined in <xref target="RFC3986" x:fmt="of" x:sec="5.3"/>.
+</t>
+<section title="Examples">
+<t>
+  Starting with a Base URI of "http://host/path1#f1":
+</t>
+<texttable>
+  <ttcol>R</ttcol>
+  <ttcol>T (after RFC 3986 Relative Resolution)</ttcol>
+  <ttcol>T (after Base Fragment Aware Relative Resolution)</ttcol>
+  
+  <c>/path2</c>
+  <c>http://host/path2</c>
+  <c>http://host/path2#f1</c>
+
+  <c>/path2#f2</c>
+  <c>http://host/path2#f2</c>
+  <c>http://host/path2#f2</c>
+</texttable>
+
+</section>
+</section>
+
 <section title="Changes from RFC 2616" anchor="changes.from.rfc.2616">
 <t>
   This document takes over the Status Code Registry, previously defined