W3C home > Mailing lists > Public > public-html-diffs@w3.org > July 2011

hixie: Move some of the quirky API requirements to DOM Core. (whatwg r6333)

From: poot <cvsmail@w3.org>
Date: Wed, 27 Jul 2011 19:11:00 -0400
To: public-html-diffs@w3.org
Message-Id: <E1QmDFj-0006Va-OO@jay.w3.org>
hixie: Move some of the quirky API requirements to DOM Core. (whatwg
r6333)

http://dev.w3.org/cvsweb/html5/spec/Overview.html?r1=1.5060&r2=1.5061&f=h
http://html5.org/tools/web-apps-tracker?from=6332&to=6333

===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.5060
retrieving revision 1.5061
diff -u -d -r1.5060 -r1.5061
--- Overview.html	27 Jul 2011 23:07:36 -0000	1.5060
+++ Overview.html	27 Jul 2011 23:10:43 -0000	1.5061
@@ -615,17 +615,16 @@
      <li><a href="#requirements-relating-to-bidirectional-algorithm-formatting-characters"><span class="secno">3.2.6 </span>Requirements relating to bidirectional-algorithm formatting
   characters</a></li>
      <li><a href="#wai-aria"><span class="secno">3.2.7 </span>WAI-ARIA</a></ol></li>
-   <li><a href="#apis-in-html-documents"><span class="secno">3.3 </span>APIs in HTML documents</a></li>
-   <li><a href="#interactions-with-xpath-and-xslt"><span class="secno">3.4 </span>Interactions with XPath and XSLT</a></li>
-   <li><a href="#dynamic-markup-insertion"><span class="secno">3.5 </span>Dynamic markup insertion</a>
+   <li><a href="#interactions-with-xpath-and-xslt"><span class="secno">3.3 </span>Interactions with XPath and XSLT</a></li>
+   <li><a href="#dynamic-markup-insertion"><span class="secno">3.4 </span>Dynamic markup insertion</a>
     <ol>
-     <li><a href="#opening-the-input-stream"><span class="secno">3.5.1 </span>Opening the input stream</a></li>
-     <li><a href="#closing-the-input-stream"><span class="secno">3.5.2 </span>Closing the input stream</a></li>
-     <li><a href="#document.write"><span class="secno">3.5.3 </span><code title="dom-document-write">document.write()</code></a></li>
-     <li><a href="#document.writeln"><span class="secno">3.5.4 </span><code title="dom-document-writeln">document.writeln()</code></a></li>
-     <li><a href="#innerhtml"><span class="secno">3.5.5 </span><code title="dom-innerHTML">innerHTML</code></a></li>
-     <li><a href="#outerhtml"><span class="secno">3.5.6 </span><code title="dom-outerHTML">outerHTML</code></a></li>
-     <li><a href="#insertadjacenthtml"><span class="secno">3.5.7 </span><code title="dom-insertAdjacentHTML">insertAdjacentHTML()</code></a></ol></ol></li>
+     <li><a href="#opening-the-input-stream"><span class="secno">3.4.1 </span>Opening the input stream</a></li>
+     <li><a href="#closing-the-input-stream"><span class="secno">3.4.2 </span>Closing the input stream</a></li>
+     <li><a href="#document.write"><span class="secno">3.4.3 </span><code title="dom-document-write">document.write()</code></a></li>
+     <li><a href="#document.writeln"><span class="secno">3.4.4 </span><code title="dom-document-writeln">document.writeln()</code></a></li>
+     <li><a href="#innerhtml"><span class="secno">3.4.5 </span><code title="dom-innerHTML">innerHTML</code></a></li>
+     <li><a href="#outerhtml"><span class="secno">3.4.6 </span><code title="dom-outerHTML">outerHTML</code></a></li>
+     <li><a href="#insertadjacenthtml"><span class="secno">3.4.7 </span><code title="dom-insertAdjacentHTML">insertAdjacentHTML()</code></a></ol></ol></li>
  <li><a href="#semantics"><span class="secno">4 </span>The elements of HTML</a>
   <ol>
    <li><a href="#the-root-element"><span class="secno">4.1 </span>The root element</a>
@@ -9979,117 +9978,9 @@
 
    
 
