[css-pseudo] Editorial tweaks to highlight overlay description

Author: fantasai

css-pseudo/Overview.bs

@@ -497,25 +497,18 @@ Styling Highlights</h3>
 <h3 id=highlight-bounds>
 Area of a Highlight</h3>
 
-  <p>For each instance of highlighting
-  there exists a <dfn>root highlight overlay</dfn>
-  which is a tesselated overlay
-  over the entire tree,
-  the actively-highlighted portions of which are represented
+  <p>For each type of highlighting
+  there exists a <dfn>highlight overlay</dfn>,
+  the active portions of which are represented
   by the corresponding <a>highlight pseudo-element</a>.
-  The ''::selection'' overlay is drawn
-  over the ''::spelling-error'' overlay
-  which is drawn over the ''::grammar-error'' overlay.
-
-
   Each box owns a piece of the overlay corresponding to any text or replaced content
   directly contained by the box.
 
   <ul>
     <li>
       For text, the corresponding overlay must cover at least the entire em box
       and may extend further above/below the em box to the line box edges.
-      Spacing between two characters may also be part of the overlay,
+      Spacing between two characters may also be part of the overlay area,
       in which case it belongs to the innermost element that contains both characters
       and is selected when both characters are selected.
     <li>
@@ -539,7 +532,7 @@ Area of a Highlight</h3>
 <h3 id=highlight-cascade>
 Cascading and Per-Element Highlight Styles</h3>
 
-  Each element draws its own portion of the <a>root highlight overlay</a>,
+  Each element draws its own portion of the <a>highlight overlay</a>,
   which receives the styles specified by the <a>highlight pseudo-element</a> styles
   for which it or one of its ancestors is the <i>originating element</i>.
   When multiple styles conflict,
@@ -578,15 +571,16 @@ Cascading and Per-Element Highlight Styles</h3>
 <h3 id="highlight-painting">
 Painting the Highlight</h3>
 
-  The ''::selection'' pseudo element draws its background
-  over the selected portion of the element,
+  Each <a>highlight pseudo-element</a> draws its background
+  over the active portion of the overlay,
+  painting it
   immediately below any positioned descendants
   (i.e. just before step 8 in <a href="http://www.w3.org/TR/CSS21/zindex.html">CSS2.1&sect;E.2</a>).
   It also suppresses the drawing of any selected text
   (and any text decorations applied to that text)
   and instead redraws that text
   (and its decorations)
-  over that background
+  over the <a>highlight overlay</a> background
   using the specified 'color'.
 
   Issue: What should happen with text shadows?
@@ -597,11 +591,15 @@ Painting the Highlight</h3>
   However, for replaced content, the UA should create a semi-transparent wash
   to coat the content so that it can show through the selection.
   This wash should be of the specified 'background-color' if that is not ''transparent'',
-  else the specified 'color';
+  else of the specified 'color';
   however the UA may adjust the alpha channel if it is opaque.
 
+  The ''::selection'' overlay is drawn
+  over the ''::spelling-error'' overlay
+  which is drawn over the ''::grammar-error'' overlay.
+
 <h3 id="highlight-security">
-Security Considerations</h3>
+Security and Privacy Considerations</h3>
 
   Because the styling of spelling and grammar errors
   can leak information about the contents of a user's dictionary

css-pseudo/Overview.html

@@ -56,7 +56,7 @@
   <div class="head">
    <p data-fill-with="logo"><a class="logo" href="http://www.w3.org/"> <img alt="W3C" height="48" src="https://www.w3.org/Icons/w3c_home" width="72"> </a> </p>
    <h1 class="p-name no-ref" id="title">CSS Pseudo-Elements Module Level 4</h1>
-   <h2 class="no-num no-toc no-ref heading settled" id="subtitle"><span class="content">Editor’s Draft, <time class="dt-updated" datetime="2015-12-11">11 December 2015</time></span></h2>
+   <h2 class="no-num no-toc no-ref heading settled" id="subtitle"><span class="content">Editor’s Draft, <time class="dt-updated" datetime="2016-01-03">3 January 2016</time></span></h2>
    <div data-fill-with="spec-metadata">
     <dl>
      <dt>This version:
@@ -80,7 +80,7 @@ <h2 class="no-num no-toc no-ref heading settled" id="subtitle"><span class="cont
     </dl>
    </div>
    <div data-fill-with="warning"></div>
