[html5] r3125 - [] (0) Clarify how registered handlers work a little. (bug 6457)

[whatwg at whatwg.org]

Author: ianh
Date: 2009-05-25 15:10:39 -0700 (Mon, 25 May 2009)
New Revision: 3125

Modified:
   index
   source
Log:
[] (0) Clarify how registered handlers work a little. (bug 6457)

Modified: index
===================================================================
--- index	2009-05-25 02:34:56 UTC (rev 3124)
+++ index	2009-05-25 22:10:39 UTC (rev 3125)
@@ -49008,9 +49008,10 @@
     a url">resolve</a> the resulting URL, relative to the <a href="#script's-base-url" title="script's base URL">base URL</a> of the <a href=#first-script>first
     script</a> at the time the <code title=dom-navigator-registerContentHandler><a href=#dom-navigator-registercontenthandler>registerContentHandler()</a></code>
     or <code title=dom-navigator-registerProtocolHandler><a href=#dom-navigator-registerprotocolhandler>registerProtocolHandler()</a></code>
-    methods were invoked, and then <a href=#fetch>fetch</a> the resulting
-    URL using the GET method (<a href=#concept-http-equivalent-get title=concept-http-equivalent-get>or equivalent</a> for
-    non-HTTP URLs).</p>
+    methods were invoked, and then <a href=#navigate>navigate</a> an
+    appropriate <a href=#browsing-context>browsing context</a> to the resulting URL
+    using the GET method (<a href=#concept-http-equivalent-get title=concept-http-equivalent-get>or
+    equivalent</a> for non-HTTP URLs).</p>
 
     <p>To get the escaped version of the <a href=#absolute-url>absolute URL</a> of
     the content in question, the user agent must replace every
@@ -51511,13 +51512,21 @@
    equivalent</a>, then <a href=#scroll-to-fragid title=navigate-fragid>navigate to
    that fragment identifier</a> and abort these steps.</li>
 
-   <li><p>If the new resource is to be handled by displaying some sort
-   of inline content, e.g. an error message because the specified
-   scheme is not one of the supported protocols, or an inline prompt
-   to allow the user to select <a href=#dom-navigator-registerprotocolhandler title=dom-navigator-registerProtocolHandler>a registered
-   handler</a> for the given scheme, then <a href=#read-ua-inline title=navigate-ua-inline>display the inline content</a> and
-   abort these steps.</li>
+   <li>
 
+    <p>If the new resource is to be handled by displaying some sort of
+    inline content, e.g. an error message because the specified scheme
+    is not one of the supported protocols, or an inline prompt to
+    allow the user to select <a href=#dom-navigator-registerprotocolhandler title=dom-navigator-registerProtocolHandler>a registered
+    handler</a> for the given scheme, then <a href=#read-ua-inline title=navigate-ua-inline>display the inline content</a> and
+    abort these steps.</p>
+
+    <p class=note>In the case of a registered handler being used,
+    the algorithm will be reinvoked with a new URL to handle the
+    request.</p>
+
+   </li>
+
    <li><p>If the new resource is to be handled using a mechanism that
    does not affect the browsing context, e.g. ignoring the navigation
    request altogether because the specified scheme is not one of the
@@ -51718,14 +51727,21 @@
 
    </li>
 
-   <li id=navigate-non-Document><p><i>Non-document content</i>: If,
-   given <var title="">type</var>, the new resource is to be handled
-   by displaying some sort of inline content, e.g. a native rendering
-   of the content, an error message because the specified type is not
-   supported, or an inline prompt to allow the user to select <a href=#dom-navigator-registercontenthandler title=dom-navigator-registerContentHandler>a registered
-   handler</a> for the given type, then <a href=#read-ua-inline title=navigate-ua-inline>display the inline content</a> and
-   abort these steps.</li>
+   <li id=navigate-non-Document>
 
