w3c
diff --git a/‎cssom/Overview.html‎
Lines changed: 55 additions & 40 deletions b/‎cssom/Overview.html‎
Lines changed: 55 additions & 40 deletions
@@ -28,14 +28,14 @@
   <div class=head>
    <h1 id=cssom>Cascading Style Sheets Object Model (<abbr>CSSOM</abbr>)</h1>
 
-   <h2 class="no-num no-toc" id="">Editor's draft <!--W3C Working Draft--> 22
-    December 2006</h2>
+   <h2 class="no-num no-toc" id="">Editor's draft <!--W3C Working Draft--> 15
+    January 2007</h2>
 
    <dl>
     <dt>This version:
 
     <dd><a
-     href="http://www.w3.org/TR/2006/WD-cssom-20061222">http://www.w3.org/TR/2006/WD-cssom-20061222/</a>
+     href="http://www.w3.org/TR/2007/WD-cssom-20070115">http://www.w3.org/TR/2007/WD-cssom-20070115/</a>
 
     <dt>Latest version:
 
@@ -65,7 +65,8 @@ <h2 class="no-num no-toc" id=abstract>Abstract</h2>
 
   <h2 class="no-num no-toc" id=sotd>Status of this Document</h2>
 
-  <p class=issue>This document is in its very early stages.
+  <p class=issue>This document is in its very early stages. The intention is
+   that this specification will in due course supercede DOM Level 2 Style.
 
   <h2 class="no-num no-toc" id=toc>Table of Contents</h2>
   <!--begin-toc-->
@@ -286,11 +287,10 @@ <h3 id=history><span class=secno>1.1. </span>History</h3>
    href="http://www.w3.org/mid/Pine.LNX.4.05.10310302134070.1173-100000@lanalana.inria.fr"
    title="[CSSOM] CSSValue and related interfaces (message from the CSS
    WG)">have been obsoleted</a> because they where thought to be too akward
-   for frequent use. This specification closes the gap by introducing
-   interfaces for accessing values of properties that are "author-friendly."
+   for frequent use. This specification no longer contains those features.
 
-  <p class=issue><code>DOMImplementationCSS</code> has been removed as well,
-   because it doesn't seem to solve any use cases.
+  <p>In addition, <code>DOMImplementationCSS</code> has been removed as well,
+   because there was no use case provided in DOM Level 2 Style.
 
   <h3 id=terminology><span class=secno>1.2. </span>Terminology and
    Conventions</h3>
@@ -302,8 +302,9 @@ <h3 id=terminology><span class=secno>1.2. </span>Terminology and
   <p>A <dfn id=color0>color component separator</dfn> is a literal U+002C
    COMMA followed by a U+0020 SPACE.
 
-  <p>When this specification talks about object <var>A</var> it generally
-   means an object implementing interface <var>A</var>.</p>
+  <p>When this specification talks about object <code><var>A</var></code>
+   where <code><var>A</var></code> is actually an interface, it generally
+   means an object implementing interface <code><var>A</var></code>.</p>
   <!--
   <p>The term <dfn id="whitespace">whitespace</dfn> when  used in this
    specification refers to the U+0020 SPACE, U+0009 &lt;control>, U+000A
@@ -326,6 +327,9 @@ <h4 id=canon><span class=secno>1.2.1. </span>Canonicalization</h4>
    values are returned. Parsing is, after all, defined by various CSS
    specifications.
 
+  <p class=issue>This should probably be moved to the section on CSS style
+   sheets.
+
   <p>This section defines canonicalization of the various objects you
    typically encounter in <span>CSS style sheets</span>.
 
@@ -640,6 +644,8 @@ <h6 id=examples0><span class=secno>1.2.1.3.1. </span>Examples</h6>
 
   <h4 id=types><span class=secno>1.2.2. </span>Types of style sheets</h4>
 
+  <p class=issue>Move this to the document section...
+
   <p>Each style sheet can have a title. A <a href="#style-sheet">style
    sheet</a> is said to <dfn id=style-sheet-title>have a title</dfn> if the
    <code>title</code> attribute on the <code><a
@@ -712,14 +718,15 @@ <h4 id=types><span class=secno>1.2.2. </span>Types of style sheets</h4>
   <h2 id=accessing><span class=secno>2. </span>Accessing style sheets through
    the DOM</h2>
 
