more tweaks

Author: annevk

cssom/Overview.html

@@ -206,9 +206,7 @@ <h2 class="no-num no-toc" id=toc>Table of Contents</h2>
      <li><a href="#css-declaration-blocks"><span class=secno>7.3 </span>CSS
       Declaration Blocks</a>
       <ul class=toc>
-       <li><a href="#examples-of-the-css-value-serializing-al"><span
-        class=secno>7.3.1 </span>Examples of the CSS Value Serializing
-        Algorithm</a>
+       <li><a href="#examples0"><span class=secno>7.3.1 </span>Examples</a>
 
        <li><a href="#the-cssstyledeclaration-interface"><span
         class=secno>7.3.2 </span>The <code
@@ -293,6 +291,8 @@ <h2 id=conformance><span class=secno>2 </span>Conformance Requirements</h2>
   <h2 id=terminology><span class=secno>3 </span>Terminology</h2>
 
   <p class=XXX> <dfn id=resolve-a-url>resolve a URL</dfn>, <dfn
+   id=case-sensitive>case-sensitive</dfn>, <dfn
+   id=ascii-case-insensitive>ASCII case-insensitive</dfn>, <dfn
    id=url>URL</dfn>, <dfn id=content-type-metadata>Content-Type
    metadata</dfn>, <dfn id=supported-styling-language>supported styling
    language</dfn>, <dfn
@@ -548,8 +548,8 @@ <h3 id=comparing-media-queries><span class=secno>4.3 </span>Comparing Media
 
   <p>To <dfn id=compare-media-queries>compare media queries</dfn>
    <var>m1</var> and <var>m2</var> means to <span title="serializing media
-   query">serialize</span> them both and return true if they are a
-   <span>case-sensitive</span> match and false if they are not.
+   query">serialize</span> them both and return true if they are a <a
+   href="#case-sensitive">case-sensitive</a> match and false if they are not.
 
   <h3 id=the-medialist-interface><span class=secno>4.4 </span>The <code
    title="">MediaList</code> Interface</h3>
@@ -922,13 +922,13 @@ <h3 id=style-sheet-collections><span class=secno>6.2 </span>Style Sheet
      <li>
       <p>The <a href="#last-style-sheet-set-name">last style sheet set
        name</a> is null and the <a href="#style-sheet-title">style sheet
-       title</a> is a <span>case-sensitive</span> match for the <a
-       href="#preferred-style-sheet-set-name">preferred style sheet set
-       name</a>.
+       title</a> is a <a href="#case-sensitive">case-sensitive</a> match for
+       the <a href="#preferred-style-sheet-set-name">preferred style sheet
+       set name</a>.
 
      <li>
-      <p>The <a href="#style-sheet-title">style sheet title</a> is a
-       <span>case-sensitive</span> match for the <a
+      <p>The <a href="#style-sheet-title">style sheet title</a> is a <a
+       href="#case-sensitive">case-sensitive</a> match for the <a
        href="#last-style-sheet-set-name">last style sheet set name</a>.
     </ul>
 
@@ -1019,11 +1019,12 @@ <h3 id=style-sheet-collections><span class=secno>6.2 </span>Style Sheet
      set name</a> to <var title="">name</var>.
 
    <li>
-    <p>If <var title="">name</var> is not a <span>case-sensitive</span> match
-     for <var title="">current</var> and <a
-     href="#last-style-sheet-set-name">last style sheet set name</a> is null
-     <a href="#enable-a-style-sheet-set">enable a style sheet set</a> with
-     name <var title="">new</var>.
+    <p>If <var title="">name</var> is not a <a
+     href="#case-sensitive">case-sensitive</a> match for <var
+     title="">current</var> and <a href="#last-style-sheet-set-name">last
+     style sheet set name</a> is null <a
+     href="#enable-a-style-sheet-set">enable a style sheet set</a> with name
+     <var title="">new</var>.
   </ol>
   <!-- XXX ought to define "applied"
   
@@ -1309,9 +1310,9 @@ <h3 id=style-sheet-association><span class=secno>6.3 </span>Style Sheet
    href="#xml-stylesheet-processing-instruction" title="xml-stylesheet
    processing instruction">xml-stylesheet processing instructions</a> and
    HTTP <code title=http-link>Link</code> headers when the link releation