-  </div><h3 id="apis-in-html-documents"><span class="secno">3.3 </span>APIs in HTML documents</h3><p>For <a href="#html-documents">HTML documents</a>, and for <a href="#html-elements">HTML
-  elements</a> in <a href="#html-documents">HTML documents</a>, certain APIs defined
-  in DOM Core become case-insensitive or case-changing, as sometimes
-  defined in DOM Core, and as summarized <span class="impl">or
-  required</span> below. <a href="#refsDOMCORE">[DOMCORE]</a><p>This does not apply to <a href="#xml-documents">XML documents</a> or to elements
-  that are not in the <a href="#html-namespace-0">HTML namespace</a> despite being in
-  <a href="#html-documents">HTML documents</a>.<dl><dt><code title="dom-Element-tagName"><a href="#dom-element-tagname">Element.tagName</a></code> and <code title="dom-Node-nodeName">Node.nodeName</code></dt>
-
-   <dd>
-
-    <p>These attributes <span class="impl">must</span> return element
-    names <a href="#converted-to-ascii-uppercase">converted to ASCII uppercase</a>, regardless of the case
-    with which they were created.</p>
-
-   </dd>
-
-
-   <dt><code title="dom-Document-createElement"><a href="#dom-document-createelement">Document.createElement()</a></code></dt>
-
-   <dd>
-
-    <p>The canonical form of HTML markup is all-lowercase; thus, this
-    method will <a href="#converted-to-ascii-lowercase" title="converted to ASCII lowercase">lowercase</a>
-    the argument before creating the requisite element. <span class="impl">Also, the element created must be in the <a href="#html-namespace-0">HTML
-    namespace</a></span>.</p>
-
-    <p class="note">This doesn't apply to <code title="dom-Document-createElementNS"><a href="#dom-document-createelementns">Document.createElementNS()</a></code>.
-    Thus, it is possible, by passing this last method a tag name in
-    the wrong case, to create an element that appears to have the same
-    tag name as that of an element defined in this specification when
-    its <code title="dom-Element-tagName"><a href="#dom-element-tagname">tagName</a></code> attribute is
-    examined, but that doesn't support the corresponding interfaces.
-    The "real" element name (unaffected by case conversions) can be
-    obtained from the <code title="dom-Node-localName"><a href="#dom-node-localname">localName</a></code> attribute.</p>
-
-   </dd>
-
-
-   <dt><code title="dom-Element-setAttribute">Element.setAttribute()</code></dt>
-   <dt><code title="dom-Element-setAttributeNode">Element.setAttributeNode()</code></dt>
-
-   <dd>
-
-    <p>Attribute names are <a href="#converted-to-ascii-lowercase">converted to ASCII lowercase</a>.</p>
-
-    <div class="impl">
-
-     <p>Specifically: when an attribute is set on an <a href="#html-elements" title="HTML
-     elements">HTML element</a> using <code title="">Element.setAttribute()</code>, the name argument must be
-     <a href="#converted-to-ascii-lowercase">converted to ASCII lowercase</a> before the element is
-     affected; and when an <code><a href="#attr">Attr</a></code> node is set on an <a href="#html-elements" title="HTML elements">HTML element</a> using <code title="">Element.setAttributeNode()</code>, it must have its name
-     <a href="#converted-to-ascii-lowercase">converted to ASCII lowercase</a> before the element is
-     affected.</p>
-
-    </div>
-
-    <p class="note">This doesn't apply to <code title="">Element.setAttributeNS()</code> and <code title="">Element.setAttributeNodeNS()</code>.</p>
-
-   </dd>
-
-
-   <dt><code title="dom-Element-getAttribute">Element.getAttribute()</code></dt>
-   <dt><code title="dom-Element-getAttributeNode">Element.getAttributeNode()</code></dt>
-
-   <dd>
-
-    <p>Attribute names are <a href="#converted-to-ascii-lowercase">converted to ASCII lowercase</a>.</p>
-
-    <div class="impl">
-
-     <p>Specifically: When the <code title="">Element.getAttribute()</code> method or the <code title="">Element.getAttributeNode()</code> method is invoked on
-     an <a href="#html-elements" title="HTML elements">HTML element</a>, the name
-     argument must be <a href="#converted-to-ascii-lowercase">converted to ASCII lowercase</a> before the
-     element's attributes are examined.</p>
-
-    </div>
-
-    <p class="note">This doesn't apply to <code title="">Element.getAttributeNS()</code> and <code title="">Element.getAttributeNodeNS()</code>.</p>
-
-   </dd>
-
-
-   <dt><code title="dom-Document-getElementsByTagName">Document.getElementsByTagName()</code></dt>
-   <dt><code title="dom-Element-getElementsByTagName">Element.getElementsByTagName()</code></dt>
-
-   <dd>
-
-    <p>HTML elements match by lower-casing the argument before
-    comparison, elements from other namespaces are treated as in XML
-    (case-sensitively).</p>
-
-    <div class="impl">
-
-    <p>Specifically, these methods (but not their namespaced
-    counterparts) must compare the given argument in a
-    <a href="#case-sensitive">case-sensitive</a> manner, but when looking at <a href="#html-elements" title="HTML elements">HTML elements</a>, the argument must
-    first be <a href="#converted-to-ascii-lowercase">converted to ASCII lowercase</a>.</p>
-
-    </div>
-
-    <p class="note">Thus, in an <a href="#html-documents" title="HTML documents">HTML
-    document</a> with nodes in multiple namespaces, these methods
-    will effectively be both case-sensitive and case-insensitive at
-    the same time.</p>
-
-   </dd>
-
-
-  </dl><div class="impl">
+  </div><div class="impl">
 
