[html5] r5863 - [giow] (2) Clarify that the cloning that occurs for importNode() is the same as [...]

whatwg at whatwg.org whatwg at whatwg.org
Tue Feb 8 16:43:17 PST 2011


Author: ianh
Date: 2011-02-08 16:43:15 -0800 (Tue, 08 Feb 2011)
New Revision: 5863

Modified:
   complete.html
   index
   source
Log:
[giow] (2) Clarify that the cloning that occurs for importNode() is the same as occurs for cloneNode().
Fixing http://www.w3.org/Bugs/Public/show_bug.cgi?id=11091

Modified: complete.html
===================================================================
--- complete.html	2011-02-09 00:29:12 UTC (rev 5862)
+++ complete.html	2011-02-09 00:43:15 UTC (rev 5863)
@@ -2808,7 +2808,14 @@
   value, text node, or string, means that the length of the text is
   zero (i.e. not even containing spaces or control characters).</p>
 
+  <p>Nodes can be <dfn id=concept-clone title=concept-clone>cloned</dfn>, as
+  described in the DOM Core specification. For example, the <code title=dom-cloneNode>cloneNode()</code> and <code title=dom-importNode>importNode()</code> methods of the
+  <code><a href=#node>Node</a></code> interface both clone nodes, as do a number of
+  algorithms in this specification. Certain <a href=#html-elements>HTML elements</a>
+  (in particular, <code><a href=#the-input-element>input</a></code> and <code><a href=#script>script</a></code>) apply
+  additional requirements on how they are cloned. <a href=#refsDOMCORE>[DOMCORE]</a></p>
 
+
   <h4 id=scripting-0><span class=secno>2.1.4 </span>Scripting</h4>
 
   <p>The construction "a <code>Foo</code> object", where
@@ -14878,8 +14885,8 @@
   has been <dfn id=already-started>"already started"</dfn>. Initially,
   <code><a href=#script>script</a></code> elements must have this flag unset (script
   blocks, when created, are not "already started"). When a
-  <code><a href=#script>script</a></code> element is cloned, the "already started" flag,
-  if set, must be propagated to the clone when it is created.</p>
+  <code><a href=#script>script</a></code> element is <a href=#concept-clone title=concept-clone>cloned</a>, the "already started" flag, if
+  set, must be propagated to the clone when it is created.</p>
 
   <p>The second is a flag indicating whether the element was
   <dfn id=parser-inserted>"parser-inserted"</dfn>. Initially, <code><a href=#script>script</a></code>