-   <p class="copyright" data-fill-with="copyright"><a href="http://www.w3.org/Consortium/Legal/ipr-notice#Copyright">Copyright</a> © 2015 <a href="http://www.w3.org/"><abbr title="World Wide Web Consortium">W3C</abbr></a><sup>®</sup> (<a href="http://www.csail.mit.edu/"><abbr title="Massachusetts Institute of Technology">MIT</abbr></a>, <a href="http://www.ercim.eu/"><abbr title="European Research Consortium for Informatics and Mathematics">ERCIM</abbr></a>, <a href="http://www.keio.ac.jp/">Keio</a>, <a href="http://ev.buaa.edu.cn/">Beihang</a>). W3C <a href="http://www.w3.org/Consortium/Legal/ipr-notice#Legal_Disclaimer">liability</a>, <a href="http://www.w3.org/Consortium/Legal/ipr-notice#W3C_Trademarks">trademark</a> and <a href="http://www.w3.org/Consortium/Legal/copyright-documents">document use</a> rules apply. </p>
+   <p class="copyright" data-fill-with="copyright"><a href="http://www.w3.org/Consortium/Legal/ipr-notice#Copyright">Copyright</a> © 2016 <a href="http://www.w3.org/"><abbr title="World Wide Web Consortium">W3C</abbr></a><sup>®</sup> (<a href="http://www.csail.mit.edu/"><abbr title="Massachusetts Institute of Technology">MIT</abbr></a>, <a href="http://www.ercim.eu/"><abbr title="European Research Consortium for Informatics and Mathematics">ERCIM</abbr></a>, <a href="http://www.keio.ac.jp/">Keio</a>, <a href="http://ev.buaa.edu.cn/">Beihang</a>). W3C <a href="http://www.w3.org/Consortium/Legal/ipr-notice#Legal_Disclaimer">liability</a>, <a href="http://www.w3.org/Consortium/Legal/ipr-notice#W3C_Trademarks">trademark</a> and <a href="http://www.w3.org/Consortium/Legal/copyright-documents">document use</a> rules apply. </p>
    <hr title="Separator for header">
   </div>
   <h2 class="no-num no-toc no-ref heading settled" id="abstract"><span class="content">Abstract</span></h2>
@@ -141,7 +141,7 @@ <h2 class="no-num no-toc no-ref heading settled" id="contents"><span class="cont
       <li><a href="#highlight-bounds"><span class="secno">3.3</span> <span class="content"> Area of a Highlight</span></a>
       <li><a href="#highlight-cascade"><span class="secno">3.4</span> <span class="content"> Cascading and Per-Element Highlight Styles</span></a>
       <li><a href="#highlight-painting"><span class="secno">3.5</span> <span class="content"> Painting the Highlight</span></a>
-      <li><a href="#highlight-security"><span class="secno">3.6</span> <span class="content"> Security Considerations</span></a>
+      <li><a href="#highlight-security"><span class="secno">3.6</span> <span class="content"> Security and Privacy Considerations</span></a>
      </ul>
     <li>
      <a href="#treelike"><span class="secno">4</span> <span class="content"> Tree-Abiding Pseudo-elements</span></a>
@@ -520,20 +520,16 @@ <h3 class="heading settled" data-level="3.2" id="highlight-styling"><span class=
   Note: Because <a class="property" data-link-type="propdesc" href="https://drafts.csswg.org/css-text-decor-3/#propdef-text-emphasis-color">text-emphasis-color</a> defaults to <span class="css">currrentColor</span>,
   it will by default also set the color of the the emphasis marks.</p>
    <h3 class="heading settled" data-level="3.3" id="highlight-bounds"><span class="secno">3.3. </span><span class="content"> Area of a Highlight</span><a class="self-link" href="#highlight-bounds"></a></h3>
-   <p>For each instance of highlighting
-  there exists a <dfn data-dfn-type="dfn" data-noexport="" id="root-highlight-overlay">root highlight overlay<a class="self-link" href="#root-highlight-overlay"></a></dfn> which is a tesselated overlay
-  over the entire tree,
-  the actively-highlighted portions of which are represented
+   <p>For each type of highlighting
+  there exists a <dfn data-dfn-type="dfn" data-noexport="" id="highlight-overlay">highlight overlay<a class="self-link" href="#highlight-overlay"></a></dfn>,
+  the active portions of which are represented
   by the corresponding <a data-link-type="dfn" href="#highlight-pseudo-elements">highlight pseudo-element</a>.
