[html5] r1814 - [] (0) URLify navigation and neighboring sections; fix validation errors

whatwg at whatwg.org whatwg at whatwg.org
Thu Jun 26 21:16:36 PDT 2008


Author: ianh
Date: 2008-06-26 21:16:35 -0700 (Thu, 26 Jun 2008)
New Revision: 1814

Modified:
   index
   source
Log:
[] (0) URLify navigation and neighboring sections; fix validation errors

Modified: index
===================================================================
--- index	2008-06-27 02:08:48 UTC (rev 1813)
+++ index	2008-06-27 04:16:35 UTC (rev 1814)
@@ -32659,10 +32659,10 @@
        "start of line".</p>
       <!-- SECURITY -->
       <p>If the resulting <a href="#absolute">absolute URL</a> for <var
-       title="">part two has a different <a href="#ltschemegt"
+       title="">part two</var> has a different <a href="#ltschemegt"
        title=url-scheme><scheme></a> component than the manifest's URL
        (compared case-insensitively<!-- XXX ASCII -->), then jump back to the
-       step labeled "start of line".</var></p>
+       step labeled "start of line".</p>
 
       <p>Drop any the <a href="#ltfragmentgt"
        title=url-fragment><fragment></a> components of the resulting <a
@@ -33437,12 +33437,13 @@
    href="#length8">length</a></code>-1</span>.
 
   <p>The <dfn id=itemindex4 title=dom-appcache-item><code>item(<var
-   title="">index</var>)</code></dfn> method must return the absolute URL of
-   the <a href="#dynamic3" title=concept-appcache-dynamic>dynamic entry</a>
-   with index <var title="">index</var> from the <a
-   href="#application0">application cache</a>, if one is associated with the
-   <code><a href="#applicationcache">ApplicationCache</a></code> object. If
-   the object is not associated with any application cache, or if the <var
+   title="">index</var>)</code></dfn> method must return the <a
+   href="#absolute">absolute URL</a> of the <a href="#dynamic3"
+   title=concept-appcache-dynamic>dynamic entry</a> with index <var
+   title="">index</var> from the <a href="#application0">application
+   cache</a>, if one is associated with the <code><a
+   href="#applicationcache">ApplicationCache</a></code> object. If the object
+   is not associated with any application cache, or if the <var
    title="">index</var> argument is lower than zero or greater than
    <span><code title=dom-appcache-length><a
    href="#length8">length</a></code>-1</span>, the method must instead raise
@@ -34179,8 +34180,7 @@
   <p>In addition, a user agent could ignore calls to <code
    title=dom-history-pushState><a href="#pushstate">pushState()</a></code>
    that are invoked on a timer, or from event handlers that do not represent
-   a clear user action, or that are invoked in rapid succession.</p>
-  <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXURL \(url\|uri\|iri\) -->
+   a clear user action, or that are invoked in rapid succession.
 
   <h3 id=browsing0><span class=secno>5.9 </span>Browsing the Web</h3>
 
@@ -34269,27 +34269,27 @@
      affect the browsing context, then abort these steps and proceed with
      that mechanism instead.
 
-   <li> <!-- XXXURL change to URL -->
+   <li>
     <p>If the new resource is to be fetched using HTTP GET or equivalent, and
      if the browsing context being navigated is a <a
      href="#top-level">top-level browsing context</a>, then check if there
      are any <a href="#application0" title="application cache">application
      caches</a> that have a <a href="#the-manifest"
      title=concept-appcache-manifest>manifest</a> with the <a
-     href="#same-origin">same origin</a> as the URI in question, and that
-     have this URI as one of their entries (excluding entries marked as <a
+     href="#same-origin">same origin</a> as the URL in question, and that
+     have this URL as one of their entries (excluding entries marked as <a
      href="#foreign" title=concept-appcache-foreign>foreign</a>), and that
      already contain their manifest, categorized as a <a href="#the-manifest"
      title=concept-appcache-manifest>manifest</a>. If so, then the user agent
      must then fetch the resource from the <a href="#select0"
      title=concept-appcache-selection>most appropriate application cache</a>
      of those that match.</p>
-    <!-- XXXURL JSURI issue -->
+
     <p>Otherwise, start fetching<!-- XXX xref --> the new resource in the
      appropriate manner (e.g. performing an HTTP GET or POST operation, or
      reading the file from disk, or executing script in the case of a <a
      href="#the-javascript" title="javascript protocol"><code
-     title="">javascript:</code> URI</a>). If this results in a redirect,
+     title="">javascript:</code> URL</a>). If this results in a redirect,
      return to <a href=navigate-fragid-step>the step labeled "fragment
      identifiers"</a> with the new resource.</p>
 
