simplify CSS pixel nonsense

Author: annevk

cssom-view/Overview.html

@@ -108,6 +108,8 @@ <h2 class="no-num no-toc" id=toc>Table of Contents</h2>
       </span>Dependencies</a>
 
      <li><a href="#terminology"><span class=secno>2.2 </span>Terminology</a>
+
+     <li><a href="#css-pixels"><span class=secno>2.3 </span>CSS pixels</a>
     </ul>
 
    <li><a href="#dom-features"><span class=secno>3 </span>DOM Features</a>
@@ -234,10 +236,9 @@ <h3 id=terminology><span class=secno>2.2 </span>Terminology</h3>
    child of the root <a href="#html-element">HTML element</a>
    <code>html</code>.
 
-  <p>The terms <dfn id=css-pixel>CSS pixel</dfn>, <dfn
-   id=content-edge>content edge</dfn>, <dfn id=padding-edge>padding
-   edge</dfn>, <dfn id=border-edge>border edge</dfn>, and <dfn
-   id=canvas>canvas</dfn> are defined by CSS 2.1. [<cite><a
+  <p>The terms <dfn id=content-edge>content edge</dfn>, <dfn
+   id=padding-edge>padding edge</dfn>, <dfn id=border-edge>border edge</dfn>,
+   and <dfn id=canvas>canvas</dfn> are defined by CSS 2.1. [<cite><a
    href="#ref-css21">CSS21</a></cite>]
 
   <p>The terms <dfn id=viewport>viewport</dfn>, <dfn
@@ -256,6 +257,18 @@ <h3 id=terminology><span class=secno>2.2 </span>Terminology</h3>
    area on the <a href="#canvas">canvas</a> that is rendered upon, excluding
    content on negative axis.
 
+  <h3 id=css-pixels><span class=secno>2.3 </span>CSS pixels</h3>
+
+  <p>All coordinates and dimensions for the APIs defined in this
+   specification are in CSS pixels. [<cite><a
+   href="#ref-css21">CSS21</a></cite>]
+
+  <p class=note>This does not apply to e.g. <code
+   title=dom-media-matchmedium><a
+   href="#dom-media-matchmedium">matchMedium()</a></code> as the units are
+   explicitly given there and defined by the Media Queries specification.
+   [<cite><a href="#ref-mq">MQ</a></cite>]
+
   <h2 id=dom-features><span class=secno>3 </span>DOM Features</h2>
 
   <p>This specification defines the <a
@@ -371,10 +384,6 @@ <h2 id=the-screenview-interface><span class=secno>5 </span>The <code
   readonly attribute <a href="#screen">Screen</a> <a href="#dom-screenview-screen" title=dom-screenview-screen>screen</a>;
 };</pre>
 
-  <p>All coordinates and dimensions on the <a
-   href="#screenview">ScreenView</a> interface are expressed in <a
-   href="#css-pixel" title="CSS pixel">CSS pixels</a>.
-
   <p>The <dfn id=dom-screenview-innerwidth><code>innerWidth</code></dfn>
    attribute, on getting, <em class=ct>must</em> return the <a
    href="#viewport">viewport</a> width.
@@ -487,13 +496,13 @@ <h2 id=the-screenview-interface><span class=secno>5 </span>The <code
 
   <p>The <dfn id=dom-screenview-outerwidth><code>outerWidth</code></dfn>
    attribute, on getting, <em class=ct>must</em> return the width of the
-   client window as number of CSS pixels. If there is no client window this
-   attribute <em class=ct>must</em> return zero.
+   client window. If there is no client window this attribute <em
+   class=ct>must</em> return zero.
 
   <p>The <dfn id=dom-screenview-outerheight><code>outerHeight</code></dfn>
    attribute, on getting, <em class=ct>must</em> return the height of the
-   client window as number of CSS pixels. If there is no client window this
-   attribute <em class=ct>must</em> return zero.
+   client window. If there is no client window this attribute <em
+   class=ct>must</em> return zero.
 
   <p>The <dfn id=dom-screenview-screen
    title=dom-screenview-screen><code>screen</code></dfn> attribute, on
@@ -516,10 +525,6 @@ <h3 id=the-screen-interface><span class=secno>5.1 </span>The <code
   readonly attribute unsigned long <a href="#dom-screen-pixeldepth">pixelDepth</a>;
 };</pre>
 
-  <p>All coordinates and dimensions on the <a href="#screen">Screen</a>
-   interface are expressed in <a href="#css-pixel" title="CSS pixel">CSS
-   pixels</a>.
-
   <p>The <dfn id=dom-screen-availwidth><code>availWidth</code></dfn>
    attribute, on getting, <em class=ct>must</em> return the available width
    of the rendering surface of the output device.
@@ -912,9 +917,6 @@ <h2 id=extensions-to-the-htmlelement-interface><span class=secno>8
   readonly attribute long <a href="#dom-htmlelement-offsetheight">offsetHeight</a>;
 };</pre>
 
-  <p>All coordinates and dimensions on this object are expressed in <a
-   href="#css-pixel" title="CSS pixel">CSS pixels</a>.
-
   <h3 id=offset-attributes><span class=secno>8.1 </span>The <code
    title="">offsetParent</code>, <code title="">offsetTop</code>, <code
    title="">offsetLeft</code>, <code title="">offsetWidth</code>, and <code
@@ -1159,9 +1161,6 @@ <h2 id=extensions-to-the-mouseevent-interface><span class=secno>10
   <p class=XXX>The object IDL fragment redefines some members. Can we resolve
    this somehow?
 