-   type is an <span>ASCII case-insensitive</span> match for "<code
-   title="">stylesheet</code>" since nobody else was interested in defining
-   this.
+   type is an <a href="#ascii-case-insensitive">ASCII case-insensitive</a>
+   match for "<code title="">stylesheet</code>" since nobody else was
+   interested in defining this.
 
   <p>The editor is in good hope that HTML and SVG will define the appropriate
    processing in their respective specifications, in terms of this
@@ -1378,7 +1379,7 @@ <h4 id=requirements-on-user-agents-implementing><span class=secno>6.3.3
   <ol>
    <li>
     <p>If there is an <code title="">alternate</code> pseudo-attribute whose
-     value is a <span>case-sensitive</span> match for "<code
+     value is a <a href="#case-sensitive">case-sensitive</a> match for "<code
      title="">yes</code>" and there is a <code title="">title</code>
      pseudo-attribute whose value is the empty string terminate these steps.
 
@@ -1450,8 +1451,8 @@ <h4 id=requirements-on-user-agents-implementing><span class=secno>6.3.3
 
      <dd>
       <p>True if the <code title="">alternate</code> pseudo-attribute value
-       is a <span>case-sensitive</span> match for "<code>yes</code>".
-       Otherwise, false.
+       is a <a href="#case-sensitive">case-sensitive</a> match for
+       "<code>yes</code>". Otherwise, false.
     </dl>
   </ol>
 