@@ -34310,10 +34310,10 @@
      user agent may allow the user to cancel this navigation attempt or start
      other navigation attempts.
 
-   <li> <!-- XXXURL change to URL, "fetch"? -->
+   <li>
     <p>If the resource was not fetched from an <a
      href="#application0">application cache</a>, and was to be fetched using
-     HTTP GET or equivalent, and its URI <a href="#matches"
+     HTTP GET or equivalent, and its URL <a href="#matches"
      title=concept-appcache-matches-oppcache>matches the opportunistic
      caching namespace</a> of one or more application caches, and the user
      didn't cancel the navigation attempt during the previous step, then:</p>
@@ -34336,13 +34336,13 @@
        title=concept-appcache-foreign>foreign</a>, then the user agent must
        discard the failed load and instead continue along these steps using
        <var title="">candidate</var> as the resource.</p>
-      <!-- XXXURL change to URL -->
+
       <p>For the purposes of session history (and features that depend on
-       session history, e.g. bookmarking) the user agent must use the URI of
+       session history, e.g. bookmarking) the user agent must use the URL of
        the resource that was requested (the one that matched the
        opportunistic caching namespace), not the fallback resource. However,
        the user agent may indicate to the user that the original page load
-       failed, that the page used was a fallback resource, and what the URI
+       failed, that the page used was a fallback resource, and what the URL
        of the fallback resource actually is.</p>
 
      <dt>Otherwise
@@ -34560,26 +34560,26 @@
    that must be used when determining the character encoding according to the
    rules given in the above specifications. Once the character encoding is
    established, the <a href="#character1">document's character encoding</a>
-   must be set to that character encoding.</p>
-  <!-- XXXURL change to URL, (algorithms?) -->
+   must be set to that character encoding.
 
   <p>If the root element, as parsed according to the XML specifications cited
    above, is found to be an <code><a href="#html">html</a></code> element
    with an attribute <code title=attr-html-manifest><a
    href="#manifest">manifest</a></code>, then, as soon as the element is
-   inserted into the DOM, the user agent must run the <a href="#application2"
+   inserted into the DOM, the user agent must <a href="#resolve"
+   title="resolve a url">resolve</a> the value of that attribute, and if that
+   is successful, must run the <a href="#application2"
    title=concept-appcache-init-with-attribute>application cache selection
-   algorithm</a> with the value of that attribute, resolved relative to the
-   <span>element's base URI</span>, as the manifest URI. Otherwise, as soon
-   as the root element is inserted into the DOM, the user agent must run the
-   <a href="#application3"
+   algorithm</a> with the resulting <a href="#absolute">absolute URL</a> as
+   the manifest URL. Otherwise, if the attribute is absent or resolving it
+   fails, then as soon as the root element is inserted into the DOM, the user
+   agent must run the <a href="#application3"
    title=concept-appcache-init-no-attribute>application cache selection
-   algorithm</a> with no manifest.</p>
-  <!-- XXXURL change to URL -->
+   algorithm</a> with no manifest.
 
   <p class=note>Because the processing of the <code
    title=attr-html-manifest><a href="#manifest">manifest</a></code> attribute
-   happens only once the root element is parsed, any URIs referenced by
+   happens only once the root element is parsed, any URLs referenced by
    processing instructions before the root element (such as <code
    title=""><?xml-styleesheet?></code> and <code
    title=""><?xbl?></code> PIs) will be fetched from the network and
@@ -34757,12 +34757,12 @@
 
   <h4 id=scroll-to-fragid><span class=secno>5.9.8 </span><dfn id=navigating0
    title=navigate-fragid>Navigating to a fragment identifier</dfn></h4>
-  <!-- XXXURL change to URL; XXXDOCURL? -->
 
   <p>When a user agent is supposed to navigate to a fragment identifier, then
    the user agent must <a href="#update2">update the session history with the
    new page</a>, where "the new page" has the same <code>Document</code> as