-  <p>All coordinates and dimensions for this object are expressed in <a
-   href="#css-pixel" title="CSS pixel">CSS pixels</a>.
-
   <p>The <dfn id=dom-mouseevent-screenx
    title=dom-mouseevent-screenx><code>screenX</code></dfn> attribute, on
    getting, <em class=ct>must</em> return the x-coordinate of the position
@@ -1262,10 +1261,6 @@ <h3 id=the-clientrect-interface><span class=secno>11.2 </span>The <code
   readonly attribute float <a href="#dom-clientrect-height" title=dom-clientrect-height>height</a>;
 };</pre>
 
-  <p>All coordinates and dimensions on the <code><a
-   href="#clientrect">ClientRect</a></code> interface are expressed in <a
-   href="#css-pixel" title="CSS pixel">CSS pixels</a>.
-
   <p>The <dfn id=dom-clientrect-top
    title=dom-clientrect-top><code>top</code></dfn> attribute, on getting, <em
    class=ct>must</em> return the y-coordinate, relative to the <a

cssom-view/Overview.src.html

@@ -134,7 +134,7 @@ <h3 id="terminology">Terminology</h3>
   <code>body</code> <span>HTML element</span> child of the root
   <span>HTML element</span> <code>html</code>.</p>
 
-  <p>The terms <dfn id="css-pixel">CSS pixel</dfn>,
+  <p>The terms
   <dfn id="content-edge">content edge</dfn>,
   <dfn id="padding-edge">padding edge</dfn>,
   <dfn id="border-edge">border edge</dfn>, and
@@ -157,6 +157,15 @@ <h3 id="terminology">Terminology</h3>
   <span>canvas</span> that is rendered upon, excluding content on negative
   axis.</p>
 
+  <h3>CSS pixels</h3>
+
+  <p>All coordinates and dimensions for the APIs defined in this
+  specification are in CSS pixels. [<cite><span>CSS21</span></cite>]</p>
+  
+  <p class="note">This does not apply to e.g.
+  <code title="dom-media-matchmedium">matchMedium()</code> as the units are
+  explicitly given there and defined by the Media Queries specification.
+  [<cite><span>MQ</span></cite>]</p>
 
 
   <h2 id="dom-features">DOM Features</h2>
@@ -270,9 +279,6 @@ <h2 id="the-screenview-interface">The <code title="">ScreenView</code> Interface
   readonly attribute <span>Screen</span> <span title="dom-screenview-screen">screen</span>;
 };</pre>
 
-  <p>All coordinates and dimensions on the <span>ScreenView</span> interface
-  are expressed in <span title="CSS pixel">CSS pixels</span>.</p>
-
   <p>The <dfn id="dom-screenview-innerwidth"><code>innerWidth</code></dfn>
   attribute, on getting, <em class="ct">must</em> return the
   <span>viewport</span> width.</p>
@@ -374,12 +380,12 @@ <h2 id="the-screenview-interface">The <code title="">ScreenView</code> Interface
 
   <p>The <dfn id="dom-screenview-outerwidth"><code>outerWidth</code></dfn>
   attribute, on getting, <em class="ct">must</em> return the width of the
-  client window as number of CSS pixels. If there is no client window this
+  client window. If there is no client window this
   attribute <em class="ct">must</em> return zero.</p>
 
   <p>The <dfn id="dom-screenview-outerheight"><code>outerHeight</code></dfn>
   attribute, on getting, <em class="ct">must</em> return the height of the
-  client window as number of CSS pixels. If there is no client window
+  client window. If there is no client window
   this attribute <em class="ct">must</em> return zero.</p>
 
   <p>The
@@ -403,9 +409,6 @@ <h3 id="the-screen-interface">The <code title="">Screen</code> Interface</h3>
   readonly attribute unsigned long <span>pixelDepth</span>;
 };</pre>
 
-  <p>All coordinates and dimensions on the <span>Screen</span> interface are
-  expressed in <span title="CSS pixel">CSS pixels</span>.</p>
-
   <p>The <dfn id="dom-screen-availwidth"><code>availWidth</code></dfn>
   attribute, on getting, <em class="ct">must</em> return the available width
   of the rendering surface of the output device.</p>
@@ -759,9 +762,6 @@ <h2 id="extensions-to-the-htmlelement-interface">Extensions to the <code title="
   readonly attribute long <span>offsetHeight</span>;
 };</pre>
 
-  <p>All coordinates and dimensions on this object are expressed in
-  <span title="CSS pixel">CSS pixels</span>.</p>
-
 
   <h3 id="offset-attributes">The <code title="">offsetParent</code>,
   <code title="">offsetTop</code>, <code title="">offsetLeft</code>, 
@@ -991,9 +991,6 @@ <h2 id="extensions-to-the-mouseevent-interface">Extensions to the <code title=""
   <p class="XXX">The object IDL fragment redefines some members. Can we
   resolve this somehow?</p>
 
-  <p>All coordinates and dimensions for this object are expressed in
-  <span title="CSS pixel">CSS pixels</span>.</p>
-
   <p>The
   <dfn id="dom-mouseevent-screenx" title="dom-mouseevent-screenx"><code>screenX</code></dfn>
   attribute, on getting, <em class="ct">must</em> return the x-coordinate of
@@ -1094,9 +1091,6 @@ <h3 id="the-clientrect-interface">The <code title="">ClientRect</code> Interface
   readonly attribute float <span title="dom-clientrect-height">height</span>;
 };</pre>
 
-  <p>All coordinates and dimensions on the <code>ClientRect</code> interface
-  are expressed in <span title="CSS pixel">CSS pixels</span>.</p>
-
   <p>The
   <dfn id="dom-clientrect-top" title="dom-clientrect-top"><code>top</code></dfn>
   attribute, on getting, <em class="ct">must</em> return the y-coordinate,