-  The <a class="css" data-link-type="maybe" href="#selectordef-selection">::selection</a> overlay is drawn
-  over the <a class="css" data-link-type="maybe" href="#selectordef-spelling-error">::spelling-error</a> overlay
-  which is drawn over the <a class="css" data-link-type="maybe" href="#selectordef-grammar-error">::grammar-error</a> overlay. </p>
-   <p>Each box owns a piece of the overlay corresponding to any text or replaced content
-  directly contained by the box.</p>
+  Each box owns a piece of the overlay corresponding to any text or replaced content
+  directly contained by the box. </p>
    <ul>
     <li> For text, the corresponding overlay must cover at least the entire em box
       and may extend further above/below the em box to the line box edges.
-      Spacing between two characters may also be part of the overlay,
+      Spacing between two characters may also be part of the overlay area,
       in which case it belongs to the innermost element that contains both characters
       and is selected when both characters are selected. 
     <li> For replaced content, the associated overlay must cover at least the entire replaced object,
@@ -544,7 +540,7 @@ <h3 class="heading settled" data-level="3.3" id="highlight-bounds"><span class="
    <p class="issue" id="issue-b6466947"><a class="self-link" href="#issue-b6466947"></a> See <a href="http://lists.w3.org/Archives/Public/www-style/2008Nov/0022.html">F2F minutes</a>, <a href="http://lists.w3.org/Archives/Public/www-style/2008Oct/0268.html">dbaron’s message</a>, <a href="http://lists.w3.org/Archives/Public/www-style/2010May/0247.html">Daniel’s thread</a>, <a href="http://lists.w3.org/Archives/Public/www-style/2010May/0261.html">Gecko notes</a>, <a href="http://lists.w3.org/Archives/Public/www-style/2010May/0366.html">Opera notes</a>, <a href="http://lists.w3.org/Archives/Public/www-style/2010May/0280.html">Webkit notes</a></p>
    <p class="issue" id="issue-271a1b90"><a class="self-link" href="#issue-271a1b90"></a> Not sure if this is the correct way of describing the way things work.</p>
    <h3 class="heading settled" data-level="3.4" id="highlight-cascade"><span class="secno">3.4. </span><span class="content"> Cascading and Per-Element Highlight Styles</span><a class="self-link" href="#highlight-cascade"></a></h3>
-   <p>Each element draws its own portion of the <a data-link-type="dfn" href="#root-highlight-overlay">root highlight overlay</a>,
+   <p>Each element draws its own portion of the <a data-link-type="dfn" href="#highlight-overlay">highlight overlay</a>,
   which receives the styles specified by the <a data-link-type="dfn" href="#highlight-pseudo-elements">highlight pseudo-element</a> styles
   for which it or one of its ancestors is the <i>originating element</i>.
   When multiple styles conflict,
@@ -571,25 +567,29 @@ <h3 class="heading settled" data-level="3.4" id="highlight-cascade"><span class=
   (<a class="css" data-link-type="maybe" href="#selectordef-selection">::selection</a> alone would apply to every element in the tree,
   overriding the more specific styles of any ancestors.) </p>
    <h3 class="heading settled" data-level="3.5" id="highlight-painting"><span class="secno">3.5. </span><span class="content"> Painting the Highlight</span><a class="self-link" href="#highlight-painting"></a></h3>
-   <p>The <a class="css" data-link-type="maybe" href="#selectordef-selection">::selection</a> pseudo element draws its background
-  over the selected portion of the element,
+   <p>Each <a data-link-type="dfn" href="#highlight-pseudo-elements">highlight pseudo-element</a> draws its background
+  over the active portion of the overlay,
+  painting it
   immediately below any positioned descendants
   (i.e. just before step 8 in <a href="http://www.w3.org/TR/CSS21/zindex.html">CSS2.1§E.2</a>).
   It also suppresses the drawing of any selected text
   (and any text decorations applied to that text)
   and instead redraws that text
   (and its decorations)