-   before but with the URI having the newly specified fragment identifier.
+   before but with the URL having the newly specified fragment identifier.</p>
+  <!-- XXXDOCURL ? -->
 
   <p>Part of that algorithm involves the user agent having to <a
    href="#scroll">scroll to the fragment identifier</a>, which is the
@@ -34785,14 +34785,15 @@
    following processing model must be followed to determine what <a
    href="#the-indicated">the indicated part of the document</a> is.
 
-  <ol><!-- XXXURL algorithms -->
-
+  <ol>
    <li>
-    <p>Let <i>fragid</i> be the <fragment> part of the URI. <a
-     href="#refsRFC3987">[RFC3987]</a>
+    <p><a href="#parse0" title="parse a url">Parse</a> the <a
+     href="#url">URL</a>, and let <i>fragid</i> be the <a
+     href="#ltfragmentgt" title=url-fragment><fragment></a> component
+     of the URL.
    </li>
-   <!-- IRI,
-   ifragment? XXXURL (refer to parsing defined in this spec) -->
+   <!-- parsing can't fail, since we checked earlier on
+   when navigating -->
 
    <li>
     <p>If <i>fragid</i> is the empty string, then the indicated part of the
@@ -34928,16 +34929,14 @@
     <p>If the <i>specified entry</i> is a state object or the first entry for
      a <code>Document</code>, the user agent must <a href="#activating0"
      title="activate the state object">activate that entry</a>.
-   </li>
-   <!-- XXXURL change to URL -->
 
    <li>
-    <p>If the <i>specified entry</i> has a URI that differs from the <a
+    <p>If the <i>specified entry</i> has a URL that differs from the <a
      href="#current1">current entry</a>'s only by its fragment identifier,
      and the two share the same <code>Document</code> object, then <a
      href="#firing2">fire a simple event</a> with the name
      <code>hashchanged</code> at <a href="#the-body1">the <code>body</code>
-     element</a>, and, if the new URI has a fragment identifier, <a
+     element</a>, and, if the new URL has a fragment identifier, <a
      href="#scroll">scroll to the fragment identifier</a>.
 
    <li>
@@ -36049,12 +36048,11 @@
    this information to the third party along with any identifying information
    (names, credit card numbers, addresses) obtained by the site. If a third
    party cooperates with multiple sites to obtain such information, a profile
-   can still be created.</p>
-  <!-- XXXURL change to URL -->
+   can still be created.
 
   <p>However, user tracking is to some extent possible even with no
    cooperation from the user agent whatsoever, for instance by using session
-   identifiers in URIs, a technique already commonly used for innocuous
+   identifiers in URLs, a technique already commonly used for innocuous
    purposes but easily repurposed for user tracking (even retroactively).
    This information can then be shared with other sites, using using
    visitors' IP addresses and other user-specific data (e.g. user-agent
@@ -36137,7 +36135,8 @@
    title="">?</code> placeholder feature of the <code
    title=dom-sqltransaction-executeSql><a
    href="#executesql">executeSql()</a></code> method, and to never construct
-   SQL statements on the fly.
+   SQL statements on the fly.</p>
+  <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXURL \(url\|uri\|iri\) -->
 
   <h3 id=links><span class=secno>5.11 </span>Links</h3>
 

Modified: source
===================================================================
--- source	2008-06-27 02:08:48 UTC (rev 1813)
+++ source	2008-06-27 04:16:35 UTC (rev 1814)
@@ -30327,7 +30327,7 @@
       labeled "start of line".</p> <!-- SECURITY -->
 
       <p>If the resulting <span>absolute URL</span> for <var
-      title="">part two</span> has a different <span
+      title="">part two</var> has a different <span
       title="url-scheme"><scheme></span> component than the
       manifest's URL (compared case-insensitively<!-- XXX ASCII -->),
       then jump back to the step labeled "start of line".</p>