@@ -1463,9 +1464,9 @@ <h4 id=requirements-on-user-agents-implementing0><span class=secno>6.3.4
   <!-- XXX title* param does not work (how unexpected -->
 
   <p>For each HTTP <code title=http-link>Link</code> header of which one of
-   the link relation types is an <span>ASCII case-insensitive</span> match
-   for "<code title="">stylesheet</code>" these steps <em class=ct>must</em>
-   be run:
+   the link relation types is an <a href="#ascii-case-insensitive">ASCII
+   case-insensitive</a> match for "<code title="">stylesheet</code>" these
+   steps <em class=ct>must</em> be run:
 
   <ol>
    <li>
@@ -1474,9 +1475,10 @@ <h4 id=requirements-on-user-agents-implementing0><span class=secno>6.3.4
      If there are no such parameters it is the empty string.
 
    <li>
-    <p>If one of the (other) link relation types is an <span>ASCII
-     case-insensitive</span> match for "<code title="">alternate</code>" and
-     <var title="">title</var> is the empty string terminate these steps.
+    <p>If one of the (other) link relation types is an <a
+     href="#ascii-case-insensitive">ASCII case-insensitive</a> match for
+     "<code title="">alternate</code>" and <var title="">title</var> is the
+     empty string terminate these steps.
 
    <li>
     <p><a href="#resolve-a-url" title="Resolve a URL">Resolve</a> the
@@ -1537,9 +1539,9 @@ <h4 id=requirements-on-user-agents-implementing0><span class=secno>6.3.4
 
      <dd>
       <p>True if one of the specified link relation type for this HTTP <code
-       title=http-link>Link</code> header is an <span>ASCII
-       case-insensitive</span> match for "<code title="">alternate</code>".
-       Otherwise, false.
+       title=http-link>Link</code> header is an <a
+       href="#ascii-case-insensitive">ASCII case-insensitive</a> match for
+       "<code title="">alternate</code>". Otherwise, false.
     </dl>
   </ol>
 
@@ -2037,21 +2039,16 @@ <h3 id=css-declaration-blocks><span class=secno>7.3 </span>CSS Declaration
   <p class=XXX>To <dfn id=serialize-a-css-declaration-block>serialize a CSS
    declaration block</dfn> ...
 
-  <p>The rules for <dfn id=parsing-a-css-value title="CSS value
-   parsing">parsing a CSS value</dfn> for a given <var
-   title="">property</var> are as given in the following algorithm. The
-   result is either a CSS value or "null" if the operation failed.
+  <p>To <dfn id=parse-a-css-value>parse a CSS value</dfn> for a given <var
+   title="">property</var> means to a parse the given value according to the
+   definition of <var title="">property</var> in the CSS specification. If
+   the given value is <span>ignored</span> return null. Otherwise return the
+   CSS value for the given <var title="">property</var>.
 
-  <ol>
-   <li>Parse the value using the <code>S* expr</code> production in
-    combination with the allowed values for the given <var
-    title="">property</var>. If this fails return "null". Otherwise return
-    the parsed value.
-  </ol>
+  <p>To <dfn id=serialize-a-css-value>serialize a CSS value</dfn> run these
+   steps:
 
-  <p>The rules for <dfn id=serializing-a-css-value title="CSS value
-   serializing">serializing a CSS value</dfn> are as given in the following
-   algorithm:
+  <p class=XXX>This needs some work, obviously.
 
   <ol>
    <li>
@@ -2065,10 +2062,8 @@ <h3 id=css-declaration-blocks><span class=secno>7.3 </span>CSS Declaration
      final units for computed length values.</span>
 
    <li>
-    <p>When a <code>&lt;length></code> of zero is given, then any specified
-     units <em class=ct>must</em> be removed.
-   </li>
-   <!-- apparently "0px" is better for interop -->
+    <p>When a <code>&lt;length></code> of zero is given change it to
+     "<code>0px</code>"
 
    <li>
     <p>A <code>&lt;color></code> value is canonicalized as follows:</p>
@@ -2212,8 +2207,7 @@ <h3 id=css-declaration-blocks><span class=secno>7.3 </span>CSS Declaration
     <p>but the color <code>WINDOWTEXT</code> becomes <code>WindowText</code>.</p>
   </ol>
 
-  <h4 id=examples-of-the-css-value-serializing-al><span class=secno>7.3.1
-   </span>Examples of the CSS Value Serializing Algorithm</h4>
+  <h4 id=examples0><span class=secno>7.3.1 </span>Examples</h4>
 
   <p>The steps above should guarantee that there is no data loss, from a CSS
    point of
@@ -2308,8 +2302,7 @@ <h4 id=the-cssstyledeclaration-interface><span class=secno>7.3.2 </span>The
    setting <code title=cssstyledeclaration-csstext><a
    href="#cssstyledeclaration-csstext">cssText</a></code> would be examples
    of that.</p>
-  <!-- XXX Or do we need to specify this independently for each attribute and
-  method? -->
+  <!-- XXX we should define this in more detail -->
 
   <p class=issue><code><a
    href="#cssstyledeclaration">CSSStyleDeclaration</a></code> can represent
@@ -2318,8 +2311,6 @@ <h4 id=the-cssstyledeclaration-interface><span class=secno>7.3.2 </span>The
    href="#cssstyledeclaration">CSSStyleDeclaration</a></code> objects
    obviously.)
 
-  <p class=issue>This object stringifies to its cssText attribute. Or not?
-
   <pre
    class=idl>interface <dfn id=cssstyledeclaration>CSSStyleDeclaration</dfn> {
            attribute DOMString <a href="#cssstyledeclaration-csstext" title=cssstyledeclaration-csstext>cssText</a>;
@@ -2334,14 +2325,23 @@ <h4 id=the-cssstyledeclaration-interface><span class=secno>7.3.2 </span>The
 };</pre>
 
   <p>The <dfn id=cssstyledeclaration-csstext
-   title=cssstyledeclaration-csstext><code>cssText</code></dfn> attribute, on
-   getting, <span class=issue>...</span>.
+   title=cssstyledeclaration-csstext><code>cssText</code></dfn> attribute <em
+   class=ct>must</em>, on getting, return the result of <a
+   href="#serialize-a-css-declaration-block" title="serialize a CSS
+   declaration block">serializing</a> the object.
+
+  <p>On setting the <code title="">cssText</code> attribute these steps <em
+   class=ct>must</em> be run:
 