-  <h3 id="interactions-with-xpath-and-xslt"><span class="secno">3.4 </span>Interactions with XPath and XSLT</h3>
+  <h3 id="interactions-with-xpath-and-xslt"><span class="secno">3.3 </span>Interactions with XPath and XSLT</h3>
 
   <p id="xpath-1.0-processors">Implementations of XPath 1.0 that
   operate on <a href="#html-documents">HTML documents</a> parsed or created in the
@@ -10176,11 +10067,11 @@
   interaction of XSLT and HTML <a href="#scriptTagXSLT">in the
   <code>script</code> element section</a>.</p>
 
-  </div><h3 id="dynamic-markup-insertion"><span class="secno">3.5 </span><dfn>Dynamic markup insertion</dfn></h3><p class="note">APIs for dynamically inserting markup into the
+  </div><h3 id="dynamic-markup-insertion"><span class="secno">3.4 </span><dfn>Dynamic markup insertion</dfn></h3><p class="note">APIs for dynamically inserting markup into the
   document interact with the parser, and thus their behavior varies
   depending on whether they are used with <a href="#html-documents">HTML documents</a>
   (and the <a href="#html-parser">HTML parser</a>) or XHTML in <a href="#xml-documents">XML
-  documents</a> (and the <a href="#xml-parser">XML parser</a>).<h4 id="opening-the-input-stream"><span class="secno">3.5.1 </span>Opening the input stream</h4><p>The <dfn id="dom-document-open" title="dom-document-open"><code>open()</code></dfn>
+  documents</a> (and the <a href="#xml-parser">XML parser</a>).<h4 id="opening-the-input-stream"><span class="secno">3.4.1 </span>Opening the input stream</h4><p>The <dfn id="dom-document-open" title="dom-document-open"><code>open()</code></dfn>
   method comes in several variants with different numbers of
   arguments.<dl class="domintro"><dt><var title="">document</var> = <var title="">document</var> . <code title="dom-document-open"><a href="#dom-document-open">open</a></code>( [ <var title="">type</var> [, <var title="">replace</var> ] ] )</dt>
 
@@ -10379,7 +10270,7 @@
   <code><a href="#window">Window</a></code> object, then the method must raise an
   <code><a href="#invalid_access_err">INVALID_ACCESS_ERR</a></code> exception.</p>
 
-  </div><h4 id="closing-the-input-stream"><span class="secno">3.5.2 </span>Closing the input stream</h4><dl class="domintro"><dt><var title="">document</var> . <code title="dom-document-close"><a href="#dom-document-close">close</a></code>()</dt>
+  </div><h4 id="closing-the-input-stream"><span class="secno">3.4.2 </span>Closing the input stream</h4><dl class="domintro"><dt><var title="">document</var> . <code title="dom-document-close"><a href="#dom-document-close">close</a></code>()</dt>
 
    <dd>
 
@@ -10415,7 +10306,7 @@
    "EOF" character</a> or <a href="#spin-the-event-loop" title="spin the event loop">spins
    the event loop</a>.</li>
 