@@ -31138,16 +31138,16 @@
   title="dom-appcache-length">length</code>-1</span>.</p>
 
   <p>The <dfn title="dom-appcache-item"><code>item(<var
-  title="">index</var>)</code></dfn> method must return the absolute
-  URL</span> of the <span title="concept-appcache-dynamic">dynamic
-  entry</span> with index <var title="">index</var> from the
-  <span>application cache</span>, if one is associated with the
-  <code>ApplicationCache</code> object. If the object is not
-  associated with any application cache, or if the <var
-  title="">index</var> argument is lower than zero or greater than
-  <span><code title="dom-appcache-length">length</code>-1</span>, the
-  method must instead raise an <code>INDEX_SIZE_ERR</code>
-  exception.</p>
+  title="">index</var>)</code></dfn> method must return the
+  <span>absolute URL</span> of the <span
+  title="concept-appcache-dynamic">dynamic entry</span> with index
+  <var title="">index</var> from the <span>application cache</span>,
+  if one is associated with the <code>ApplicationCache</code>
+  object. If the object is not associated with any application cache,
+  or if the <var title="">index</var> argument is lower than zero or
+  greater than <span><code
+  title="dom-appcache-length">length</code>-1</span>, the method must
+  instead raise an <code>INDEX_SIZE_ERR</code> exception.</p>
 
   <p>The <dfn title="dom-appcache-add"><code>add(<var
   title="">url</var>)</code></dfn> method must run the following
@@ -31860,8 +31860,8 @@
   action, or that are invoked in rapid succession.</p>
 
 
-  <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXURL \(url\|uri\|iri\) -->
 
+
   <h3>Browsing the Web</h3>
 
   <h4>Navigating across documents</h4>
@@ -31945,14 +31945,13 @@
 
    <li>
 
-    <!-- XXXURL change to URL -->
     <p>If the new resource is to be fetched using HTTP GET or
     equivalent, and if the browsing context being navigated is a
     <span>top-level browsing context</span>, then check if there are
     any <span title="application cache">application caches</span> that
     have a <span title="concept-appcache-manifest">manifest</span>
-    with the <span>same origin</span> as the URI in question, and that
-    have this URI as one of their entries (excluding entries marked as
+    with the <span>same origin</span> as the URL in question, and that
+    have this URL as one of their entries (excluding entries marked as
     <span title="concept-appcache-foreign">foreign</span>), and that
     already contain their manifest, categorized as a <span
     title="concept-appcache-manifest">manifest</span>. If so, then the
@@ -31960,12 +31959,11 @@
     title="concept-appcache-selection">most appropriate application
     cache</span> of those that match.</p>
 
-    <!-- XXXURL JSURI issue -->
     <p>Otherwise, start fetching<!-- XXX xref --> the new resource in
     the appropriate manner (e.g. performing an HTTP GET or POST
     operation, or reading the file from disk, or executing script in
     the case of a <span title="javascript protocol"><code
-    title="">javascript:</code> URI</span>). If this results in a
+    title="">javascript:</code> URL</span>). If this results in a
     redirect, return to <a href="navigate-fragid-step">the step
     labeled "fragment identifiers"</a> with the new resource.</p>
 
@@ -31990,10 +31988,9 @@
 
    <li>
 
-    <!-- XXXURL change to URL, "fetch"? -->
     <p>If the resource was not fetched from an <span>application
     cache</span>, and was to be fetched using HTTP GET or equivalent,
-    and its URI <span
+    and its URL <span
     title="concept-appcache-matches-oppcache">matches the
     opportunistic caching namespace</span> of one or more application
     caches, and the user didn't cancel the navigation attempt during
@@ -32022,14 +32019,13 @@
       these steps using <var title="">candidate</var> as the
       resource.</p>
 
-      <!-- XXXURL change to URL -->
       <p>For the purposes of session history (and features that depend
       on session history, e.g. bookmarking) the user agent must use
