[cssom] Make .style better defined and add [putForwards=cssText] (present in the HTML spec). https://www.w3.org/Bugs/Public/show_bug.cgi?id=21848

Author: Simon Pieters

cssom/Overview.html

@@ -2392,16 +2392,16 @@ <h2 id="dom-access-to-css-declaration-blocks"><span class="secno">7 </span>DOM A
 
   <h3 id="the-elementcssinlinestyle-interface"><span class="secno">7.1 </span>The <code>ElementCSSInlineStyle</code> Interface</h3>
 
-  The <code>ElementCSSInlineStyle</code> interface is implemented by <code>Element</code> objects in order to provide access to inline style properties.
+  <p>The <code>ElementCSSInlineStyle</code> interface provides access to inline style properties of an element.</p>
 <pre class="idl"><span class="idlInterface" id="widl-def-ElementCSSInlineStyle">[NoInterfaceObject]
 interface <span class="idlInterfaceID">ElementCSSInlineStyle</span> {
-<span class="idlAttribute">    readonly attribute <span class="idlAttrType"><a>CSSStyleDeclaration</a></span> <span class="idlAttrName"><a href="#widl-ElementCSSInlineStyle-style">style</a></span>;</span>
+<span class="idlAttribute">    [PutForwards=cssText] readonly attribute <span class="idlAttrType"><a>CSSStyleDeclaration</a></span> <span class="idlAttrName"><a href="#widl-ElementCSSInlineStyle-style">style</a></span>;</span>
 };</span></pre>
 <dl class="attributes">
 <dt class="attribute" id="widl-ElementCSSInlineStyle-style">
 <dfn id="widl-ElementCSSInlineStyle-style"><code>style</code></dfn> of type <span class="idlAttrType"><a>CSSStyleDeclaration</a></span>, readonly</dt>
 <dd>
-The <code><a href="#widl-ElementCSSInlineStyle-style">style</a></code> attribute must return a mutable <code>CSSStyleDeclaration</code> object    that represents the inline style properties of the associated <code>Element</code> instance.</dd>
+<p>The <code><a href="#widl-ElementCSSInlineStyle-style">style</a></code> attribute must return a <a href="#css-declaration-block">CSS declaration block</a> with the    <a href="#css-declaration-block-declarations">CSS declaration block declarations</a> being set to the declarations    specified in the element's <code title="">style</code> content attribute. If the    <code title="">style</code> content attribute is absent, the object represents an empty    declaration. Mutating the <code>CSSStyleDeclaration</code> object must set the    <code title="">style</code> content attribute on the element to the    <a href="#serialize-a-css-declaration-block" title="serialize a CSS declaration block">serialization</a> of the    <code>CSSStyleDeclaration</code>'s <a href="#css-declaration-block-declarations">CSS declaration block declarations</a>.    The same object must be returned each time. The object is be live; if the    <code title="">style</code> content attribute is set, changed or removed, the <a href="#css-declaration-block-declarations">CSS    declaration block declarations</a> must be updated as appropriate.</dd>
 </dl>
 
 

cssom/idl/ElementCSSInlineStyle.idl

@@ -1,13 +1,22 @@
 [NoInterfaceObject,
  Documentation=
- "The {@name} {@type} is implemented by <code>Element</code> objects in order to provide access to inline style properties."
+ "<p>The {@name} {@type} provides access to inline style properties of an element.</p>"
 ]
 interface ElementCSSInlineStyle {
 
   [Documentation=
-   "The {@name} {@type} must return a mutable <code>CSSStyleDeclaration</code> object\
-    that represents the inline style properties of the associated <code>Element</code> instance."
-  ]
-  readonly attribute CSSStyleDeclaration style;
+   "<p>The {@name} {@type} must return a <span>CSS declaration block</span> with the\
+    <span>CSS declaration block declarations</span> being set to the declarations\
+    specified in the element's <code title>style</code> content attribute. If the\
+    <code title>style</code> content attribute is absent, the object represents an empty\
+    declaration. Mutating the <code>CSSStyleDeclaration</code> object must set the\
+    <code title>style</code> content attribute on the element to the\
+    <span title='serialize a CSS declaration block'>serialization</span> of the\
+    <code>CSSStyleDeclaration</code>'s <span>CSS declaration block declarations</span>.\
+    The same object must be returned each time. The object is be live; if the\
+    <code title>style</code> content attribute is set, changed or removed, the <span>CSS\
+    declaration block declarations</span> must be updated as appropriate.</p>"
+  ,
+  PutForwards=cssText] readonly attribute CSSStyleDeclaration style;
 
 };