DocumentCSS begone for now; need a better specification first; if we ever add it back that is

Author: annevk

cssom/Overview.html

@@ -218,17 +218,11 @@ <h2 class="no-num no-toc" id=toc>Table of Contents</h2>
      <li><a href="#accessing0"><span class=secno>4.5. </span>Accessing
       declaration blocks</a>
       <ul class=toc>
-       <li><a href="#introduction0"><span class=secno>4.5.1.
-        </span>Introduction</a>
-
-       <li><a href="#the-elementcssinlinestyle"><span class=secno>4.5.2.
+       <li><a href="#the-elementcssinlinestyle"><span class=secno>4.5.1.
         </span>The <code>ElementCSSInlineStyle</code> Interface</a>
 
-       <li><a href="#the-viewcss"><span class=secno>4.5.3. </span>The <code
+       <li><a href="#the-viewcss"><span class=secno>4.5.2. </span>The <code
         title="">ViewCSS</code> Interface</a>
-
-       <li><a href="#the-documentcss"><span class=secno>4.5.4. </span>The
-        <code title="">DocumentCSS</code> Interface</a>
       </ul>
 
      <li><a href="#css-declaration-blocks"><span class=secno>4.6. </span>CSS
@@ -505,7 +499,26 @@ <h3 id=media><span class=secno>3.2. </span>Media Queries</h3>
 
   <p>creating a MediaList object?
 
-  <p>parsing and serializing ...
+  <p>The <dfn id=parsing-media-query title="parsing media query">rules for
+   parsing a media query</dfn> for a given string <var>s</var> are to follow
+   the <span>rules for parsing a list of media queries</span> and return the
+   first media query those rules return, or <i>null</i> if <i>null</i> is
+   returned.
+
+  <p>The <dfn id=parsing-media-queries title="parsing media queries">rules
+   for parsing a list of media queries</dfn> ...
+
+  <p>The <dfn id=serializing-media-query title="serializing media
+   query">rules for serializing a media query</dfn>
+
+  <p>The <dfn id=serializing-media-queries title="serializing media
+   queries">rules for serializing a list of media queries</dfn>
+
+  <p>The <dfn id=compare-media-queries title="compare media queries">rules
+   for comparing media queries</dfn> <var>m1</var> and <var>m2</var> are to
+   <a href="#serializing-media-query" title="serializing media
+   query">serialize</a> them both and if they are equal return <i>true</i>
+   and <i>false</i> otherwise.
 
   <h4 id=the-medialist><span class=secno>3.2.1. </span>The <code><a
    href="#medialist">MediaList</a></code> Interface</h4>
@@ -540,11 +553,12 @@ <h4 id=the-medialist><span class=secno>3.2.1. </span>The <code><a
 
   <p>The <dfn id=medialist-mediatext
    title=medialist-mediatext><code>mediaText</code></dfn> attribute, on
-   getting, <em class=ct>must</em> return the results of <span>serializing a
-   list of media queries</span>. On setting, the media queries currently in
-   the collection <em class=ct>must</em> be replaced with the result of
-   <span>parsing a list of media queries</span>.</p>
-  <!-- XXX definitions -->
+   getting, <em class=ct>must</em> return a <a
+   href="#serializing-media-queries" title="serializing media
+   queries">serialization of the media qeuries</a>. On setting, the media
+   queries currently in the collection <em class=ct>must</em> be replaced
+   with the result of <a href="#parsing-media-queries" title="parsing media
+   queries">parsing a list of media queries</a>.
 
   <p>The <dfn id=medialist-length
    title=medialist-length><code>length</code></dfn> attribute, on getting,
@@ -1618,7 +1632,8 @@ <h4 id=the-cssstylerule><span class=secno>4.4.2. </span>The <code
    class=ct>must</em> be used as input for <a href="#selectors-parsing"
    title="selectors parsing">parsing a group of selectors</a> and if that
    returns a non-"null" value that is to be used as a selector for the CSS
-   statement.
+   statement. If it returns "null" setting <em class=ct>must not</em> have an
+   effect.
 
   <p>The <dfn id=cssstylerule-style
    title=cssstylerule-style><code>style</code></dfn> attribute <em
