hixie: Move things more towards what people want (details to be sorted out later by change proposal, I expect). (whatwg r4974)

hixie: Move things more towards what people want (details to be sorted
out later by change proposal, I expect). (whatwg r4974)

http://dev.w3.org/cvsweb/html5/spec/Overview.html?r1=1.3996&r2=1.3997&f=h
http://html5.org/tools/web-apps-tracker?from=4973&to=4974

===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.3996
retrieving revision 1.3997
diff -u -d -r1.3996 -r1.3997
--- Overview.html 5 Apr 2010 22:52:24 -0000 1.3996
+++ Overview.html 6 Apr 2010 00:08:15 -0000 1.3997
@@ -285,7 +285,7 @@
    <h1>HTML5</h1>
    <h2 class="no-num no-toc" id="a-vocabulary-and-associated-apis-for-html-and-xhtml">A vocabulary and associated APIs for HTML and XHTML</h2>
 
-   <h2 class="no-num no-toc" id="editor-s-draft-5-april-2010">Editor's Draft 5 April 2010</h2>
+   <h2 class="no-num no-toc" id="editor-s-draft-6-april-2010">Editor's Draft 6 April 2010</h2>
    <dl><dt>Latest Published Version:</dt>
     <dd><a href="http://www.w3.org/TR/html5/">http://www.w3.org/TR/html5/</a></dd>
     <dt>Latest Editor's Draft:</dt>
@@ -392,7 +392,7 @@
   specification's progress along the W3C Recommendation
   track.
 
-  This specification is the 5 April 2010 Editor's Draft.
+  This specification is the 6 April 2010 Editor's Draft.
   </p><!-- UNDER NO CIRCUMSTANCES IS THE PRECEDING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><!-- relationship to other work (required) --><p>The contents of this specification are also part of <a href="http://www.whatwg.org/specs/web-apps/current-work/multipage/">a
   specification</a> published by the <a href="http://www.whatwg.org/">WHATWG</a>, which is available under a
   license that permits reuse of the specification text.</p><!-- UNDER NO CIRCUMSTANCES IS THE FOLLOWING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><!-- required patent boilerplate --><p>This document was produced by a group operating under the <a href="http://www.w3.org/Consortium/Patent-Policy-20040205/">5
@@ -4843,26 +4843,27 @@
   the empty string, a string consisting of only <a href="#space-character" title="space
   character">space characters</a>, or is a media query that matches
   the user's environment according to the definitions given in the
