[css-scoping] Use the terms 'youngest shadow tree' and 'distributed nodes', to match the Shadow DOM spec.

Author: tabatkins

css-scoping/Overview.bs

@@ -199,14 +199,14 @@ Shadow Encapsulation</h2>
 	An element can have any number of <a>shadow trees</a>,
 	which are ordered by creation time.
 	The most recently-created <a>shadow tree</a> on an element
-	is the <dfn export>active shadow tree</dfn> for that element.
+	is the <dfn export>youngest shadow tree</dfn> for that element.
 
 	An element with a <a>shadow tree</a> is a <dfn export>shadow host</dfn>.
 	It is the <dfn export>host element</dfn> for its shadow trees.
 
 	The descendants of a <a>shadow host</a>
 	must not generate boxes in the formatting tree.
-	Instead, the contents of the <a>active shadow tree</a> generate boxes
+	Instead, the contents of the <a>youngest shadow tree</a> generate boxes
 	as if they were the contents of the element instead.
 
 	In several instances in shadow DOM,
@@ -219,16 +219,16 @@ Shadow Encapsulation</h2>
 
 	While the children of a <a>shadow host</a> do not generate boxes normally,
 	they can be explicitly pulled into a <a>shadow tree</a> and forced to render normally.
-	This is done by assigning the elements to a <dfn export>distribution list</dfn>.
-	An element with a <a>distribution list</a> is an <dfn export>insertion point</dfn>.
+	This is done by marking the elements as <dfn export>distributed nodes</dfn>
+	for an <dfn export>insertion point</dfn> element.
 
-	This specification does not define how to assign elements to a <a>distribution list</a>,
+	This specification does not define how to mark elements as <a>distributed nodes</a>,
 	instead leaving that to the Shadow DOM spec.
 	At the time this spec is written, however,
-	only <a element>content</a> elements in a <a>shadow tree</a> can have <a>distribution lists</a>.
+	only <a element>content</a> elements in a <a>shadow tree</a> can be <a>insertion points</a>.
 
 	An <a>insertion point</a> must not generate any boxes.
-	Instead, the elements in its <a>distribution list</a> generate boxes as normal,
+	Instead, its <a>distributed nodes</a> generate boxes as normal,
 	as if they all replaced the <a>insertion point</a> in-place.
 	<span class='note'>(Akin to the behavior of ''display-outside: contents''.)</span>
 
@@ -237,11 +237,11 @@ Shadow DOM Selection Model</h3>
 
 	Elements in the DOM
 	have zero or more <a>shadow trees</a>
-	and zero or one <a>distribution lists</a>.
+	and zero or more <a>distributed nodes</a>.
 
 	Note: The "descendants" of an element
 	are based on the children of the element,
-	which does not include the <a>shadow trees</a> or <a>distribution lists</a> of the element.
+	which does not include the <a>shadow trees</a> or <a>distributed nodes</a> of the element.
 
 	When a selector is matched against a <a>shadow tree</a>,
 	the <a>selector match list</a>
@@ -372,7 +372,7 @@ Selecting Into the Light: the '':host'', '':host()'', and '':host-context()'' ps
 	For the purpose of this pseudo-class,
 	the "ancestor" of an element is:
 
-	: if the element is distributed to a <a>distribution list</a>
+	: if the element is a <a>distributed node</a>
 	:: the <a element>content</a> element it is ultimately distributed to.
 	: if the element is a top-most element in a shadow tree
 	:: the <a>host element</a>
@@ -439,8 +439,8 @@ Selecting Into the Dark: the ''::shadow'' pseudo-element</h4>
 <h4 id='content-combinator'>
 Selecting Shadow-Projected Content: the ''::content'' pseudo-element</h4>
 
-	The <dfn selector>::content</dfn> pseudo-element matches the <a>distribution list</a> itself,
-	on elements that have one.
+	The <dfn selector>::content</dfn> pseudo-element matches the list of <a>distributed nodes</a> itself,
+	on elements that have them.
 
 	<p class="issue">
 	''::content'' is a confusingly general name for something that is specific