-  over that background
+  over the <a data-link-type="dfn" href="#highlight-overlay">highlight overlay</a> background
   using the specified <a class="property" data-link-type="propdesc" href="https://drafts.csswg.org/css-color-3/#color0">color</a>.</p>
    <p class="issue" id="issue-b85c3e18"><a class="self-link" href="#issue-b85c3e18"></a> What should happen with text shadows?
   Drawing them in their original color is disconcerting if that color is not a shade of gray.</p>
    <p>For non-replaced content, the UA must honor the <a class="property" data-link-type="propdesc" href="https://drafts.csswg.org/css-color-3/#color0">color</a> and <a class="property" data-link-type="propdesc" href="https://drafts.csswg.org/css-backgrounds-3/#background-color">background-color</a> (including their alpha channels) as specified.
   However, for replaced content, the UA should create a semi-transparent wash
   to coat the content so that it can show through the selection.
   This wash should be of the specified <a class="property" data-link-type="propdesc" href="https://drafts.csswg.org/css-backgrounds-3/#background-color">background-color</a> if that is not <a class="css" data-link-type="maybe" href="https://drafts.csswg.org/css-color-4/#valdef-color-transparent">transparent</a>,
-  else the specified <a class="property" data-link-type="propdesc" href="https://drafts.csswg.org/css-color-3/#color0">color</a>;
+  else of the specified <a class="property" data-link-type="propdesc" href="https://drafts.csswg.org/css-color-3/#color0">color</a>;
   however the UA may adjust the alpha channel if it is opaque.</p>
-   <h3 class="heading settled" data-level="3.6" id="highlight-security"><span class="secno">3.6. </span><span class="content"> Security Considerations</span><a class="self-link" href="#highlight-security"></a></h3>
+   <p>The <a class="css" data-link-type="maybe" href="#selectordef-selection">::selection</a> overlay is drawn
+  over the <a class="css" data-link-type="maybe" href="#selectordef-spelling-error">::spelling-error</a> overlay
+  which is drawn over the <a class="css" data-link-type="maybe" href="#selectordef-grammar-error">::grammar-error</a> overlay.</p>
+   <h3 class="heading settled" data-level="3.6" id="highlight-security"><span class="secno">3.6. </span><span class="content"> Security and Privacy Considerations</span><a class="self-link" href="#highlight-security"></a></h3>
    <p>Because the styling of spelling and grammar errors
   can leak information about the contents of a user’s dictionary
   (which can include the user’s name and even includes the contents of his/her address book!)
@@ -893,7 +893,6 @@ <h3 class="no-num heading settled" id="index-defined-here"><span class="content"
    <li><a href="#selectordef-before">::before</a><span>, in §4.1</span>
    <li><a href="#csspseudoelement">CSSPseudoElement</a><span>, in §6.1</span>
    <li><a href="#csspseudoelementlist">CSSPseudoElementList</a><span>, in §6.2</span>
-   <li><a href="#dom-window-getpseudoelements-elt-type-elt">elt</a><span>, in §6.3</span>
    <li><a href="#fictional-tag-sequence">fictional tag sequence</a><span>, in §2.1</span>
    <li><a href="#first-formatted-line">first formatted line</a><span>, in §2.1.1</span>
    <li><a href="#selectordef-first-letter">::first-letter</a><span>, in §2.2</span>
@@ -903,8 +902,8 @@ <h3 class="no-num heading settled" id="index-defined-here"><span class="content"
    <li><a href="#dom-window-getpseudochildren">getPseudoElements()</a><span>, in §6.3</span>
    <li><a href="#dom-window-getpseudoelements">getPseudoElements(elt, type)</a><span>, in §6.3</span>
    <li><a href="#selectordef-grammar-error">::grammar-error</a><span>, in §3.1</span>
+   <li><a href="#highlight-overlay">highlight overlay</a><span>, in §3.3</span>
    <li><a href="#highlight-pseudo-elements">highlight pseudo-elements</a><span>, in §3.1</span>
-   <li><a href="#dom-csspseudoelementlist-item-index-index">index</a><span>, in §6.2</span>
    <li><a href="#dom-csspseudochildlist-item">item()</a><span>, in §6.2</span>
    <li><a href="#dom-csspseudoelementlist-item">item(index)</a><span>, in §6.2</span>
    <li>
@@ -915,7 +914,6 @@ <h3 class="no-num heading settled" id="index-defined-here"><span class="content"
     </ul>
    <li><a href="#selectordef-marker">::marker</a><span>, in §4.2</span>
    <li><a href="#selectordef-placeholder">::placeholder</a><span>, in §4.3</span>
-   <li><a href="#root-highlight-overlay">root highlight overlay</a><span>, in §3.3</span>
    <li><a href="#selectordef-selection">::selection</a><span>, in §3.1</span>
    <li><a href="#selectordef-spelling-error">::spelling-error</a><span>, in §3.1</span>
    <li>