@@ -40614,7 +40621,7 @@
   some cases (e.g. for the <a href=#date-state title=attr-input-type-date>Date</a> state, but not the <a href=#checkbox-state title=attr-input-type-checkbox>Checkbox</a> state) make an
   <code><a href=#the-input-element>input</a></code> element <i title=concept-input-immutable><a href=#concept-input-immutable>immutable</a></i>.</p>
 
-  <p>When an <code><a href=#the-input-element>input</a></code> element is cloned, the element's <a href=#concept-fe-value title=concept-fe-value>value</a>, <a href=#concept-input-value-dirty-flag title=concept-input-value-dirty-flag>dirty value flag</a>,
+  <p>When an <code><a href=#the-input-element>input</a></code> element is <a href=#concept-clone title=concept-clone>cloned</a>, the element's <a href=#concept-fe-value title=concept-fe-value>value</a>, <a href=#concept-input-value-dirty-flag title=concept-input-value-dirty-flag>dirty value flag</a>,
   <a href=#concept-fe-checked title=concept-fe-checked>checkedness</a>, and <a href=#concept-input-checked-dirty-flag title=concept-input-checked-dirty-flag>dirty checkedness
   flag</a> must be propagated to the clone when it is created.</p>
 
@@ -57343,10 +57350,11 @@
 
    <li>
 
-    <p>Clone the nodes in <var title="">heading content</var> and
-    their descendants into an environment that has <a href=#concept-bc-noscript title=concept-bc-noscript>scripting disabled</a>, has no
-    <a href=#plugin title=plugin>plugins</a>, and fails any attempt to
-    <a href=#fetch title=fetch>fetch</a> any resources. Let <var title="">cloned heading content</var> be a new
+    <p><a href=#concept-clone title=concept-clone>Clone</a> the nodes in <var title="">heading content</var> and their descendants into an
+    environment that has <a href=#concept-bc-noscript title=concept-bc-noscript>scripting
+    disabled</a>, has no <a href=#plugin title=plugin>plugins</a>, and
+    fails any attempt to <a href=#fetch title=fetch>fetch</a> any
+    resources. Let <var title="">cloned heading content</var> be a new
     <code><a href=#documentfragment>DocumentFragment</a></code> containing the resulting cloned
     nodes, preserving their relative order.</p>
 
@@ -57381,12 +57389,13 @@
 
     <ol><li>
 
-      <p>Clone the nodes in <var title="">subheading content</var>
-      and their descendants into an environment that has <a href=#concept-bc-noscript title=concept-bc-noscript>scripting disabled</a>, has no
-      <a href=#plugin title=plugin>plugins</a>, and fails any attempt to
-      <a href=#fetch title=fetch>fetch</a> any resources. Let <var title="">cloned subheading content</var> be a new
-      <code><a href=#documentfragment>DocumentFragment</a></code> containing the resulting cloned
-      nodes, preserving their relative order.</p>
+      <p><a href=#concept-clone title=concept-clone>Clone</a> the nodes in <var title="">subheading content</var> and their descendants into an
+      environment that has <a href=#concept-bc-noscript title=concept-bc-noscript>scripting
+      disabled</a>, has no <a href=#plugin title=plugin>plugins</a>, and
+      fails any attempt to <a href=#fetch title=fetch>fetch</a> any
+      resources. Let <var title="">cloned subheading content</var> be
+      a new <code><a href=#documentfragment>DocumentFragment</a></code> containing the resulting
+      cloned nodes, preserving their relative order.</p>
 
      </li>
 
@@ -57493,12 +57502,13 @@
 
      <li>
 
-      <p>Clone the nodes in <var title="">heading content</var> and
-      their descendants into an environment that has <a href=#concept-bc-noscript title=concept-bc-noscript>scripting disabled</a>, has no
-      <a href=#plugin title=plugin>plugins</a>, and fails any attempt to
-      <a href=#fetch title=fetch>fetch</a> any resources. Let <var title="">cloned heading content</var> be a new
-      <code><a href=#documentfragment>DocumentFragment</a></code> containing the resulting cloned
-      nodes, preserving their relative order.</p>
+      <p><a href=#concept-clone title=concept-clone>Clone</a> the nodes in <var title="">heading content</var> and their descendants into an
+      environment that has <a href=#concept-bc-noscript title=concept-bc-noscript>scripting
+      disabled</a>, has no <a href=#plugin title=plugin>plugins</a>, and
+      fails any attempt to <a href=#fetch title=fetch>fetch</a> any
+      resources. Let <var title="">cloned heading content</var> be a
+      new <code><a href=#documentfragment>DocumentFragment</a></code> containing the resulting
+      cloned nodes, preserving their relative order.</p>
 
      </li>
 
@@ -57528,8 +57538,8 @@
 
      <li>
 
-      <p>Clone <var title="">article</var> and its descendants into an
-      environment that has <a href=#concept-bc-noscript title=concept-bc-noscript>scripting
+      <p><a href=#concept-clone title=concept-clone>Clone</a> <var title="">article</var> and its descendants into an environment
+      that has <a href=#concept-bc-noscript title=concept-bc-noscript>scripting
       disabled</a>, has no <a href=#plugin title=plugin>plugins</a>, and
       fails any attempt to <a href=#fetch title=fetch>fetch</a> any
       resources. Let <var title="">cloned article</var> be the

Modified: index
===================================================================
--- index	2011-02-09 00:29:12 UTC (rev 5862)
+++ index	2011-02-09 00:43:15 UTC (rev 5863)
@@ -2788,7 +2788,14 @@
   value, text node, or string, means that the length of the text is
   zero (i.e. not even containing spaces or control characters).</p>
 
+  <p>Nodes can be <dfn id=concept-clone title=concept-clone>cloned</dfn>, as
+  described in the DOM Core specification. For example, the <code title=dom-cloneNode>cloneNode()</code> and <code title=dom-importNode>importNode()</code> methods of the
+  <code><a href=#node>Node</a></code> interface both clone nodes, as do a number of
+  algorithms in this specification. Certain <a href=#html-elements>HTML elements</a>
+  (in particular, <code><a href=#the-input-element>input</a></code> and <code><a href=#script>script</a></code>) apply
+  additional requirements on how they are cloned. <a href=#refsDOMCORE>[DOMCORE]</a></p>
 
+
   <h4 id=scripting-0><span class=secno>2.1.4 </span>Scripting</h4>
 
   <p>The construction "a <code>Foo</code> object", where
@@ -14858,8 +14865,8 @@
   has been <dfn id=already-started>"already started"</dfn>. Initially,
   <code><a href=#script>script</a></code> elements must have this flag unset (script
   blocks, when created, are not "already started"). When a
-  <code><a href=#script>script</a></code> element is cloned, the "already started" flag,
-  if set, must be propagated to the clone when it is created.</p>
+  <code><a href=#script>script</a></code> element is <a href=#concept-clone title=concept-clone>cloned</a>, the "already started" flag, if
+  set, must be propagated to the clone when it is created.</p>
 
   <p>The second is a flag indicating whether the element was
   <dfn id=parser-inserted>"parser-inserted"</dfn>. Initially, <code><a href=#script>script</a></code>
@@ -40597,7 +40604,7 @@
   some cases (e.g. for the <a href=#date-state title=attr-input-type-date>Date</a> state, but not the <a href=#checkbox-state title=attr-input-type-checkbox>Checkbox</a> state) make an
   <code><a href=#the-input-element>input</a></code> element <i title=concept-input-immutable><a href=#concept-input-immutable>immutable</a></i>.</p>
 
-  <p>When an <code><a href=#the-input-element>input</a></code> element is cloned, the element's <a href=#concept-fe-value title=concept-fe-value>value</a>, <a href=#concept-input-value-dirty-flag title=concept-input-value-dirty-flag>dirty value flag</a>,
+  <p>When an <code><a href=#the-input-element>input</a></code> element is <a href=#concept-clone title=concept-clone>cloned</a>, the element's <a href=#concept-fe-value title=concept-fe-value>value</a>, <a href=#concept-input-value-dirty-flag title=concept-input-value-dirty-flag>dirty value flag</a>,
   <a href=#concept-fe-checked title=concept-fe-checked>checkedness</a>, and <a href=#concept-input-checked-dirty-flag title=concept-input-checked-dirty-flag>dirty checkedness
   flag</a> must be propagated to the clone when it is created.</p>
 
@@ -57326,10 +57333,11 @@
 
    <li>
 
-    <p>Clone the nodes in <var title="">heading content</var> and
-    their descendants into an environment that has <a href=#concept-bc-noscript title=concept-bc-noscript>scripting disabled</a>, has no
-    <a href=#plugin title=plugin>plugins</a>, and fails any attempt to
-    <a href=#fetch title=fetch>fetch</a> any resources. Let <var title="">cloned heading content</var> be a new
+    <p><a href=#concept-clone title=concept-clone>Clone</a> the nodes in <var title="">heading content</var> and their descendants into an
+    environment that has <a href=#concept-bc-noscript title=concept-bc-noscript>scripting
+    disabled</a>, has no <a href=#plugin title=plugin>plugins</a>, and
+    fails any attempt to <a href=#fetch title=fetch>fetch</a> any
+    resources. Let <var title="">cloned heading content</var> be a new
     <code><a href=#documentfragment>DocumentFragment</a></code> containing the resulting cloned
     nodes, preserving their relative order.</p>
 
@@ -57364,12 +57372,13 @@
 
     <ol><li>
 
-      <p>Clone the nodes in <var title="">subheading content</var>
-      and their descendants into an environment that has <a href=#concept-bc-noscript title=concept-bc-noscript>scripting disabled</a>, has no
-      <a href=#plugin title=plugin>plugins</a>, and fails any attempt to
-      <a href=#fetch title=fetch>fetch</a> any resources. Let <var title="">cloned subheading content</var> be a new
-      <code><a href=#documentfragment>DocumentFragment</a></code> containing the resulting cloned
-      nodes, preserving their relative order.</p>
+      <p><a href=#concept-clone title=concept-clone>Clone</a> the nodes in <var title="">subheading content</var> and their descendants into an
+      environment that has <a href=#concept-bc-noscript title=concept-bc-noscript>scripting
+      disabled</a>, has no <a href=#plugin title=plugin>plugins</a>, and
+      fails any attempt to <a href=#fetch title=fetch>fetch</a> any
+      resources. Let <var title="">cloned subheading content</var> be
+      a new <code><a href=#documentfragment>DocumentFragment</a></code> containing the resulting
+      cloned nodes, preserving their relative order.</p>
 
      </li>
 
@@ -57476,12 +57485,13 @@
 
      <li>
 
-      <p>Clone the nodes in <var title="">heading content</var> and
-      their descendants into an environment that has <a href=#concept-bc-noscript title=concept-bc-noscript>scripting disabled</a>, has no
-      <a href=#plugin title=plugin>plugins</a>, and fails any attempt to
-      <a href=#fetch title=fetch>fetch</a> any resources. Let <var title="">cloned heading content</var> be a new
-      <code><a href=#documentfragment>DocumentFragment</a></code> containing the resulting cloned
-      nodes, preserving their relative order.</p>
+      <p><a href=#concept-clone title=concept-clone>Clone</a> the nodes in <var title="">heading content</var> and their descendants into an
+      environment that has <a href=#concept-bc-noscript title=concept-bc-noscript>scripting
+      disabled</a>, has no <a href=#plugin title=plugin>plugins</a>, and
+      fails any attempt to <a href=#fetch title=fetch>fetch</a> any
+      resources. Let <var title="">cloned heading content</var> be a
+      new <code><a href=#documentfragment>DocumentFragment</a></code> containing the resulting
+      cloned nodes, preserving their relative order.</p>
 
      </li>
 
@@ -57511,8 +57521,8 @@
 
      <li>
 
-      <p>Clone <var title="">article</var> and its descendants into an
-      environment that has <a href=#concept-bc-noscript title=concept-bc-noscript>scripting
+      <p><a href=#concept-clone title=concept-clone>Clone</a> <var title="">article</var> and its descendants into an environment
+      that has <a href=#concept-bc-noscript title=concept-bc-noscript>scripting
       disabled</a>, has no <a href=#plugin title=plugin>plugins</a>, and
       fails any attempt to <a href=#fetch title=fetch>fetch</a> any
       resources. Let <var title="">cloned article</var> be the

Modified: source
===================================================================
--- source	2011-02-09 00:29:12 UTC (rev 5862)
+++ source	2011-02-09 00:43:15 UTC (rev 5863)
@@ -1683,7 +1683,17 @@
   value, text node, or string, means that the length of the text is
   zero (i.e. not even containing spaces or control characters).</p>
 
+  <p>Nodes can be <dfn title="concept-clone">cloned</dfn>, as
+  described in the DOM Core specification. For example, the <code
+  title="dom-cloneNode">cloneNode()</code> and <code
+  title="dom-importNode">importNode()</code> methods of the
+  <code>Node</code> interface both clone nodes, as do a number of
+  algorithms in this specification. Certain <span>HTML elements</span>
+  (in particular, <code>input</code> and <code>script</code>) apply
+  additional requirements on how they are cloned. <a
+  href="#refsDOMCORE">[DOMCORE]</a></p>
 
+
   <h4>Scripting</h4>
 
   <p>The construction "a <code>Foo</code> object", where
@@ -15754,8 +15764,9 @@
   has been <dfn>"already started"</dfn>. Initially,
   <code>script</code> elements must have this flag unset (script
   blocks, when created, are not "already started"). When a
-  <code>script</code> element is cloned, the "already started" flag,
-  if set, must be propagated to the clone when it is created.</p>
+  <code>script</code> element is <span
+  title="concept-clone">cloned</span>, the "already started" flag, if
+  set, must be propagated to the clone when it is created.</p>
 
   <p>The second is a flag indicating whether the element was
   <dfn>"parser-inserted"</dfn>. Initially, <code>script</code>
@@ -45206,7 +45217,8 @@
   <code>input</code> element <i
   title="concept-input-immutable">immutable</i>.</p>
 
-  <p>When an <code>input</code> element is cloned, the element's <span
+  <p>When an <code>input</code> element is <span
+  title="concept-clone">cloned</span>, the element's <span
   title="concept-fe-value">value</span>, <span
   title="concept-input-value-dirty-flag">dirty value flag</span>,
   <span title="concept-fe-checked">checkedness</span>, and <span
@@ -65090,12 +65102,12 @@
 
    <li>
 
-    <p>Clone the nodes in <var title="">heading content</var> and
-    their descendants into an environment that has <span
-    title="concept-bc-noscript">scripting disabled</span>, has no
-    <span title="plugin">plugins</span>, and fails any attempt to
-    <span title="fetch">fetch</span> any resources. Let <var
-    title="">cloned heading content</var> be a new
+    <p><span title="concept-clone">Clone</span> the nodes in <var
+    title="">heading content</var> and their descendants into an
+    environment that has <span title="concept-bc-noscript">scripting
+    disabled</span>, has no <span title="plugin">plugins</span>, and
+    fails any attempt to <span title="fetch">fetch</span> any
+    resources. Let <var title="">cloned heading content</var> be a new
     <code>DocumentFragment</code> containing the resulting cloned
     nodes, preserving their relative order.</p>
 
@@ -65137,14 +65149,14 @@
 
      <li>
 
-      <p>Clone the nodes in <var title="">subheading content</var>
-      and their descendants into an environment that has <span
-      title="concept-bc-noscript">scripting disabled</span>, has no
-      <span title="plugin">plugins</span>, and fails any attempt to
-      <span title="fetch">fetch</span> any resources. Let <var
-      title="">cloned subheading content</var> be a new
-      <code>DocumentFragment</code> containing the resulting cloned
-      nodes, preserving their relative order.</p>
+      <p><span title="concept-clone">Clone</span> the nodes in <var
+      title="">subheading content</var> and their descendants into an
+      environment that has <span title="concept-bc-noscript">scripting
+      disabled</span>, has no <span title="plugin">plugins</span>, and
+      fails any attempt to <span title="fetch">fetch</span> any
+      resources. Let <var title="">cloned subheading content</var> be
+      a new <code>DocumentFragment</code> containing the resulting
+      cloned nodes, preserving their relative order.</p>
 
      </li>
 
@@ -65274,14 +65286,14 @@
 
      <li>
 
-      <p>Clone the nodes in <var title="">heading content</var> and
-      their descendants into an environment that has <span
-      title="concept-bc-noscript">scripting disabled</span>, has no
-      <span title="plugin">plugins</span>, and fails any attempt to
-      <span title="fetch">fetch</span> any resources. Let <var
-      title="">cloned heading content</var> be a new
-      <code>DocumentFragment</code> containing the resulting cloned
-      nodes, preserving their relative order.</p>
+      <p><span title="concept-clone">Clone</span> the nodes in <var
+      title="">heading content</var> and their descendants into an
+      environment that has <span title="concept-bc-noscript">scripting
+      disabled</span>, has no <span title="plugin">plugins</span>, and
+      fails any attempt to <span title="fetch">fetch</span> any
+      resources. Let <var title="">cloned heading content</var> be a
+      new <code>DocumentFragment</code> containing the resulting
+      cloned nodes, preserving their relative order.</p>
 
      </li>
 
@@ -65317,8 +65329,9 @@
 
      <li>
 
-      <p>Clone <var title="">article</var> and its descendants into an
-      environment that has <span title="concept-bc-noscript">scripting
+      <p><span title="concept-clone">Clone</span> <var
+      title="">article</var> and its descendants into an environment
+      that has <span title="concept-bc-noscript">scripting
       disabled</span>, has no <span title="plugin">plugins</span>, and
       fails any attempt to <span title="fetch">fetch</span> any
       resources. Let <var title="">cloned article</var> be the




More information about the Commit-Watchers mailing list