@@ -449,7 +449,7 @@ Selecting Shadow-Projected Content: the ''::content'' pseudo-element</h4>
 	The ''::content'' pseudo-element must not generate boxes,
 	unless specified otherwise in another specification.
 	However, for the purpose of Selectors,
-	the ''::content'' pseudo-element is considered to be the parent of the elements in the <a>distribution list</a>.
+	the ''::content'' pseudo-element is considered to be the parent of the <a>distributed nodes</a>.
 
 	<div class="example">
 		For example, say you had a component with both children and a shadow tree,
@@ -485,7 +485,7 @@ Selecting Shadow-Projected Content: the ''::content'' pseudo-element</h4>
 		Note: Note that a selector like ''::content div''
 		is equivalent to ''*::content div'',
 		where the ''*'' selects many more elements that just the <a element>content</a> element.
-		However, since only the <a element>content</a> element has a <a>distribution list</a>,
+		However, since only the <a element>content</a> element has <a>distributed nodes</a>,
 		it's the only element that has a ''::content'' pseudo-element as well.
 	</div>
 
@@ -572,7 +572,7 @@ Inheritance</h4>
 	The <a>top-level elements</a> of a <a>shadow tree</a>
 	inherit from their <a>host element</a>.
 
-	The elements in a <a>distribution list</a> inherit from the parent of the <a element>content</a> element they are ultimately distributed to,
+	<a>Distributed nodes</a> inherit from the parent of the <a element>content</a> element they are ultimately distributed to,
 	rather than from their normal parent.
 
 

css-scoping/Overview.html

@@ -560,7 +560,7 @@ <h2 class="heading settled" data-level="3" id="shadow-dom"><span class="secno">3
 	An element can have any number of <a data-link-type="dfn" href="#shadow-tree">shadow trees</a>,
 	which are ordered by creation time.
 	The most recently-created <a data-link-type="dfn" href="#shadow-tree">shadow tree</a> on an element
-	is the <dfn data-dfn-type="dfn" data-export="" id="active-shadow-tree">active shadow tree<a class="self-link" href="#active-shadow-tree"></a></dfn> for that element.</p>
+	is the <dfn data-dfn-type="dfn" data-export="" id="youngest-shadow-tree">youngest shadow tree<a class="self-link" href="#youngest-shadow-tree"></a></dfn> for that element.</p>
 
 
 
@@ -571,7 +571,7 @@ <h2 class="heading settled" data-level="3" id="shadow-dom"><span class="secno">3
 
       <p>The descendants of a <a data-link-type="dfn" href="#shadow-host">shadow host</a>
 	must not generate boxes in the formatting tree.
-	Instead, the contents of the <a data-link-type="dfn" href="#active-shadow-tree">active shadow tree</a> generate boxes
+	Instead, the contents of the <a data-link-type="dfn" href="#youngest-shadow-tree">youngest shadow tree</a> generate boxes
 	as if they were the contents of the element instead.</p>
 
 
@@ -588,20 +588,20 @@ <h2 class="heading settled" data-level="3" id="shadow-dom"><span class="secno">3
 
       <p>While the children of a <a data-link-type="dfn" href="#shadow-host">shadow host</a> do not generate boxes normally,
 	they can be explicitly pulled into a <a data-link-type="dfn" href="#shadow-tree">shadow tree</a> and forced to render normally.
-	This is done by assigning the elements to a <dfn data-dfn-type="dfn" data-export="" id="distribution-list">distribution list<a class="self-link" href="#distribution-list"></a></dfn>.
-	An element with a <a data-link-type="dfn" href="#distribution-list">distribution list</a> is an <dfn data-dfn-type="dfn" data-export="" id="insertion-point">insertion point<a class="self-link" href="#insertion-point"></a></dfn>.</p>
+	This is done by marking the elements as <dfn data-dfn-type="dfn" data-export="" id="distributed-nodes">distributed nodes<a class="self-link" href="#distributed-nodes"></a></dfn>
+	for an <dfn data-dfn-type="dfn" data-export="" id="insertion-point">insertion point<a class="self-link" href="#insertion-point"></a></dfn> element.</p>
 
 
 