@@ -1643,7 +1658,7 @@ <h4 id=the-cssimportrule><span class=secno>4.4.3. </span>The <code
   <pre
    class=idl>interface <dfn id=cssimportrule>CSSImportRule</dfn> : <a href="#cssrule">CSSRule</a> {
   readonly attribute DOMString <a href="#cssimportrule-href" title=cssimportrule-href>href</a>;
-  readonly attribute <a href="#medialist">MediaList</a> <a href="#cssimportrule-media" title=cssimportrule-media>media</a>;
+  [PutForwards=mediaText] readonly attribute <a href="#medialist">MediaList</a> <a href="#cssimportrule-media" title=cssimportrule-media>media</a>;
   readonly attribute <a href="#cssstylesheet">CSSStyleSheet</a> <a href="#cssimportrule-stylesheet" title=cssimportrule-stylesheet>styleSheet</a>;
 };</pre>
 
@@ -1687,7 +1702,7 @@ <h4 id=the-cssmediarule><span class=secno>4.4.4. </span>The <code
 
   <pre
    class=idl>interface <dfn id=cssmediarule>CSSMediaRule</dfn> : <a href="#cssrule">CSSRule</a> {
-  readonly attribute <a href="#medialist">MediaList</a> <a href="#cssmediarule-media" title=cssmediarule-media>media</a>;
+  [PutForwards=mediaText] readonly attribute <a href="#medialist">MediaList</a> <a href="#cssmediarule-media" title=cssmediarule-media>media</a>;
   readonly attribute <a href="#cssrulelist">CSSRuleList</a> <a href="#cssmediarule-cssrules" title=cssmediarule-cssrules>cssRules</a>;
   unsigned long <a href="#cssmediarule-insertrule" title=cssmediarule-insertrule>insertRule</a>(in DOMString <var>rule</var>, in unsigned long <var>index</var>);
   void <a href="#cssmediarule-deleterule" title=cssmediarule-deleterule>deleteRule</a>(in unsigned long <var>index</var>);
@@ -1776,7 +1791,8 @@ <h4 id=the-csspagerule><span class=secno>4.4.6. </span>The <code
    value <em class=ct>must</em> be used as input for <a
    href="#css-page-selectors-parsing" title="CSS page selectors
    parsing">parsing CSS page selectors</a> and if that returns a non-"null"
-   value that is to be used as a selector for the <code>@page</code> rule.
+   value that is to be used as a selector for the <code>@page</code> rule. If
+   it returns "null" setting <em class=ct>must not</em> have an effect.
 
   <p>The <dfn id=csspagerule-style
    title=csspagerule-style><code>style</code></dfn> attribute, on getting,
@@ -1819,14 +1835,7 @@ <h4 id=the-cssnamespacerule><span class=secno>4.4.7. </span>The <code
   <h3 id=accessing0><span class=secno>4.5. </span>Accessing declaration
    blocks</h3>
 
-  <p>This section provides various way to get to declaration blocks which you
-   can then manipulate.
-
-  <h4 id=introduction0><span class=secno>4.5.1. </span>Introduction</h4>
-
-  <p class=issue>...
-
-  <h4 id=the-elementcssinlinestyle><span class=secno>4.5.2. </span>The
+  <h4 id=the-elementcssinlinestyle><span class=secno>4.5.1. </span>The
    <code><a href="#elementcssinlinestyle">ElementCSSInlineStyle</a></code>
    Interface</h4>
 
@@ -1841,26 +1850,20 @@ <h4 id=the-elementcssinlinestyle><span class=secno>4.5.2. </span>The
 
   <p>The <dfn id=elementcssinlinestyle-currentstyle
    title=elementcssinlinestyle-currentstyle><code>currentStyle</code></dfn>
-   attribute, when called, <em class=ct>must</em> return a <a
-   href="#readonly" title="readonly declaration">readonly
-   <code>CSSStyleDeclaration</code></a> object which represents the computed
-   style for the element on which it was called.
+   attribute, on getting, <em class=ct>must</em> return a <a href="#readonly"
+   title="readonly declaration">readonly <code>CSSStyleDeclaration</code></a>
+   object which represents the computed style for the element on which it was
+   called.
 
   <p class=issue>Serialization of the <code>style</code> attribute is not
    guaranteed to work.
 
-  <h4 id=the-viewcss><span class=secno>4.5.3. </span>The <code
+  <h4 id=the-viewcss><span class=secno>4.5.2. </span>The <code
    title="">ViewCSS</code> Interface</h4>
 
   <p>Objects implementing the <code>Window</code> interface <em
    class=ct>must</em> also implement the <code><a
-   href="#viewcss">ViewCSS</a></code> interface.</p>
-  <!-- XXX wtf!? -->
-
-  <p>Since a computed style is related to an <code>Element</code> node, if
-   this element is removed from the document, the associated <code><a
-   href="#cssstyledeclaration">CSSStyleDeclaration</a></code> is no longer
-   valid.
+   href="#viewcss">ViewCSS</a></code> interface.
 
   <pre class=idl>interface <dfn id=viewcss>ViewCSS</dfn> {
   <a href="#cssstyledeclaration">CSSStyleDeclaration</a> <a href="#viewcss-getcomputedstyle">getComputedStyle</a>(in Element <var title="">elt</var>);
@@ -1875,73 +1878,6 @@ <h4 id=the-viewcss><span class=secno>4.5.3. </span>The <code
    empty string or omitted. Otherwise, for the pseudo-element <var
    title="">pseudoElt</var> of <var title="">elt</var>. [CSS]
 
-  <p>If <var title="">pseudoElt</var> is not a recognized CSS pseudo-element
-   the invocation the method <em class=ct>must</em> return <span
-   class=issue>...</span>.
-
-  <h4 id=the-documentcss><span class=secno>4.5.4. </span>The <code
-   title="">DocumentCSS</code> Interface</h4>
-
-  <p class=issue><code>runtimeStyle</code> is way better than this feature.
-
-  <p>This interface represents a document with a CSS view.</p>
-  <!--
-    so this is how this all comes together:
-
-    UA style sheet
-    User style sheet
-    Author style sheet
-    Override ("temporary") style sheet
-    Author !important styles
-    Override !important styles
-    User !important styles
-
-    on getting you actually don't create an override style sheet you just read
-    the computed style of a certain property. this should be clear.
-
-    that's what runtimeStyle should do more or less. removeAttribute() allows
-    you to remove the current style... removeAttribute is such an ugly name
-
-    currentStyle works sort of like this
-  -->
-
-  <p>The <code><a
-   href="#documentcss-getoverridestyle">getOverrideStyle</a></code> method
-   provides a mechanism through which a DOM author could effect immediate
-   change to the style of an element without modifying the explicitly linked
-   style sheets of a document or the inline style of elements in the style
-   sheets. This style sheet comes after the author style sheet in the cascade
-   algorithm and is called override style sheet. The override style sheet
-   takes precedence over author style sheets. An <code>!important</code>
-   declaration in an author style sheet still takes precedence over a normal
-   declaration in an author style sheet. Override, author and user style
-   sheets may all contain <code>!important</code> declarations. User
-   <code>!important</code> rules take precedence over both override and
-   author <code>!important</code> rules, and override <code>!important</code>
-   rules take precedence over author <code>!important</code> rules.
-
-  <p>The expectation is that an instance of the <code><a
-   href="#documentcss">DocumentCSS</a></code> interface can be obtained by
-   using binding-specific casting methods on an instance of the
-   <code>Document</code> interface.
-
-  <pre
-   class=idl>interface <dfn id=documentcss>DocumentCSS</dfn> : <a href="#documentstyle">DocumentStyle</a> {
-  <a href="#cssstyledeclaration">CSSStyleDeclaration</a> <a href="#documentcss-getoverridestyle">getOverrideStyle</a>(in Element <var>elt</var>, in DOMString <var>pseudoElt</var>);
-};</pre>
-
-  <p>The <dfn
-   id=documentcss-getoverridestyle><code>getOverrideStyle</code></dfn> method
-   <em class=ct>must</em> return the override style declaration for the
-   <code>Element</code> <var>elt</var> (when <var title="">pseudoElt</var> is
-   <code>null</code>) or for the pseudo-element <var>pseudoElt</var> of
-   <code>Element</code> <var title="">elt</var>.
-
-  <p>For language bindings that support optional arguments invoking <code><a
-   href="#documentcss-getoverridestyle">getOverrideStyle</a></code> without
-   the <var>pseudoElt</var> argument <em class=ct>must</em> be identical to
-   invoking the method with that argument being <code>null</code>.
-
   <h3 id=css-declaration-blocks><span class=secno>4.6. </span>CSS Declaration
    Blocks</h3>