@@ -929,8 +927,6 @@ <h3 class="no-num heading settled" id="index-defined-here"><span class="content"
     <ul>
      <li><a href="#dom-csspseudoelement-type">attribute for CSSPseudoElement</a><span>, in §6.1</span>
      <li><a href="#dom-csspseudochild-type">definition of</a><span>, in §6.1</span>
-     <li><a href="#dom-csspseudoelementlist-getbytype-type-type">argument for CSSPseudoElementList/getByType(type)</a><span>, in §6.2</span>
-     <li><a href="#dom-window-getpseudoelements-elt-type-type">argument for Window/getPseudoElements(elt, type)</a><span>, in §6.3</span>
     </ul>
   </ul>
   <h3 class="no-num heading settled" id="index-defined-elsewhere"><span class="content">Terms defined by reference</span><a class="self-link" href="#index-defined-elsewhere"></a></h3>
@@ -1063,7 +1059,7 @@ <h3 class="no-num heading settled" id="normative"><span class="content">Normativ
    <dt id="biblio-css-ui-3"><a class="self-link" href="#biblio-css-ui-3"></a>[CSS-UI-3]
    <dd>Tantek Çelik; Florian Rivoal. <a href="http://www.w3.org/TR/css-ui-3/">CSS Basic User Interface Module Level 3 (CSS3 UI)</a>. 7 July 2015. CR. URL: <a href="http://www.w3.org/TR/css-ui-3/">http://www.w3.org/TR/css-ui-3/</a>
    <dt id="biblio-css-writing-modes-3"><a class="self-link" href="#biblio-css-writing-modes-3"></a>[CSS-WRITING-MODES-3]
-   <dd>Elika Etemad; Koji Ishii. <a href="http://www.w3.org/TR/css-writing-modes-3/">CSS Writing Modes Level 3</a>. 20 March 2014. CR. URL: <a href="http://www.w3.org/TR/css-writing-modes-3/">http://www.w3.org/TR/css-writing-modes-3/</a>
+   <dd>Elika Etemad; Koji Ishii. <a href="http://www.w3.org/TR/css-writing-modes-3/">CSS Writing Modes Level 3</a>. 15 December 2015. CR. URL: <a href="http://www.w3.org/TR/css-writing-modes-3/">http://www.w3.org/TR/css-writing-modes-3/</a>
    <dt id="biblio-cssom"><a class="self-link" href="#biblio-cssom"></a>[CSSOM]
    <dd>Simon Pieters; Glenn Adams. <a href="http://www.w3.org/TR/cssom/">CSS Object Model (CSSOM)</a>. 5 December 2013. WD. URL: <a href="http://www.w3.org/TR/cssom/">http://www.w3.org/TR/cssom/</a>
    <dt id="biblio-dom-ls"><a class="self-link" href="#biblio-dom-ls"></a>[DOM-LS]
@@ -1090,7 +1086,7 @@ <h3 class="no-num heading settled" id="informative"><span class="content">Inform
    <dt id="biblio-css3-fonts"><a class="self-link" href="#biblio-css3-fonts"></a>[CSS3-FONTS]
    <dd>John Daggett. <a href="http://www.w3.org/TR/css-fonts-3/">CSS Fonts Module Level 3</a>. 3 October 2013. CR. URL: <a href="http://www.w3.org/TR/css-fonts-3/">http://www.w3.org/TR/css-fonts-3/</a>
    <dt id="biblio-css3-writing-modes"><a class="self-link" href="#biblio-css3-writing-modes"></a>[CSS3-WRITING-MODES]
-   <dd>Elika Etemad; Koji Ishii. <a href="http://www.w3.org/TR/css-writing-modes-3/">CSS Writing Modes Level 3</a>. 20 March 2014. CR. URL: <a href="http://www.w3.org/TR/css-writing-modes-3/">http://www.w3.org/TR/css-writing-modes-3/</a>
+   <dd>Elika Etemad; Koji Ishii. <a href="http://www.w3.org/TR/css-writing-modes-3/">CSS Writing Modes Level 3</a>. 15 December 2015. CR. URL: <a href="http://www.w3.org/TR/css-writing-modes-3/">http://www.w3.org/TR/css-writing-modes-3/</a>
    <dt id="biblio-html5"><a class="self-link" href="#biblio-html5"></a>[HTML5]
    <dd>Ian Hickson; et al. <a href="http://www.w3.org/TR/html5/">HTML5</a>. 28 October 2014. REC. URL: <a href="http://www.w3.org/TR/html5/">http://www.w3.org/TR/html5/</a>
   </dl>