-      <p>This specification does not define how to assign elements to a <a data-link-type="dfn" href="#distribution-list">distribution list</a>,
+      <p>This specification does not define how to mark elements as <a data-link-type="dfn" href="#distributed-nodes">distributed nodes</a>,
 	instead leaving that to the Shadow DOM spec.
 	At the time this spec is written, however,
-	only <a data-link-type="element">content</a> elements in a <a data-link-type="dfn" href="#shadow-tree">shadow tree</a> can have <a data-link-type="dfn" href="#distribution-list">distribution lists</a>.</p>
+	only <a data-link-type="element">content</a> elements in a <a data-link-type="dfn" href="#shadow-tree">shadow tree</a> can be <a data-link-type="dfn" href="#insertion-point">insertion points</a>.</p>
 
 
 
       <p>An <a data-link-type="dfn" href="#insertion-point">insertion point</a> must not generate any boxes.
-	Instead, the elements in its <a data-link-type="dfn" href="#distribution-list">distribution list</a> generate boxes as normal,
+	Instead, its <a data-link-type="dfn" href="#distributed-nodes">distributed nodes</a> generate boxes as normal,
 	as if they all replaced the <a data-link-type="dfn" href="#insertion-point">insertion point</a> in-place.
 	<span class="note" role="note">(Akin to the behavior of <a class="css" data-link-type="propdesc" href="http://dev.w3.org/csswg/css-display-3/#propdef-display-outside" title="display-outside">display-outside: contents</a>.)</span></p>
 
@@ -614,13 +614,13 @@ <h3 class="heading settled" data-level="3.1" id="selectors-data-model"><span cla
 
       <p>Elements in the DOM
 	have zero or more <a data-link-type="dfn" href="#shadow-tree">shadow trees</a>
-	and zero or one <a data-link-type="dfn" href="#distribution-list">distribution lists</a>.</p>
+	and zero or more <a data-link-type="dfn" href="#distributed-nodes">distributed nodes</a>.</p>
 
 
 
       <p class="note" role="note">Note: The "descendants" of an element
 	are based on the children of the element,
-	which does not include the <a data-link-type="dfn" href="#shadow-tree">shadow trees</a> or <a data-link-type="dfn" href="#distribution-list">distribution lists</a> of the element.</p>
+	which does not include the <a data-link-type="dfn" href="#shadow-tree">shadow trees</a> or <a data-link-type="dfn" href="#distributed-nodes">distributed nodes</a> of the element.</p>
 
 
 
@@ -832,7 +832,7 @@ <h4 class="heading settled" data-level="3.2.1" id="host-selector"><span class="s
 
       <dl>
         <dt data-md="">
-          <p>if the element is distributed to a <a data-link-type="dfn" href="#distribution-list">distribution list</a></p>
+          <p>if the element is a <a data-link-type="dfn" href="#distributed-nodes">distributed node</a></p>
 
 
         </dt>
@@ -947,8 +947,8 @@ <h4 class="heading settled" data-level="3.2.3" id="content-combinator"><span cla
 
 
 
-      <p>The <dfn class="css" data-dfn-type="selector" data-export="" id="selectordef-content">::content<a class="self-link" href="#selectordef-content"></a></dfn> pseudo-element matches the <a data-link-type="dfn" href="#distribution-list">distribution list</a> itself,
-	on elements that have one.</p>
+      <p>The <dfn class="css" data-dfn-type="selector" data-export="" id="selectordef-content">::content<a class="self-link" href="#selectordef-content"></a></dfn> pseudo-element matches the list of <a data-link-type="dfn" href="#distributed-nodes">distributed nodes</a> itself,
+	on elements that have them.</p>
 
 
 