-  </ol></div><h4 id="document.write"><span class="secno">3.5.3 </span><code title="dom-document-write"><a href="#dom-document-write">document.write()</a></code></h4><dl class="domintro"><dt><var title="">document</var> . <code title="dom-document-write"><a href="#dom-document-write">write</a></code>(<var title="">text</var>...)</dt>
+  </ol></div><h4 id="document.write"><span class="secno">3.4.3 </span><code title="dom-document-write"><a href="#dom-document-write">document.write()</a></code></h4><dl class="domintro"><dt><var title="">document</var> . <code title="dom-document-write"><a href="#dom-document-write">write</a></code>(<var title="">text</var>...)</dt>
 
    <dd>
 
@@ -10520,7 +10411,7 @@
 
    </li>
 
-  </ol></div><h4 id="document.writeln"><span class="secno">3.5.4 </span><code title="dom-document-writeln"><a href="#dom-document-writeln">document.writeln()</a></code></h4><dl class="domintro"><dt><var title="">document</var> . <code title="dom-document-writeln"><a href="#dom-document-writeln">writeln</a></code>(<var title="">text</var>...)</dt>
+  </ol></div><h4 id="document.writeln"><span class="secno">3.4.4 </span><code title="dom-document-writeln"><a href="#dom-document-writeln">document.writeln()</a></code></h4><dl class="domintro"><dt><var title="">document</var> . <code title="dom-document-writeln"><a href="#dom-document-writeln">writeln</a></code>(<var title="">text</var>...)</dt>
 
    <dd>
 
@@ -10541,7 +10432,7 @@
   invoked with the same argument(s), plus an extra argument consisting
   of a string containing a single line feed character (U+000A).</p>
 
-  </div><h4 id="innerhtml"><span class="secno">3.5.5 </span><code title="dom-innerHTML"><a href="#dom-innerhtml">innerHTML</a></code></h4><p>The <dfn id="dom-innerhtml" title="dom-innerHTML"><code>innerHTML</code></dfn> IDL
+  </div><h4 id="innerhtml"><span class="secno">3.4.5 </span><code title="dom-innerHTML"><a href="#dom-innerhtml">innerHTML</a></code></h4><p>The <dfn id="dom-innerhtml" title="dom-innerHTML"><code>innerHTML</code></dfn> IDL
   attribute represents the markup of the node's contents.<dl class="domintro"><dt><var title="">document</var> . <code title="dom-innerHTML"><a href="#dom-innerhtml">innerHTML</a></code> [ = <var title="">value</var> ]</dt>
 
    <dd>
@@ -10652,7 +10543,7 @@
 
    </li>
 
-  </ol></div><h4 id="outerhtml"><span class="secno">3.5.6 </span><code title="dom-outerHTML"><a href="#dom-outerhtml">outerHTML</a></code></h4><p>The <dfn id="dom-outerhtml" title="dom-outerHTML"><code>outerHTML</code></dfn> IDL
+  </ol></div><h4 id="outerhtml"><span class="secno">3.4.6 </span><code title="dom-outerHTML"><a href="#dom-outerhtml">outerHTML</a></code></h4><p>The <dfn id="dom-outerhtml" title="dom-outerHTML"><code>outerHTML</code></dfn> IDL
   attribute represents the markup of the element and its contents.<dl class="domintro"><dt><var title="">element</var> . <code title="dom-outerHTML"><a href="#dom-outerhtml">outerHTML</a></code> [ = <var title="">value</var> ]</dt>
 
    <dd>
@@ -10758,7 +10649,7 @@
 
    </li>
 
-  </ol></div><h4 id="insertadjacenthtml"><span class="secno">3.5.7 </span><code title="dom-insertAdjacentHTML"><a href="#dom-insertadjacenthtml">insertAdjacentHTML()</a></code></h4><dl class="domintro"><dt><var title="">element</var> . <code title="dom-insertAdjacentHTML"><a href="#dom-insertadjacenthtml">insertAdjacentHTML</a></code>(<var title="">position</var>, <var title="">text</var>)</dt>
+  </ol></div><h4 id="insertadjacenthtml"><span class="secno">3.4.7 </span><code title="dom-insertAdjacentHTML"><a href="#dom-insertadjacenthtml">insertAdjacentHTML()</a></code></h4><dl class="domintro"><dt><var title="">element</var> . <code title="dom-insertAdjacentHTML"><a href="#dom-insertadjacenthtml">insertAdjacentHTML</a></code>(<var title="">position</var>, <var title="">text</var>)</dt>
 
    <dd>
Received on Wednesday, 27 July 2011 23:11:01 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Wednesday, 27 July 2011 23:11:03 GMT