add some notes; comment out shorthand properties so they are treated like any other property

Author: annevk

cssom/Overview.html

@@ -3779,11 +3779,14 @@ <h3 id=the-elementcssinlinestyle-interface><span class=secno>6.1.
    href="#elementcssinlinestyle">ElementCSSInlineStyle</a></code> Interface</h3>
 
   <pre
-   class=idl>interface <dfn id=elementcssinlinestyle>ElementCSSInlineStyle</dfn> {
+   class=idl>[NoInterfaceObject] interface <dfn id=elementcssinlinestyle>ElementCSSInlineStyle</dfn> {
   readonly attribute <a href="#cssstyledeclaration">CSSStyleDeclaration</a> <span>style</span>;
 };</pre>
 
-  <p class=XXX>...
+  <p class=XXX>...</p>
+  <!-- XXX
+    how does this interact with the markup attribute
+  -->
 
   <h3 id=extensions-to-the-window-interface><span class=secno>6.2.
    </span>Extensions to the <code title="">Window</code> Interface</h3>
@@ -3801,7 +3804,13 @@ <h3 id=extensions-to-the-window-interface><span class=secno>6.2.
    title=dom-Window-getComputedStyle><code>getComputedStyle(<var
    title="">elt</var>, <var title="">pseudoElt</var>)</code></dfn> method <em
    class=ct>must</em> ...</p>
-  <!-- XXX -->
+  <!-- XXX
+  
+    element not in rendered document
+    element in subtree
+    element moved out of document
+    element moved into document
+   -->
 
   <p class=note>Because of IDL limitations the <code
    title=dom-Window-getComputedStyle><a
@@ -3824,46 +3833,31 @@ <h2 id=resolved-values><span class=secno>7. </span>Resolved Values</h2>
   <p>The <a href="#resolved-value">resolved value</a> for a given property
    can be determined as follows:
 
-  <dl>
+  <dl><!--
+   We want to treat shorthand properties like any other value basically.
+   
    <dt>'<code>background</code>'
-
    <dt>'<code>border</code>'
-
    <dt>'<code>border-collapse</code>'
-
    <dt>'<code>border-color</code>'
-
    <dt>'<code>border-spacing</code>'
-
    <dt>'<code>border-style</code>'
-
    <dt>'<code>border-top</code>'
-
    <dt>'<code>border-right</code>'
-
    <dt>'<code>border-bottom</code>'
-
    <dt>'<code>border-left</code>'
-
    <dt>'<code>border-width</code>'
-
    <dt>'<code>font</code>'
-
    <dt>'<code>list-style</code>'
-
    <dt>'<code>margin</code>'
-
-   <dt>'<code>outline</code>' <!-- overflow is not -->
-
+   <dt>'<code>outline</code>'
+   <!- - overflow is not - ->
    <dt>'<code>padding</code>'
-
    <dt>'<code>pause</code>'
-
    <dd>
-    <p>There is no <a href="#resolved-value">resolved value</a>.</p>
-
-    <p class=XXX>The idea is to treat these like "any other property" because
-     whether a property is a shorthand property changes over time.</p>
+    <p>There is no <span>resolved value</span>.</p>
+   </dd>
+   -->
 
    <dt>'<code>line-height</code>'
 

cssom/Overview.src.html

@@ -2375,13 +2375,15 @@ <h2>DOM Access to CSS Declaration Blocks</h2>
 
   <h3>The <code>ElementCSSInlineStyle</code> Interface</h3>
 
-  <pre class="idl">interface <dfn>ElementCSSInlineStyle</dfn> {
+  <pre class="idl">[NoInterfaceObject] interface <dfn>ElementCSSInlineStyle</dfn> {
   readonly attribute <span>CSSStyleDeclaration</span> <span>style</span>;
 };</pre>
 
   <p class="XXX">...</p>
 
-
+  <!-- XXX
+    how does this interact with the markup attribute
+  -->
 
 
 
@@ -2401,7 +2403,13 @@ <h3>Extensions to the <code title="">Window</code> Interface</h3>
   <dfn id="dom-window-getcomputedstyle" title="dom-Window-getComputedStyle"><code>getComputedStyle(<var title="">elt</var>, <var title="">pseudoElt</var>)</code></dfn>
   method <em class="ct">must</em> ...</p>
 
-  <!-- XXX -->
+  <!-- XXX
+  
+    element not in rendered document
+    element in subtree
+    element moved out of document
+    element moved into document
+   -->
 
   <p class="note">Because of IDL limitations the
   <code title="dom-Window-getComputedStyle">getComputedStyle()</code> method
@@ -2424,6 +2432,9 @@ <h2>Resolved Values</h2>
   as follows:</p>
 
   <dl>
+   <!--
+   We want to treat shorthand properties like any other value basically.
+   
    <dt>'<code>background</code>'
    <dt>'<code>border</code>'
    <dt>'<code>border-collapse</code>'
@@ -2439,15 +2450,13 @@ <h2>Resolved Values</h2>
    <dt>'<code>list-style</code>'
    <dt>'<code>margin</code>'
    <dt>'<code>outline</code>'
-   <!-- overflow is not -->
+   <!- - overflow is not - ->
    <dt>'<code>padding</code>'
    <dt>'<code>pause</code>'
    <dd>
     <p>There is no <span>resolved value</span>.</p>
-    <p class="XXX">The idea is to treat these like "any other property"
-    because whether a property is a shorthand property changes over
-    time.</p>
    </dd>
+   -->
 
    <dt>'<code>line-height</code>'</dt>
    <dd><p>The <span>resolved value</span> is the used value.</p></dd>
@@ -2473,6 +2482,8 @@ <h2>Resolved Values</h2>
   </dl>
 
 
+
+
   <h2 id="iana-considerations">IANA Considerations</h2>
 
   <h3><dfn title="http-default-style"><code>Default-Style</code></dfn></h5> 
@@ -2505,6 +2516,8 @@ <h2 class="no-num" id="references">References</h2>
   that state please ask the author whenever a reference is unclear.</p>
 
 
+
+
   <h2 class="no-num" id="acknowledgments">Acknowledgments</h2>
 
   <p>The editor would like to thank