-  Media Queries specification. <a href="#refsMQ">[MQ]</a><h3 id="urls"><span class="secno">2.5 </span>URLs</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments. </i><span><a href="http://www.w3.org/html/wg/tracker/issues/56">ISSUE-56</a> (urls-webarch) and <a href="http://www.w3.org/html/wg/tracker/issues/78">ISSUE-78</a> (urls-terminology) block progress to Last Call</span><h4 id="terminology-0"><span class="secno">2.5.1 </span>Terminology</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i><p>A <dfn id="url">URL</dfn> is a string used to identify a resource.<p>A <a href="#url">URL</a> is a <dfn id="valid-url">valid URL</dfn> if it is a
-  <span>valid Web address</span> as defined by the Web addresses
-  specification. <a href="#refsWEBADDRESSES">[WEBADDRESSES]</a><p>A <a href="#url">URL</a> is a <dfn id="valid-non-empty-url">valid non-empty URL</dfn> if it is a
-  <a href="#valid-url">valid URL</a> but it is not the empty string.<p>A <a href="#url">URL</a> is an <dfn id="absolute-url">absolute URL</dfn> if it is an
-  <span>absolute Web address</span> as defined by the Web addresses
-  specification. <a href="#refsWEBADDRESSES">[WEBADDRESSES]</a><p>An <a href="#absolute-url">absolute URL</a> is a <dfn id="hierarchical-url">hierarchical URL</dfn> if,
-  when <a href="#parse-a-url" title="parse a url">parsed</a>, there is a character
-  immediately after the <a href="#url-scheme" title="url-scheme">&lt;scheme&gt;</a>
-  component and it is a U+002F SOLIDUS character (/).<p>An <a href="#absolute-url">absolute URL</a> is an <dfn id="authority-based-url">authority-based URL</dfn>
-  if, when <a href="#parse-a-url" title="parse a url">parsed</a>, there are two
-  characters immediately after the <a href="#url-scheme" title="url-scheme">&lt;scheme&gt;</a> component and they are both
-  U+002F SOLIDUS characters (//).<div class="impl">
+  Media Queries specification. <a href="#refsMQ">[MQ]</a><h3 id="urls"><span class="secno">2.5 </span>URLs</h3><p class="XXX annotation"><b>Status: </b><i>Last call for comments. </i><span><a href="http://www.w3.org/html/wg/tracker/issues/56">ISSUE-56</a> (urls-webarch) and <a href="http://www.w3.org/html/wg/tracker/issues/78">ISSUE-78</a> (urls-terminology) block progress to Last Call</span><h4 id="terminology-0"><span class="secno">2.5.1 </span>Terminology</h4><p class="XXX annotation"><b>Status: </b><i>Last call for comments</i></p><!-- see also: svn diff -r3244:3245 source --><p>A <dfn id="url">URL</dfn> is a string used to identify a resource.<p>A <a href="#url">URL</a> is a <dfn id="valid-url">valid URL</dfn> if at least one of
+  the following conditions holds:<ul><li><p>The <a href="#url">URL</a> is a valid URI reference <a href="#refsRFC3986">[RFC3986]</a>.</li>
+
+   <li><p>The <a href="#url">URL</a> is a valid IRI reference and it has no
+   query component. <a href="#refsRFC3987">[RFC3987]</a></li>
+
+   <li><p>The <a href="#url">URL</a> is a valid IRI reference and its query
+   component contains no unescaped non-ASCII characters. <a href="#refsRFC3987">[RFC3987]</a></li>
+
+   <li><p>The <a href="#url">URL</a> is a valid IRI reference and the <a href="#document-s-character-encoding" title="document's character encoding">character encoding</a> of
+   the URL's <code><a href="#document">Document</a></code> is UTF-8 or UTF-16. <a href="#refsRFC3987">[RFC3987]</a></li>
+
+  </ul><p>A <a href="#url">URL</a> is a <dfn id="valid-non-empty-url">valid non-empty URL</dfn> if it is a
+  <a href="#valid-url">valid URL</a> but it is not the empty string.<div class="impl">
 
   <p>To <dfn id="parse-a-url">parse a URL</dfn> <var title="">url</var> into its
-  component parts, the user agent must use the <span>parse a Web
-  address</span> algorithm defined by the Web addresses
-  specification. <a href="#refsWEBADDRESSES">[WEBADDRESSES]</a></p>
+  component parts, the user agent must use the <span class="XXX">parse
+  an address</span> algorithm defined by the IRI specification. <a href="#refsRFC3987">[RFC3987]</a></p>
 
-  <p>Parsing a URL results in the following components, again as
-  defined by the Web addresses specification:</p>
+  <p>Parsing a URL can fail. If it does not, then results in the
+  following components, again as defined by the IRI specification:</p>
 
   <ul class="brief"><li><dfn id="url-scheme" title="url-scheme">&lt;scheme&gt;</dfn></li>
    <li><dfn id="url-host" title="url-host">&lt;host&gt;</dfn></li>
@@ -4872,65 +4873,125 @@
    <li><dfn id="url-query" title="url-query">&lt;query&gt;</dfn></li>
    <li><dfn id="url-fragment" title="url-fragment">&lt;fragment&gt;</dfn></li>
    <li><dfn id="url-host-specific" title="url-host-specific">&lt;host-specific&gt;</dfn></li>
-  </ul><p>To <dfn id="resolve-a-url">resolve a URL</dfn> to an <a href="#absolute-url">absolute URL</a>
+  </ul><hr><p>To <dfn id="resolve-a-url">resolve a URL</dfn> to an <a href="#absolute-url">absolute URL</a>
   relative to either another <a href="#absolute-url">absolute URL</a> or an element,
-  the user agent must use the <span>resolve a Web address</span>
-  algorithm defined by the Web addresses specification. <a href="#refsWEBADDRESSES">[WEBADDRESSES]</a></p>
+  the user agent must use the following steps. Resolving a URL can
+  result in an error, in which case the URL is not resolvable.</p>
 
-  <p>The <dfn id="document-base-url">document base URL</dfn> of a <code><a href="#document">Document</a></code>
-  object is the <a href="#absolute-url">absolute URL</a> obtained by running these
-  substeps:</p>
+  <ol><li><p>Let <var title="">url</var> be the <a href="#url">URL</a> being
+   resolved.</li>
 
-  <ol><li><p>Let <var title="">fallback base url</var> be <a href="#the-document-s-address">the
-   document's address</a>.</li>
+   <li>
+
+    <p>Let <var title="">encoding</var> be determined as follows:</p>
+
+    <dl class="switch"><dt>If the URL had a character encoding defined when the URL was
+     created or defined</dt>
+
+     <dd>The URL character encoding is as defined.</dd>
+
+     <dt>If the URL came from a script (e.g. as an argument to a
+     method)</dt>
+
+     <dd>The URL character encoding is the <a href="#script-s-url-character-encoding">script's URL character
+     encoding</a>.</dd>
+
+     <dt>If the URL came from a DOM node (e.g. from an element)</dt>
+
+     <dd>The node has a <code><a href="#document">Document</a></code>, and the URL character
+     encoding is the <a href="#document-s-character-encoding">document's character encoding</a>.</dd>
+
+    </dl></li>
+
+   <li><p>If <var title="">encoding</var> is a UTF-16 encoding, then
+   change the value of <var title="">encoding</var> to UTF-8.</li>
 
    <li>
 
-    <!-- http://www.hixie.ch/tests/adhoc/html/navigation/javascript-url/ -->
+    <p>If the algorithm was invoked with an <a href="#absolute-url">absolute URL</a>
+    to use as the base URL, let <var title="">base</var> be that
+    <a href="#absolute-url">absolute URL</a>.</p>
 
-    <!-- this should be tested in the case of a browsing context that
-    was navigated to about:blank after having been elsewhere, as
-    opposed to the about:blank used at the time of the browsing
-    context's creation. -->
+    <p>Otherwise, let <var title="">base</var> be the <i>base URI of
+    the element</i>, as defined by the XML Base specification, with
+    <i>the base URI of the document entity</i> being defined as the
+    <a href="#document-base-url">document base URL</a> of the <code><a href="#document">Document</a></code> that
+    owns the element. <a href="#refsXMLBASE">[XMLBASE]</a></p>
 
-    <p>If <var title="">fallback base url</var> is
-    <code><a href="#about:blank">about:blank</a></code>, and the <code><a href="#document">Document</a></code>'s
-    <a href="#browsing-context">browsing context</a> has a <a href="#creator-browsing-context">creator browsing
-    context</a>, then let <var title="">fallback base url</var>
-    be the <a href="#document-base-url">document base URL</a> of the <a href="#creator-document">creator
-    <code>Document</code></a> instead.</p>
+    <p>For the purposes of the XML Base specification, user agents
+    must act as if all <code><a href="#document">Document</a></code> objects represented XML
+    documents.</p>
 
-   </li>
+    <p class="note">It is possible for <code title="attr-xml-base"><a href="#the-xml:base-attribute-xml-only">xml:base</a></code> attributes to be present
+    even in HTML fragments, as such attributes can be added
+    dynamically using script. (Such scripts would not be conforming,
+    however, as <code title="attr-xml-base"><a href="#the-xml:base-attribute-xml-only">xml:base</a></code> attributes
+    are not allowed in <a href="#html-documents">HTML documents</a>.)</p>
 
-   <li><p>If there is no <code><a href="#the-base-element">base</a></code> element that is both a
-   child of <a href="#the-head-element">the <code>head</code> element</a> and has an
-   <code title="attr-base-href"><a href="#attr-base-href">href</a></code> attribute, then the
-   <a href="#document-base-url">document base URL</a> is <var title="">fallback base
-   url</var>.</li>
+    <p>The <dfn id="document-base-url">document base URL</dfn> of a <code><a href="#document">Document</a></code>
+    object is the <a href="#absolute-url">absolute URL</a> obtained by running these
+    substeps:</p>
 
-   <li><p>Otherwise, let <var title="">url</var> be the value of the
-   <code title="attr-base-href"><a href="#attr-base-href">href</a></code> attribute of the first
-   such element.</li>
+    <ol><li><p>Let <var title="">fallback base url</var> be <a href="#the-document-s-address">the
+     document's address</a>.</li>
 
-   <li><p><a href="#resolve-a-url" title="resolve a URL">Resolve</a> <var title="">url</var> relative to <var title="">fallback base
-   url</var> (thus, the <code><a href="#the-base-element">base</a></code> <code title="attr-base-href"><a href="#attr-base-href">href</a></code> attribute isn't affected by
-   <code title="attr-xml-base"><a href="#the-xml:base-attribute-xml-only">xml:base</a></code> attributes).</li>
+     <li>
 
-   <li><p>The <a href="#document-base-url">document base URL</a> is the result of the
-   previous step if it was successful; otherwise it is <var title="">fallback base url</var>.</li>
+      <!-- http://www.hixie.ch/tests/adhoc/html/navigation/javascript-url/ -->
 
-  </ol><p>This specification defines the URL
+      <!-- this should be tested in the case of a browsing context that
+      was navigated to about:blank after having been elsewhere, as
+      opposed to the about:blank used at the time of the browsing
+      context's creation. -->
+
+      <p>If <var title="">fallback base url</var> is
+      <code><a href="#about:blank">about:blank</a></code>, and the <code><a href="#document">Document</a></code>'s
+      <a href="#browsing-context">browsing context</a> has a <a href="#creator-browsing-context">creator browsing
+      context</a>, then let <var title="">fallback base url</var>
+      be the <a href="#document-base-url">document base URL</a> of the <a href="#creator-document">creator
+      <code>Document</code></a> instead.</p>
+
+     </li>
+
+     <li><p>If there is no <code><a href="#the-base-element">base</a></code> element that is both a
+     child of <a href="#the-head-element">the <code>head</code> element</a> and has an
+     <code title="attr-base-href"><a href="#attr-base-href">href</a></code> attribute, then the
+     <a href="#document-base-url">document base URL</a> is <var title="">fallback base
+     url</var>.</li>
+
+     <li><p>Otherwise, let <var title="">url</var> be the value of the
+     <code title="attr-base-href"><a href="#attr-base-href">href</a></code> attribute of the first
+     such element.</li>
+
+     <li><p><a href="#resolve-a-url" title="resolve a URL">Resolve</a> <var title="">url</var> relative to <var title="">fallback base
+     url</var> (thus, the <code><a href="#the-base-element">base</a></code> <code title="attr-base-href"><a href="#attr-base-href">href</a></code> attribute isn't affected by
+     <code title="attr-xml-base"><a href="#the-xml:base-attribute-xml-only">xml:base</a></code> attributes).</li>
+
+     <li><p>The <a href="#document-base-url">document base URL</a> is the result of the
+     previous step if it was successful; otherwise it is <var title="">fallback base url</var>.</li>
+
+    </ol></li>
+
+   <li><p>Return the result of applying the <span class="XXX">resolve
+   an address</span> algorithm defined by the IRI specification to
+   resolve <var title="">url</var> relative to <var title="">base</var> using encoding <var title="">encoding</var>. <a href="#refsRFC3987">[RFC3987]</a></li>
+
+  </ol></div><p>A <a href="#url">URL</a> is an <dfn id="absolute-url">absolute URL</dfn> if <a href="#resolve-a-url" title="resolve a url">resolving</a> it results in the same output
+  regardless of what it is resolved relative to, and that output is
+  not a failure.<p>An <a href="#absolute-url">absolute URL</a> is a <dfn id="hierarchical-url">hierarchical URL</dfn> if,
+  when <a href="#resolve-a-url" title="resolve a url">resolved</a> and then <a href="#parse-a-url" title="parse a url">parsed</a>, there is a character immediately
+  after the <a href="#url-scheme" title="url-scheme">&lt;scheme&gt;</a> component
+  and it is a U+002F SOLIDUS character (/).<p>An <a href="#absolute-url">absolute URL</a> is an <dfn id="authority-based-url">authority-based URL</dfn>
+  if, when <a href="#resolve-a-url" title="resolve a url">resolved</a> and then <a href="#parse-a-url" title="parse a url">parsed</a>, there are two characters
+  immediately after the <a href="#url-scheme" title="url-scheme">&lt;scheme&gt;</a>
+  component and they are both U+002F SOLIDUS characters (//).<hr><p>This specification defines the URL
   <dfn id="about:legacy-compat"><code>about:legacy-compat</code></dfn> as a reserved, though
   unresolvable, <code title="">about:</code> URI, for use in <a href="#syntax-doctype" title="syntax-doctype">DOCTYPE</a>s in <a href="#html-documents">HTML
-  documents</a> when needed for compatibility with XML tools. <a href="#refsABOUT">[ABOUT]</a></p>
-
-  <p>This specification defines the URL
+  documents</a> when needed for compatibility with XML tools. <a href="#refsABOUT">[ABOUT]</a><p>This specification defines the URL
   <dfn id="about:srcdoc"><code>about:srcdoc</code></dfn> as a reserved, though
   unresolvable, <code title="">about:</code> URI, that is used as
   <a href="#the-document-s-address">the document's address</a> of <a href="#an-iframe-srcdoc-document" title="an iframe srcdoc
-  document"><code>iframe</code> <code title="attr-iframe-srcdoc">srcdoc</code> documents</a>. <a href="#refsABOUT">[ABOUT]</a></p>
-
-  </div><p class="note">The term "URL" in this specification is used in a
+  document"><code>iframe</code> <code title="attr-iframe-srcdoc">srcdoc</code> documents</a>. <a href="#refsABOUT">[ABOUT]</a><p class="note">The term "URL" in this specification is used in a
   manner distinct from the precise technical meaning it is given in
   RFC 3986. Readers familiar with that RFC will find it easier to read
   <em>this</em> specification if they pretend the term "URL" as used
@@ -67491,11 +67552,6 @@
    Guidelines (WCAG) 2.0</a></cite>, B. Caldwell, M. Cooper, L. Reid,
    G. Vanderheiden. W3C.</dd>
 
-   <dt id="refsWEBADDRESSES">[WEBADDRESSES]</dt>
-   <dd><cite><a href="http://www.w3.org/html/wg/href/draft">Web
-   addresses in HTML5</a></cite>, D. Connolly,
-   C. Sperberg-McQueen.</dd>
-
    <dt id="refsWEBIDL">[WEBIDL]</dt>
    <!--
    <dd><cite><a href="http://www.w3.org/TR/WebIDL/">Web

Received on Tuesday, 6 April 2010 00:09:02 UTC