(1) move CSSStyleDeclaration member documentation into IDL;

(2) fix idl makefile deps

Author: skynavga

cssom/Overview.html

@@ -1805,7 +1805,7 @@ <h3 id="css-declaration-blocks"><span class="secno">6.5 </span>CSS Declaration B
 
   <p class="note">The <a href="#css-declaration-block-declarations">CSS declaration block declarations</a> are
   ordered. This matters for the
-  <code title="dom-CSSStyleDeclaration-item"><a href="#dom-cssstyledeclaration-item">item()</a></code> method.</p>
+  <code title="dom-CSSStyleDeclaration-item">item()</code> method.</p>
 
 
   <p class="XXX">To
@@ -1822,7 +1822,7 @@ <h3 id="css-declaration-blocks"><span class="secno">6.5 </span>CSS Declaration B
 
   <h4 id="the-cssstyledeclaration-interface"><span class="secno">6.5.1 </span>The <code>CSSStyleDeclaration</code> Interface</h4>
 
-  
+  <p>The <code>CSSStyleDeclaration</code> interface represents a <a href="#css-declaration-block">CSS declaration block</a>, including its underlying state, where this    underlying state depends upon the source of the <code>CSSStyleDeclaration</code> instance.</p>
 <pre class="idl"><span class="idlInterface" id="widl-def-CSSStyleDeclaration">interface <span class="idlInterfaceID">CSSStyleDeclaration</span> {
 <span class="idlAttribute">    attribute <span class="idlAttrType"><a>DOMString</a></span> <span class="idlAttrName"><a href="#widl-CSSStyleDeclaration-cssText">cssText</a></span>;</span>
 <span class="idlAttribute">    readonly attribute <span class="idlAttrType"><a>unsigned long</a></span> <span class="idlAttrName"><a href="#widl-CSSStyleDeclaration-length">length</a></span>;</span>
@@ -1836,175 +1836,52 @@ <h4 id="the-cssstyledeclaration-interface"><span class="secno">6.5.1 </span>The
 <dl class="attributes">
 <dt class="attribute">
 <code>cssText</code> of type <span class="idlAttrType"><a>DOMString</a></span></dt>
+<dd>
+<p>The <code>cssText</code> attribute must return the result of <a href="#serialize-a-css-declaration-block" title="serialize a CSS declaration block">serializing</a> the    <a href="#css-declaration-block-declarations">CSS declaration block declarations</a>.</p>    <p>Setting the <code>cssText</code> attribute must run these steps:    <ol>      <li><p>If the <a href="#css-declaration-block-readonly-flag">CSS declaration block readonly flag</a> is set, <a class="external" href="http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#concept-throw" title="concept-throw">throw</a> a        <code class="external"><a href="http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#nomodificationallowederror">NoModificationAllowedError</a></code> exception and terminate these steps.</li>      <li><p>Empty the <a href="#css-declaration-block-declarations">CSS declaration block declarations</a>.</li>      <li><p><a href="#parse-a-css-declaration-block" title="Parse a CSS declaration block">Parse</a> the given value and, if the return value is not null, insert it into the        <a href="#css-declaration-block-declarations">CSS declaration block declarations</a>.</li>    </ol></dd>
 <dt class="attribute">
 <code>length</code> of type <span class="idlAttrType"><a>unsigned long</a></span>, readonly</dt>
+<dd>
+<p>The <code>length</code> attribute must return the number of declarations in the <span>collection of CSS declarations</span>.</dd>
 <dt class="attribute">
 <code>parentRule</code> of type <span class="idlAttrType"><a>CSSRule</a></span>, readonly</dt>
+<dd>
+<p>The <code>parentRule</code> attribute must return the <code>CSSrule</code> object the <code>CSSStyleDeclaration</code> is object is associated with    or null if it is not associated with a <code>CSSrule</code> object.</dd>
 </dl>
 <dl class="methods">
 <dt class="method">
 <code>item</code> (<span class="idlParam"><span class="idlParamType"><a>unsigned long</a></span></span>), returns <span class="idlMethType"><a>DOMString</a></span></dt>
+<dd>
+<p>The <code>item</code> operation must return the property at position <var>index</var>.</dd>
 <dt class="method">
 <code>getPropertyValue</code> (<span class="idlParam"><span class="idlParamType"><a>DOMString</a></span></span>), returns <span class="idlMethType"><a>DOMString</a></span></dt>
+<dd>
+<p>The <code>getPropertyValue</code> operation must ...</dd>
 <dt class="method">
 <code>getPropertyPriority</code> (<span class="idlParam"><span class="idlParamType"><a>DOMString</a></span></span>), returns <span class="idlMethType"><a>DOMString</a></span></dt>
+<dd>
+<p>The <code>getPropertyPriority</code> operation, when invoked, if <var>property</var> is an <a class="external" href="http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#ascii-case-insensitive">ASCII case-insensitive</a>    match for a property that has a priority user agents must return the canonical priority of that property as given in the    syntax definition. Otherwise, the empty string must be returned.</p>    <p class="example">E.g. for <code>background-color:lime !IMPORTANT</code> the return value would be '<code>important</code>'.</dd>
 <dt class="method">
 <code>setProperty</code> (<span class="idlParam"><span class="idlParamType"><a>DOMString</a></span></span>, <span class="idlParam"><span class="idlParamType"><a>DOMString</a></span></span>, <span class="idlParam">optional <span class="idlParamType"><a>DOMString</a></span></span>), returns <span class="idlMethType"><a>void</a></span></dt>
+<dd>
+<p>The <code>setProperty</code> operation must run these steps:</p>    <ol>      <li><p>If the <a href="#css-declaration-block-readonly-flag">CSS declaration block readonly flag</a> is set, <a class="external" href="http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#concept-throw" title="concept-throw">throw</a>        an '<code class="external"><a href="http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#nomodificationallowederror">NoModificationAllowedError</a></code>' and terminate these steps.</li>      <li><p>If <var>property</var> is not an <a class="external" href="http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#ascii-case-insensitive">ASCII case-insensitive</a> match for a supported property,        terminate this algorithm.</li>      <li><p>If <var>value</var> is the empty string, invoke <code title="dom-CSSStyleDeclaration-removeProperty">removeProperty()</code>        with <var>property</var> as argument and terminate this algorithm.</li>      <li><p>If the <var>priority</var> argument has been omitted let <var>priority</var> be the empty string.</li>      <li><p>If <var>priority</var> is neither a valid priority nor the empty string terminate this algorithm.</li>      <li>        <p>If <a href="#parse-a-css-value" title="parse a CSS value">parsing the <var>value</var></a> returns null terminate this algorithm.        <p class="note"><var>value</var> can not include '<code>!important</code>'.</p>      </li>      <li><p>Finally, set <var>property</var> to <var>value</var> with priority <var>priority</var> when <var>priority</var>        is not the empty string. Otherwise set <var>property</var> to <var>value</var>.</li>    </ol></dd>
 <dt class="method">
 <code>removeProperty</code> (<span class="idlParam"><span class="idlParamType"><a>DOMString</a></span></span>), returns <span class="idlMethType"><a>DOMString</a></span></dt>
+<dd>
+<p>The <code>removeProperty</code> operation must run these steps:</p>    <ol>     <li><p>If the <a href="#css-declaration-block-readonly-flag">CSS declaration block readonly flag</a> is set, <a class="external" href="http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#concept-throw" title="concept-throw">throw</a> a       '<code class="external"><a href="http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#nomodificationallowederror">NoModificationAllowedError</a></code>' and terminate these steps.</li>     <li><p>If <var>property</var> is an <a class="external" href="http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#ascii-case-insensitive">ASCII case-insensitive</a> match for a property of a declaration in the       <span>collection of CSS declarations</span> remove the declaration.</li>    </ol></dd>
 </dl>
 
 
-  <!--
-  <pre class="idl">interface <dfn>CSSStyleDeclaration</dfn> {
-           attribute DOMString <span title="dom-CSSStyleDeclaration-cssText">cssText</span>;
-
-  readonly attribute unsigned long <span title="dom-CSSStyleDeclaration-length">length</span>;
-  DOMString <span title="dom-CSSStyleDeclaration-item">item</span>(unsigned long <var>index</var>);
-
-  DOMString <span title="dom-CSSStyleDeclaration-getPropertyValue">getPropertyValue</span>(DOMString <var>property</var>);
-  DOMString <span title="dom-CSSStyleDeclaration-getPropertyPriority">getPropertyPriority</span>(DOMString <var>property</var>);
-  void <span title="dom-CSSStyleDeclaration-setProperty">setProperty</span>(DOMString <var>property</var>, DOMString <var>value</var>, optional DOMString <var>priority</var>);
-  DOMString <span title="dom-CSSStyleDeclaration-removeProperty">removeProperty</span>(DOMString <var>property</var>);
-
-  readonly attribute <span>CSSRule</span> <span title="dom-CSSStyleDeclaration-parentRule">parentRule</span>;
-
-  // CSS Properties
-};</pre>
-  -->
-
-  <p>The
-  <dfn id="dom-cssstyledeclaration-csstext" title="dom-CSSStyleDeclaration-cssText"><code>cssText</code></dfn>
-  attribute must return the result of
-  <a href="#serialize-a-css-declaration-block" title="serialize a CSS declaration block">serializing</a> the
-  <a href="#css-declaration-block-declarations">CSS declaration block declarations</a>.</p>
-
-  <p>Setting the <code>cssText</code> attribute must run these steps:
-
-  <ol>
-   <li><p>If the <a href="#css-declaration-block-readonly-flag">CSS declaration block readonly flag</a> is set,
-   <a class="external" href="http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#concept-throw" title="concept-throw">throw</a> a
-   "<code class="external"><a href="http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#nomodificationallowederror">NoModificationAllowedError</a></code>" exception
-   and terminate these steps.</li>
-
-   <li><p>Empty the <a href="#css-declaration-block-declarations">CSS declaration block declarations</a>.</li>
-
-   <li><p><a href="#parse-a-css-declaration-block" title="Parse a CSS declaration block">Parse</a> the given
-   value and, if the return value is not null, insert it into the
-   <a href="#css-declaration-block-declarations">CSS declaration block declarations</a>.</li>
-  </ol>
-
-
-  <!-- XXX WebIDL work -->
-  <p>The
-  <dfn id="dom-cssstyledeclaration-length" title="dom-CSSStyleDeclaration-length"><code>length</code></dfn>
-  attribute must return the number of declarations in
-  the <span>collection of CSS declarations</span>.</p>
-
-  <p>The
-  <dfn id="dom-cssstyledeclaration-item" title="dom-CSSStyleDeclaration-item"><code>item(<var>index</var>)</code></dfn>
-  method must <span class="XXX">...</span>.</p>
-  <!-- returns the name of property at position index. -->
-
-
-  <p>The
-  <dfn id="dom-cssstyledeclaration-getpropertyvalue" title="dom-CSSStyleDeclaration-getPropertyValue"><code>getPropertyValue(<var>property</var>)</code></dfn>
-  method must <span class="XXX">...</span>.</p>
-  <!-- Once we have defined how everything will be canonicalized we can start
-  thinking about this... --><p></p>
-
-  <p>The
-  <dfn id="dom-cssstyledeclaration-getpropertypriority" title="dom-CSSStyleDeclaration-getPropertyPriority"><code>getPropertyPriority(<var>property</var>)</code></dfn>
-  method, when invoked, if <var>property</var> is an
-  <a class="external" href="http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#ascii-case-insensitive">ASCII case-insensitive</a> match for a
-  property that has a priority user agents must return the canonical
-  priority of that property as given in the syntax definition. Otherwise,
-  the empty string must be returned.</p>
-
-  <p class="example">E.g. for <code>background-color:lime !IMPORTANT</code>
-  the return value would be "<code>important</code>".</p>
-
-
-  <p>The
-  <dfn id="dom-cssstyledeclaration-setproperty" title="dom-CSSStyleDeclaration-setProperty"><code>setProperty(<var>property</var>, <var>value</var>, <var>priority</var>)</code></dfn>
-  method must run these steps:
-
-  <ol>
-   <li><p>If the <a href="#css-declaration-block-readonly-flag">CSS declaration block readonly flag</a> is set,
-   <a class="external" href="http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#concept-throw" title="concept-throw">throw</a> an
-   "<code class="external"><a href="http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#nomodificationallowederror">NoModificationAllowedError</a></code>" and
-   terminate these steps.</li>
-
-   <li><p>If <var>property</var> is not an
-   <a class="external" href="http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#ascii-case-insensitive">ASCII case-insensitive</a> match for a
-   supported property, terminate this algorithm.</li>
-
-   <li><p>If <var>value</var> is the empty string, invoke
-   <code title="dom-CSSStyleDeclaration-removeProperty"><a href="#dom-cssstyledeclaration-removeproperty">removeProperty()</a></code>
-   with <var>property</var> as argument and terminate this
-   algorithm.</li>
-
-   <li><p>If the <var>priority</var> argument has been omitted let
-   <var>priority</var> be the empty string.</li>
-
-   <li><p>If <var>priority</var> is neither a valid priority nor
-   the empty string terminate this algorithm.</li>
-   <!-- define valid priority somehow -->
-
-   <li>
-    <p>If <a href="#parse-a-css-value" title="parse a CSS value">parsing the
-    <var>value</var></a> returns null terminate this algorithm.
-
-    <p class="note"><var>value</var> can not include
-    "<code>!important</code>".</p>
-   </li>
-
-   <li><p>Finally, set <var>property</var> to <var>value</var>
-   with priority <var>priority</var> when <var>priority</var>
-   is not the empty string. Otherwise set
-   <var>property</var> to <var>value</var>.</li>
-  </ol>
-
-  <p>The
-  <dfn id="dom-cssstyledeclaration-removeproperty" title="dom-CSSStyleDeclaration-removeProperty"><code>removeProperty(<var>property</var>)</code></dfn>
-  method must run these steps:
-
-  <ol>
-   <li><p>If the <a href="#css-declaration-block-readonly-flag">CSS declaration block readonly flag</a> is set,
-   <a class="external" href="http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#concept-throw" title="concept-throw">throw</a> a
-   "<code class="external"><a href="http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#nomodificationallowederror">NoModificationAllowedError</a></code>" and
-   terminate these steps.</li>
-
-   <li><p>If <var>property</var> is an
-   <a class="external" href="http://dvcs.w3.org/hg/domcore/raw-file/tip/Overview.html#ascii-case-insensitive">ASCII case-insensitive</a> match for a
-   property of a declaration in the
-   <span>collection of CSS declarations</span> remove the declaration.</li>
-  </ol>
-
-
-  <p>The
-  <dfn id="dom-cssstyledeclaration-values" title="dom-CSSStyleDeclaration-values"><code>values</code></dfn>
-  attribute must return <span class="XXX">...</span></p>
-
-
-  <p>The
-  <dfn id="dom-cssstyledeclaration-parentrule" title="dom-CSSStyleDeclaration-parentRule"><code>parentRule</code></dfn>
-  attribute must return the <code>CSSrule</code> object the
-  <code>CSSStyleDeclaration</code> is object is associated with or null if
-  it is not associated with a <code>CSSrule</code> object.</p>
-  <!-- XXX introduce a concept for this instead -->
-
   <hr>
 
   <p>For the table below, the IDL attribute in the first column
   must return the result of invoking
-  <code title="dom-CSSStyleDeclaration-getPropertyValue"><a href="#dom-cssstyledeclaration-getpropertyvalue">getPropertyValue()</a></code>
+  <code title="dom-CSSStyleDeclaration-getPropertyValue">getPropertyValue()</code>
   with as argument the CSS property given in the second column on the same
   row.</p>
 
   <p>Similarly for the table below, setting the IDL attribute in the
   first column must invoke
-  <code title="dom-CSSStyleDeclaration-setProperty"><a href="#dom-cssstyledeclaration-setproperty">setProperty()</a></code>
+  <code title="dom-CSSStyleDeclaration-setProperty">setProperty()</code>
   with as first argument the CSS property given in the second column on the
   same row, as second argument the given value, and no third argument. Any
   exceptions thrown must be re-thrown.</p>