-      the URI of the resource that was requested (the one that matched
+      the URL of the resource that was requested (the one that matched
       the opportunistic caching namespace), not the fallback
       resource. However, the user agent may indicate to the user that
       the original page load failed, that the page used was a fallback
-      resource, and what the URI of the fallback resource actually
+      resource, and what the URL of the fallback resource actually
       is.</p>
 
      </dd>
@@ -32264,24 +32260,24 @@
   <span>document's character encoding</span> must be set to that
   character encoding.</p>
 
-  <!-- XXXURL change to URL, (algorithms?) -->
   <p>If the root element, as parsed according to the XML
   specifications cited above, is found to be an <code>html</code>
   element with an attribute <code
   title="attr-html-manifest">manifest</code>, then, as soon as the
-  element is inserted into the DOM, the user agent must run the <span
+  element is inserted into the DOM, the user agent must <span
+  title="resolve a url">resolve</span> the value of that attribute,
+  and if that is successful, must run the <span
   title="concept-appcache-init-with-attribute">application cache
-  selection algorithm</span> with the value of that attribute,
-  resolved relative to the <span>element's base URI</span>, as the
-  manifest URI. Otherwise, as soon as the root element is inserted
-  into the DOM, the user agent must run the <span
+  selection algorithm</span> with the resulting <span>absolute
+  URL</span> as the manifest URL. Otherwise, if the attribute is
+  absent or resolving it fails, then as soon as the root element is
+  inserted into the DOM, the user agent must run the <span
   title="concept-appcache-init-no-attribute">application cache
   selection algorithm</span> with no manifest.</p>
 
-  <!-- XXXURL change to URL -->
   <p class="note">Because the processing of the <code
   title="attr-html-manifest">manifest</code> attribute happens
-  only once the root element is parsed, any URIs referenced by
+  only once the root element is parsed, any URLs referenced by
   processing instructions before the root element (such as <code
   title=""><?xml-styleesheet?></code> and <code
   title=""><?xbl?></code> PIs) will be fetched from the network and
@@ -32456,12 +32452,11 @@
 
   <h4 id="scroll-to-fragid"><dfn title="navigate-fragid">Navigating to a fragment identifier</dfn></h4>
 
-  <!-- XXXURL change to URL; XXXDOCURL? -->
   <p>When a user agent is supposed to navigate to a fragment
   identifier, then the user agent must <span>update the session
   history with the new page</span>, where "the new page" has the same
-  <code>Document</code> as before but with the URI having the newly
-  specified fragment identifier.</p>
+  <code>Document</code> as before but with the URL having the newly
+  specified fragment identifier.</p><!-- XXXDOCURL ? -->
 
   <p>Part of that algorithm involves the user agent having to
   <span>scroll to the fragment identifier</span>, which is the
@@ -32487,10 +32482,11 @@
 
   <ol>
 
-   <!-- XXXURL algorithms -->
-   <li><p>Let <i>fragid</i> be the <fragment> part of the
-   URI. <a href="#refsRFC3987">[RFC3987]</a></p></li> <!-- IRI,
-   ifragment? XXXURL (refer to parsing defined in this spec) -->
+   <li><p><span title="parse a url">Parse</span> the <span>URL</span>,
+   and let <i>fragid</i> be the <span
+   title="url-fragment"><fragment></span> component of the
+   URL.</p></li><!-- parsing can't fail, since we checked earlier on
+   when navigating -->
 
    <li><p>If <i>fragid</i> is the empty string, then the indicated
    part of the document is the top of the document.</p></li>
@@ -32638,13 +32634,12 @@
    title="activate the state object">activate that
    entry</span>.</p></li>
 
-   <!-- XXXURL change to URL -->
-   <li><p>If the <i>specified entry</i> has a URI that differs
+   <li><p>If the <i>specified entry</i> has a URL that differs
    from the <span>current entry</span>'s only by its fragment
    identifier, and the two share the same <code>Document</code>
    object, then <span>fire a simple event</span> with the name
    <code>hashchanged</code> at <span>the <code>body</code>
-   element</span>, and, if the new URI has a fragment identifier,
+   element</span>, and, if the new URL has a fragment identifier,
    <span>scroll to the fragment identifier</span>.</p></li>
 
    <li><p>User agents may also update other aspects of the document
@@ -33775,10 +33770,9 @@
   sites to obtain such information, a profile can still be
   created.</p>
 
-  <!-- XXXURL change to URL -->
   <p>However, user tracking is to some extent possible even with no
   cooperation from the user agent whatsoever, for instance by using
-  session identifiers in URIs, a technique already commonly used for
+  session identifiers in URLs, a technique already commonly used for
   innocuous purposes but easily repurposed for user tracking (even
   retroactively). This information can then be shared with other
   sites, using using visitors' IP addresses and other user-specific
@@ -33873,6 +33867,8 @@
 
 
 
+  <!-- XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXURL \(url\|uri\|iri\) -->
+
   <h3 id="links">Links</h3>
 
 




More information about the Commit-Watchers mailing list