-  <p>On setting the <code title="">cssText</code> attribute, user agents <em
-   class=ct>must</em> remove all properties currently set on the object and
-   then parse the given string as the contents of a declaration block and set
-   each property / value pair that is not ignored on the <code><a
-   href="#cssstyledeclaration">CSSStyleDeclaration</a></code> block. [CSS]
+  <ol>
+   <li>
+    <p>Remove the <span>list of associated declarations</span>.
+
+   <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, append it to the <span>list of associated declarations</span>.
+  </ol>
 
   <p>The <dfn id=cssstyledeclaration-getpropertyvalue
    title=cssstyledeclaration-getpropertyvalue><code>getPropertyValue(<var
@@ -2353,13 +2353,14 @@ <h4 id=the-cssstyledeclaration-interface><span class=secno>7.3.2 </span>The
   <p>The <dfn id=cssstyledeclaration-getpropertypriority
    title=cssstyledeclaration-getpropertypriority><code>getPropertyPriority(<var
    title="">property</var>)</code></dfn> method, when invoked, if <var
-   title="">property</var> case-insensitively matches a specified property
-   that has a priority user agents <em class=ct>must</em> return the
-   canonical priority of that property as given in the syntax definition.
-   Otherwise, the empty string <em class=ct>must</em> be returned.
+   title="">property</var> is an <a href="#ascii-case-insensitive">ASCII
+   case-insensitive</a> match for a property that has a priority user agents
+   <em class=ct>must</em> return the canonical priority of that property as
+   given in the syntax definition. Otherwise, the empty string <em
+   class=ct>must</em> be returned.
 
-  <p class=note>For <code>background-color:lime !IMPORTANT</code> the return
-   value would be <code>important</code>.
+  <p class=example>E.g. for <code>background-color:lime !IMPORTANT</code> the
+   return value would be "<code title="">important</code>".
 
   <p>The <dfn id=cssstyledeclaration-removeproperty
    title=cssstyledeclaration-removeproperty><code>removeProperty(<var
@@ -2394,18 +2395,19 @@ <h4 id=the-cssstyledeclaration-interface><span class=secno>7.3.2 </span>The
      <code>null</code> or the empty string abort this algorithm.
 
    <li>
-    <p>If <a href="#parsing-a-css-value" title="CSS value parsing">parsing
-     the <var title="">value</var></a> returns "null" abort this algorithm.</p>
+    <p>If <a href="#parse-a-css-value" title="parse a CSS value">parsing the
+     <var title="">value</var></a> returns null abort this algorithm.</p>
 
-    <p class=note><var title="">value</var> can not include
-     <code>!important</code>.</p>
+    <p class=note><var title="">value</var> can not include "<code
+     title="">!important</code>".</p>
 
    <li>
     <p>Finally, set <var title="">property</var> to <var title="">value</var>
      with priority <var title="">priority</var> when <var
      title="">priority</var> is not <code>null</code> or the empty string.
      Otherwise set <var title="">property</var> to <var title="">value</var>.
   </ol>
+  <!-- XXX WebIDL work -->
 
   <p>The <dfn id=cssstyledeclaration-length
    title=cssstyledeclaration-length><code>length</code></dfn> attribute <em
@@ -2424,6 +2426,12 @@ <h4 id=the-cssstyledeclaration-interface><span class=secno>7.3.2 </span>The
    href="#cssstyledeclaration">CSSStyleDeclaration</a></code> is object is
    associated with or <code>null</code> if it is not associated with a
    <code><a href="#cssrule">CSSrule</a></code> object.</p>
+  <!-- XXX introduce a concept for this instead -->
+
+  <h4 id=the-css2properties-interface><span class=secno>7.3.3 </span>The
+   <code title="">CSS2Properties</code> Interface</h4>
+
+  <p class=XXX>not all browsers expose this interface name, drop it?</p>
   <!--
   <h4>CSS Properties</h4>
 
@@ -2449,11 +2457,6 @@ <h4>CSS Properties</h4>
   for instance.</p>
 -->
 
-  <h4 id=the-css2properties-interface><span class=secno>7.3.3 </span>The
-   <code title="">CSS2Properties</code> Interface</h4>
-
-  <p class=XXX>...
-
   <h2 id=css-property-value-apis><span class=secno>8 </span>CSS Property
    Value APIs</h2>