-  <p>To get access to the <code><a href="#stylesheet">StyleSheet</a></code>
-   objects representing the <a href="#associated" title="associated style
-   sheet">associated style sheets</a> this section introduces the <code><a
-   href="#linkstyle">LinkStyle</a></code> interface for accessing style
-   sheets from a <code>Node</code> in the DOM and the <code><a
-   href="#documentstyle">DocumentStyle</a></code> interface for accessing
-   style sheets from the <code>Document</code> object. The latter also allows
-   manipulating of style sheet sets (enabling and disabling them).
+  <p>Each style sheet is represented by a <code><a
+   href="#stylesheet">StyleSheet</a></code> object. These objects can be
+   accessed through the <code><a href="#linkstyle">LinkStyle</a></code>
+   interface implemented on individual <code>Node</code> objects or through
+   the <code><a href="#documentstyle">DocumentStyle</a></code> interface
+   implemented on the <code>Document</code> object. The <code><a
+   href="#documentstyle">DocumentStyle</a></code> interface also provides an
+   interface for enabling alternate style sheets and manipulating style sheet
+   sets.
 
   <h3 id=the-linkstyle><span class=secno>2.1. </span>The <code><a
    href="#linkstyle">LinkStyle</a></code> Interface</h3>
@@ -736,9 +743,10 @@ <h3 id=the-linkstyle><span class=secno>2.1. </span>The <code><a
    <code>HTMLStyleElement</code>. They <em class=ct>must</em> also implement
    it on objects implementing <code>HTMLMetaElement</code> if the
    <code>Link</code> HTTP header is supported. UAs supporting the
-   <code>xml-stylesheet</code> processing instruction <em class=ct>must</em>
-   implement <code><a href="#linkstyle">LinkStyle</a></code> on objects
-   implementing <code>ProcessingInstruction</code>.
+   <code>&lt;?xml-stylesheet?></code> processing instruction <em
+   class=ct>must</em> implement <code><a
+   href="#linkstyle">LinkStyle</a></code> on objects implementing
+   <code>ProcessingInstruction</code>.
 
   <p>Specifications introducing new ways of associating style sheets through
    the DOM <em class=ct>should</em> indicate which objects implement the
@@ -766,7 +774,7 @@ <h3 id=the-documentstyle><span class=secno>2.2. </span>The <code><a
   <p>Any object implementing the <code>Document</code> interface <em
    class=ct>must</em> also implement the <code><a
    href="#documentstyle">DocumentStyle</a></code> interface.</p>
-  <!-- https://bugzilla.mozilla.org/show_bug.cgi?id=200930 -->
+  <!-- https://bugzilla.mozilla.org/show_bug.cgi?id=200930 (FIXED) -->
 
   <pre class=idl>interface <dfn id=documentstyle>DocumentStyle</dfn> {
   readonly attribute <a href="#stylesheetlist">StyleSheetList</a>   <a href="#documentstyle-stylesheets">styleSheets</a>;
@@ -829,8 +837,8 @@ <h3 id=the-documentstyle><span class=secno>2.2. </span>The <code><a
 
     <p>From the DOM's perspective, all views have the same <code><a
      href="#documentstyle-selectedStyleSheetSet">selectedStyleSheetSet</a></code>.
-     If a UA supports multiple views with different selected alternate style
-     sheets, then this attribute (and the <code><a
+     If a user agent supports multiple views with different selected
+     alternate style sheets, then this attribute (and the <code><a
      href="#stylesheet">StyleSheet</a></code> interface's
      <code>disabled</code> attribute) <em class=ct>must</em> return and set
      the value for the default view.</p>
@@ -931,24 +939,27 @@ <h3 id=the-stylesheetlist><span class=secno>2.3. </span>The <code><a
    <dt><dfn id=stylesheetlist-length><code>length</code></dfn>, of type
     <code>unsigned long</code>, readonly
 
-   <dd>This attribute <em class=ct>must</em> be the number of style sheets in
-    the list.
+   <dd>This attribute <em class=ct>must</em> be the number of style sheets
+    currently in the list.
 
    <dt><dfn id=stylesheetlist-item><code>item(<var>index</var>)</code></dfn>,
     method
 
    <dd>When invoked, this method <em class=ct>must</em> return the <code><a
     href="#stylesheet">StyleSheet</a></code> in the list given by
-    <var>index</var>. When there is no such <code><a
-    href="#stylesheet">StyleSheet</a></code> it <em class=ct>must</em> return
-    <code>null</code>.
+    <var>index</var>. If <var>index</var> is less than zero then this method
+    <em class=ct>must</em> raise an <code>INDEX_SIZE_ERR</code> exception. If
+    <var>index</var> is greater than or equal to the number of style sheets
+    currently in the list this method <em class=ct>must</em> return
+    <code>null</code>.</dd>
+   <!-- Internet Explorer throws an exception for [largevalue] as well. -->
   </dl>
 
   <h3 id=dynamically><span class=secno>2.4. </span>Dynamically adding new
    style sheets</h3>
 
   <p>If new style sheets <a href="#style-sheet-title" title="have a
-   title">with titles</a> are added to the document, the UA <em
+   title">with titles</a> are added to the document, the user agent <em
    class=ct>must</em> decide whether or not the style sheets should be
    initially enabled or not. How this happens depends on the exact state of
    the document at the time the style sheet is added, as follows.
@@ -964,8 +975,7 @@ <h4 id=adding><span class=secno>2.4.1. </span>Adding style sheets</h4>
    href="#documentstyle-preferredStyleSheetSet">preferredStyleSheetSet</a></code>
    attribute is set to the exact value of this style sheet's title. (This
    changes the preferred style sheet set, which causes further changes
-   &mdash; see below.)</p>
-  <!-- XXX: use a real character instead? -->
+   &mdash; see below.)
 
   <p>Then, for all sheets, if any of the following is true, then the style
    sheet <em class=ct>must</em> be <a href="#enabled" title="enabled style