+    <p><i>Non-document content</i>: If, given <var title="">type</var>, the new resource is to be handled by
+    displaying some sort of inline content, e.g. a native rendering of
+    the content, an error message because the specified type is not
+    supported, or an inline prompt to allow the user to select <a href=#dom-navigator-registercontenthandler title=dom-navigator-registerContentHandler>a registered
+    handler</a> for the given type, then <a href=#read-ua-inline title=navigate-ua-inline>display the inline content</a> and
+    abort these steps.</p>
+
+    <p class=note>In the case of a registered handler being used,
+    the algorithm will be reinvoked with a new URL to handle the
+    request.</p>
+
+   </li>
+
    <li><p>Otherwise, the document's <var title="">type</var> is such
    that the resource will not affect the browsing context,
    e.g. because the resource is to be handed to an external

Modified: source
===================================================================
--- source	2009-05-25 02:34:56 UTC (rev 3124)
+++ source	2009-05-25 22:10:39 UTC (rev 3125)
@@ -55896,10 +55896,10 @@
     title="dom-navigator-registerContentHandler">registerContentHandler()</code>
     or <code
     title="dom-navigator-registerProtocolHandler">registerProtocolHandler()</code>
-    methods were invoked, and then <span>fetch</span> the resulting
-    URL using the GET method (<span
-    title="concept-http-equivalent-get">or equivalent</span> for
-    non-HTTP URLs).</p>
+    methods were invoked, and then <span>navigate</span> an
+    appropriate <span>browsing context</span> to the resulting URL
+    using the GET method (<span title="concept-http-equivalent-get">or
+    equivalent</span> for non-HTTP URLs).</p>
 
     <p>To get the escaped version of the <span>absolute URL</span> of
     the content in question, the user agent must replace every
@@ -58823,15 +58823,23 @@
    equivalent</span>, then <span title="navigate-fragid">navigate to
    that fragment identifier</span> and abort these steps.</p></li>
 
-   <li><p>If the new resource is to be handled by displaying some sort
-   of inline content, e.g. an error message because the specified
-   scheme is not one of the supported protocols, or an inline prompt
-   to allow the user to select <span
-   title="dom-navigator-registerProtocolHandler">a registered
-   handler</span> for the given scheme, then <span
-   title="navigate-ua-inline">display the inline content</span> and
-   abort these steps.</p></li>
+   <li>
 
+    <p>If the new resource is to be handled by displaying some sort of
+    inline content, e.g. an error message because the specified scheme
+    is not one of the supported protocols, or an inline prompt to
+    allow the user to select <span
+    title="dom-navigator-registerProtocolHandler">a registered
+    handler</span> for the given scheme, then <span
+    title="navigate-ua-inline">display the inline content</span> and
+    abort these steps.</p>
+
+    <p class="note">In the case of a registered handler being used,
+    the algorithm will be reinvoked with a new URL to handle the
+    request.</p>
+
+   </li>
+
    <li><p>If the new resource is to be handled using a mechanism that
    does not affect the browsing context, e.g. ignoring the navigation
    request altogether because the specified scheme is not one of the
@@ -59060,16 +59068,24 @@
 
    </li>
 
-   <li id="navigate-non-Document"><p><i>Non-document content</i>: If,
-   given <var title="">type</var>, the new resource is to be handled
-   by displaying some sort of inline content, e.g. a native rendering
-   of the content, an error message because the specified type is not
-   supported, or an inline prompt to allow the user to select <span
-   title="dom-navigator-registerContentHandler">a registered
-   handler</span> for the given type, then <span
-   title="navigate-ua-inline">display the inline content</span> and
-   abort these steps.</p></li>
+   <li id="navigate-non-Document">
 
+    <p><i>Non-document content</i>: If, given <var
+    title="">type</var>, the new resource is to be handled by
+    displaying some sort of inline content, e.g. a native rendering of
+    the content, an error message because the specified type is not
+    supported, or an inline prompt to allow the user to select <span
+    title="dom-navigator-registerContentHandler">a registered
+    handler</span> for the given type, then <span
+    title="navigate-ua-inline">display the inline content</span> and
+    abort these steps.</p>
+
+    <p class="note">In the case of a registered handler being used,
+    the algorithm will be reinvoked with a new URL to handle the
+    request.</p>
+
+   </li>
+
    <li><p>Otherwise, the document's <var title="">type</var> is such
    that the resource will not affect the browsing context,
    e.g. because the resource is to be handed to an external