@@ -960,7 +960,7 @@ <h4 class="heading settled" data-level="3.2.3" id="content-combinator"><span cla
       <p>The <a class="css" data-link-type="maybe" href="#selectordef-content">::content</a> pseudo-element must not generate boxes,
 	unless specified otherwise in another specification.
 	However, for the purpose of Selectors,
-	the <a class="css" data-link-type="maybe" href="#selectordef-content">::content</a> pseudo-element is considered to be the parent of the elements in the <a data-link-type="dfn" href="#distribution-list">distribution list</a>.</p>
+	the <a class="css" data-link-type="maybe" href="#selectordef-content">::content</a> pseudo-element is considered to be the parent of the <a data-link-type="dfn" href="#distributed-nodes">distributed nodes</a>.</p>
 
 
 
@@ -1004,7 +1004,7 @@ <h4 class="heading settled" data-level="3.2.3" id="content-combinator"><span cla
         <p class="note" role="note">Note: Note that a selector like <span class="css">::content div</span>
 		is equivalent to <span class="css">*::content div</span>,
 		where the <span class="css">*</span> selects many more elements that just the <a data-link-type="element">content</a> element.
-		However, since only the <a data-link-type="element">content</a> element has a <a data-link-type="dfn" href="#distribution-list">distribution list</a>,
+		However, since only the <a data-link-type="element">content</a> element has <a data-link-type="dfn" href="#distributed-nodes">distributed nodes</a>,
 		it’s the only element that has a <a class="css" data-link-type="maybe" href="#selectordef-content">::content</a> pseudo-element as well.</p>
 
 
@@ -1133,7 +1133,7 @@ <h4 class="heading settled" data-level="3.3.2" id="inheritance"><span class="sec
 
 
 
-      <p>The elements in a <a data-link-type="dfn" href="#distribution-list">distribution list</a> inherit from the parent of the <a data-link-type="element">content</a> element they are ultimately distributed to,
+      <p><a data-link-type="dfn" href="#distributed-nodes">Distributed nodes</a> inherit from the parent of the <a data-link-type="element">content</a> element they are ultimately distributed to,
 	rather than from their normal parent.</p>
 
 
@@ -1707,10 +1707,9 @@ <h3 class="no-num heading settled" id="informative"><span class="content">Inform
     </dl>
     <h2 class="no-num heading settled" id="index"><span class="content">Index</span><a class="self-link" href="#index"></a></h2>
     <ul class="indexlist">
-      <li>active shadow tree, <a href="#active-shadow-tree" title="section 3">3</a></li>
       <li>::content, <a href="#selectordef-content" title="section 3.2.3">3.2.3</a></li>
       <li>/deep/, <a href="#selectordef--deep-" title="section 3.2.4">3.2.4</a></li>
-      <li>distribution list, <a href="#distribution-list" title="section 3">3</a></li>
+      <li>distributed nodes, <a href="#distributed-nodes" title="section 3">3</a></li>
       <li>fragment pseudo-element, <a href="#fragment-pseudo-element" title="section 4">4</a></li>
       <li>:host(), <a href="#selectordef-host-function" title="section 3.2.1">3.2.1</a></li>
       <li>:host, <a href="#selectordef-host" title="section 3.2.1">3.2.1</a></li>
@@ -1723,6 +1722,7 @@ <h2 class="no-num heading settled" id="index"><span class="content">Index</span>
       <li>shadow root, <a href="#shadow-root" title="section 3">3</a></li>
       <li>shadow tree, <a href="#shadow-tree" title="section 3">3</a></li>
       <li>top-level element, <a href="#top-level-element" title="section 3">3</a></li>
+      <li>youngest shadow tree, <a href="#youngest-shadow-tree" title="section 3">3</a></li>
     </ul>
     <h2 class="no-num heading settled" id="issues-index"><span class="content">Issues Index</span><a class="self-link" href="#issues-index"></a></h2>
     <div style="counter-reset:issue">