@@ -1004,10 +1014,10 @@ <h4 id=changing><span class=secno>2.4.2. </span>Changing the preferred
    href="#documentstyle-lastStyleSheetSet">lastStyleSheetSet</a></code>
    attribute.
 
-  <p>If the UA has the preferred style sheet set changed, for example if it
-   receives a <code>Default-Style</code> HTTP header after it receives HTTP
-   <code>Link</code> headers implying another preferred style sheet, then the
-   <code><a
+  <p>If the user agent has the preferred style sheet set changed, for example
+   if it receives a <code>Default-Style</code> HTTP header after it receives
+   HTTP <code>Link</code> headers implying another preferred style sheet,
+   then the <code><a
    href="#documentstyle-preferredStyleSheetSet">preferredStyleSheetSet</a></code>
    attribute's value <em class=ct>must</em> be changed appropriately, and, if
    the <code><a
@@ -1138,9 +1148,8 @@ <h3 id=forward><span class=secno>2.6. </span>Forward compatibility</h3>
   <h3 id=the-stylesheet><span class=secno>2.7. </span>The <code><a
    href="#stylesheet">StyleSheet</a></code> Interface</h3>
 
-  <p>Each style sheet has some basic information associated with it. The
-   <code><a href="#stylesheet">StyleSheet</a></code> interface provides
-   access to that information.
+  <p>Each style sheet is represented by a <code><a
+   href="#stylesheet">StyleSheet</a></code> object.
 
   <pre class=idl>interface <dfn id=stylesheet>StyleSheet</dfn> {
   readonly attribute DOMString        <a href="#stylesheet-type" title=stylesheet-type>type</a>;
@@ -1172,7 +1181,7 @@ <h3 id=the-stylesheet><span class=secno>2.7. </span>The <code><a
      title="enabled style sheet">enabled</a>.</p>
 
     <p>On getting, this attribute <em class=ct>must</em> be <code>true</code>
-     when the style sheet is enabled and <code>false</code> otherwise.</p>
+     when the style sheet is disabled and <code>false</code> otherwise.</p>
 
     <p>On setting, a value of <code>true</code> <em class=ct>must</em>
      disable the style sheet and a value of <code>false</code> enables it.</p>
@@ -2204,6 +2213,7 @@ <h5 id=determining><span class=secno>4.2.2.1. </span>Determining <code><a
   <h5 id=offsetleft><span class=secno>4.2.2.2. </span><code><a
    href="#offsetleft0">offsetLeft</a></code> and <code><a
    href="#offsetright">offsetRight</a></code></h5>
+  <!--XXX add something about the assumption that nothing is scrolled here?-->
 
   <p>The <dfn id=offsetleft0><code>offsetLeft</code></dfn> attribute of
    <code>Element</code> node <var>A</var> <em class=ct>must</em> be the
@@ -2326,6 +2336,8 @@ <h2 class=no-num id=acknowledgements>Acknowledgements</h2>
 
    <li>Björn Höhrmann
 
+   <li>David Baron
+
    <li>Hallvord R. M. Steen
 
    <li>Ian Hickson
@@ -2342,6 +2354,9 @@ <h2 class=no-num id=acknowledgements>Acknowledgements</h2>
 
    <li>Tarquin Wilton-Jones
   </ul>
+  <!-- An additional thank you to Ian Hickson for writing the initial version
+  of the alternate style sheets API, canonicalization rules and proposals for
+  "author-friendly" interfaces. -->
 
   <p>Also many thanks to the Windows Internet Explorer team for first
    shipping many of the features introduced on <code><a