introduce various terms dbaron suggested for serializing identifiers and strings; fix typos

Author: annevk

cssom/Overview.html

@@ -25,13 +25,13 @@
   <div class=head>
    <h1 id=cssom>CSSOM</h1>
 
-   <h2 class="no-num no-toc" id="">Editor's Draft 17 February 2010</h2>
+   <h2 class="no-num no-toc" id="">Editor's Draft 18 February 2010</h2>
 
    <dl>
     <dt>This Version:
 
     <dd><a
-     href="http://www.w3.org/TR/2010/ED-cssom-20100217/">http://www.w3.org/TR/2010/ED-cssom-20100217/</a>
+     href="http://www.w3.org/TR/2010/ED-cssom-20100218/">http://www.w3.org/TR/2010/ED-cssom-20100218/</a>
 
     <dt>Latest Version:
 
@@ -226,8 +226,8 @@ <h2 class="no-num no-toc" id=toc>Table of Contents</h2>
       </ul>
     </ul>
 
-   <li><a href="#dom-access-to-css-declaraton-blocks"><span class=secno>8.
-    </span>DOM Access to CSS Declaraton Blocks</a>
+   <li><a href="#dom-access-to-css-declaration-blocks"><span class=secno>8.
+    </span>DOM Access to CSS Declaration Blocks</a>
     <ul class=toc>
      <li><a href="#the-elementcssinlinestyle-interface"><span
       class=secno>8.1. </span>The <code>ElementCSSInlineStyle</code>
@@ -3322,31 +3322,8 @@ <h4 id=serializing-css-values><span class=secno>7.4.2. </span>Serializing
    <dt>&lt;identifier>
 
    <dd>
-    <p>All characters that match any of the conditions in the list below are
-     to be represented as a literal "<code>\</code>" (U+005C), followed by
-     the Unicode code point as two hexadecimal digits in the range 0-9 a-f
-     (U+0030 to U+0039 and U+0061 to U+0066), followed by a space (U+0020).
-     All other characters are to be represented literally.</p>
-
-    <p class=note>Since this is only for characters lower than U+0080 the
-     representation as two digits does not cause problems.</p>
-
-    <ul>
-     <li>The character is the first character and is in the range 0-9 (U+0030
-      to U+0039).
-
-     <li>The character is the second character and is in the range 0-9
-      (U+0030 to U+0039) and the first character is a "<code>-</code>"
-      (U+002D).
-
-     <li>The character is the second character and is "<code>-</code>"
-      (U+002D) and the first character is "<code>-</code>" too.
-
-     <li>The character has a code point lower than U+0080 and is not in the
-      ranges 0-9 (U+0030 to U+0039), A-Z (U+0041 to U+005A), or a-z (U+0061
-      to U+007A) and is not "<code>-</code>" (U+002D) or "<code>_</code>"
-      (U+005F).
-    </ul>
+    <p>The identifier <a href="#escape-an-identifier" title="escape an
+     identifier">escaped</a>.
 
    <dt>&lt;integer>
 
@@ -3392,10 +3369,9 @@ <h4 id=serializing-css-values><span class=secno>7.4.2. </span>Serializing
    <dt>&lt;string>
 
    <dd>
-    <p>A literal '<code>"</code>' (U+0022), followed by the string value with
-     '<code>"</code>' (U+0022) characters preceded by a literal
-     "<code>\</code>" (U+005C), followed by a literal '<code>"</code>'
-     (U+0022).
+    <p>A literal '<code>"</code>' (U+0022), followed by the <a
+     href="#escape-a-string" title="escape a string">escaped</a> string
+     value, followed by a literal '<code>"</code>' (U+0022).
 
    <dt>&lt;time>
 
@@ -3406,11 +3382,71 @@ <h4 id=serializing-css-values><span class=secno>7.4.2. </span>Serializing
    <dt>&lt;uri>
 
    <dd>
-    <p>The literal string '<code title="">url("</code>', followed by the
-     <span>absolute URL</span> with '<code>"</code>' (U+0022) characters
-     preceded by a literal "<code>\</code>" (U+005C), followed by the literal
-     string '<code>)"</code>'.
+    <p>The literal string '<code title="">url("</code>', followed by the <a
+     href="#escape-a-string" title="escape a string">escaped</a>
+     <span>absolute URL</span>, followed by the literal string
+     '<code>")</code>'.
   </dl>
+
+  <p>To <dfn id=escape-a-character>escape a character</dfn> means to create a
+   string of "<code>\</code>" (U+005C), followed by the character.
+
+  <p>To <dfn id=escape-a-character-as-code-point>escape a character as code
+   point</dfn> means to create a string of "<code>\</code>" (U+005C),
+   followed by the Unicode code point as the smallest possible number of
+   hexadecimal digits in the range 0-9 a-f (U+0030 to U+0039 and U+0061 to
+   U+0066) to represent the code point in base 16, followed by a space
+   (U+0020).
+
+  <p>To <dfn id=escape-an-identifier>escape an identifier</dfn> means to
+   create a string represented by the concatenation of, for each character of
+   the identifier:
+
+  <ul>
+   <li>If the character is in the range U+0000 to U+001F, the character <a
+    href="#escape-a-character-as-code-point" title="escape a character as
+    code point">escaped as code point</a>.
+
+   <li>If the character is the first character and is in the range 0-9
+    (U+0030 to U+0039), the character <a
+    href="#escape-a-character-as-code-point" title="escape a character as
+    code point">escaped as code point</a>.
+
+   <li>If the character is the second character and is in the range 0-9
+    (U+0030 to U+0039) and the first character is a "<code>-</code>"
+    (U+002D), the character <a href="#escape-a-character-as-code-point"
+    title="escape a character as code point">escaped as code point</a>.
+
+   <li>If the character is the second character and is "<code>-</code>"
+    (U+002D) and the first character is "<code>-</code>" too, the <a
+    href="#escape-a-character" title="escape a character">escaped</a>
+    character.
+
+   <li>If the character is not handled by one of the above rules and is
+    greater than or equal to U+0080, is "<code>-</code>" (U+002D) or
+    "<code>_</code>" (U+005F), or is in one of the ranges 0-9 (U+0030 to
+    U+0039), A-Z (U+0041 to U+005A), or a-z (U+0061 to U+007A), the character
+    itself.
+
+   <li>Otherwise, the <a href="#escape-a-character" title="escape a
+    character">escaped</a> character.
+  </ul>
+
+  <p>To <dfn id=escape-a-string>escape a string</dfn> means to create a
+   string represented by the concatenation of, for each character of the
+   given string:
+
+  <ul>
+   <li>If the character is in the range U+0000 to U+001F, the character <a
+    href="#escape-a-character-as-code-point" title="escape a character as
+    code point">escaped as code point</a>.
+
+   <li>If the character is '<code>"</code>' (U+0022), "<code>'</code>"
+    (U+0027), or '<code>\</code>' (U+005C), the <a href="#escape-a-character"
+    title="escape a character">escaped</a> character.
+
+   <li>Otherwise, the character itself.
+  </ul>
   <!--
   <ol>
    <li><p>Relative lengths (<code>em</code>, <code>ex</code>, <code>px</code>,
@@ -3556,7 +3592,7 @@ <h4 id=serializing-css-values><span class=secno>7.4.2. </span>Serializing
   <h5 id=examples0><span class=secno>7.4.2.1. </span>Examples</h5>
 
   <p>Here are some examples of before and after results on specified values.
-   The before column could be what the author wrote in a stylesheet, while
+   The before column could be what the author wrote in a style sheet, while
    the after column shows what querying the DOM would return.
 
   <div class=example>
@@ -3625,8 +3661,8 @@ <h5 id=examples0><span class=secno>7.4.2.1. </span>Examples</h5>
    </table>
   </div>
 
-  <h2 id=dom-access-to-css-declaraton-blocks><span class=secno>8. </span>DOM
-   Access to CSS Declaraton Blocks</h2>
+  <h2 id=dom-access-to-css-declaration-blocks><span class=secno>8. </span>DOM
+   Access to CSS Declaration Blocks</h2>
 
   <h3 id=the-elementcssinlinestyle-interface><span class=secno>8.1.
    </span>The <code><a
@@ -3670,7 +3706,7 @@ <h2 id=resolved-values><span class=secno>9. </span>Resolved Values</h2>
 
   <p><code><a href="#viewcss-getcomputedstyle">getComputedStyle()</a></code>
    was historically defined to return the "computed value" of an element or
-   psuedo-element. However, the concept of "computed value" changed between
+   pseudo-element. However, the concept of "computed value" changed between
    revisions of CSS while the implementation of <code><a
    href="#viewcss-getcomputedstyle">getComputedStyle()</a></code> had to
    remain the same for compatibility with deployed scripts. To address this

cssom/Overview.src.html

@@ -2530,30 +2530,8 @@ <h4>Serializing CSS Values</h4>
    the literal string "<code>hz</code>".</dd>
 
    <dt>&lt;identifier></dt>
-   <dd>
-    <p>All characters that match any of the conditions in the list below
-    are to be represented as a literal "<code>\</code>" (U+005C), followed
-    by the Unicode code point as two hexadecimal digits in the range 0-9 a-f
-    (U+0030 to U+0039 and U+0061 to U+0066), followed by a space (U+0020).
-    All other characters are to be represented literally.</p>
-    
-    <p class="note">Since this is only for characters lower than U+0080 the
-    representation as two digits does not cause problems.</p>
-    
-    <ul>
-     <li>The character is the first character and is in the range 0-9
-     (U+0030 to U+0039).</li>
-     <li>The character is the second character and is in the range 0-9
-     (U+0030 to U+0039) and the first character is a "<code>-</code>"
-     (U+002D).</li>
-     <li>The character is the second character and is "<code>-</code>"
-     (U+002D) and the first character is "<code>-</code>" too.</li>
-     <li>The character has a code point lower than U+0080 and is not in the
-     ranges 0-9 (U+0030 to U+0039), A-Z (U+0041 to U+005A), or a-z (U+0061
-     to U+007A) and is not "<code>-</code>" (U+002D) or "<code>_</code>"
-     (U+005F).</li>
-    </ul>
-   </dd>
+   <dd><p>The identifier
+   <span title="escape an identifier">escaped</span>.</p></dd>
 
    <dt>&lt;integer></dt>
    <dd><p>A base-ten integer using digits 0-9 (U+0030 to U+0039) in the
@@ -2589,21 +2567,65 @@ <h4>Serializing CSS Values</h4>
    &lt;number> followed by the literal string "<code>dpcm</code>".</dd>
 
    <dt>&lt;string></dt>
-   <dd><p>A literal '<code>"</code>' (U+0022), followed by the string value
-   with '<code>"</code>' (U+0022) characters preceded by a literal
-   "<code>\</code>" (U+005C), followed by a literal '<code>"</code>'
-   (U+0022).</p></dd>
-   
+   <dd><p>A literal '<code>"</code>' (U+0022), followed by the 
+   <span title="escape a string">escaped</span> string value, followed by a
+   literal '<code>"</code>' (U+0022).</p></dd>
+
    <dt>&lt;time></dt>
    <dd><p>The time in seconds serialized as per &lt;number> followed by
    the literal string "<code>s</code>".</dd>
 
    <dt>&lt;uri></dt>
    <dd><p>The literal string '<code title="">url("</code>', followed by the
-   <span>absolute URL</span> with '<code>"</code>' (U+0022) characters
-   preceded by a literal "<code>\</code>" (U+005C), followed by the literal
-   string '<code>)"</code>'.</p></dd>
+   <span title="escape a string">escaped</span> <span>absolute URL</span>,
+   followed by the literal string '<code>")</code>'.</p></dd>
   </dl>
+
+  <p>To <dfn>escape a character</dfn> means to create a string of
+  "<code>\</code>" (U+005C), followed by the character.</p>
+
+  <p>To <dfn>escape a character as code point</dfn> means to create a string
+  of "<code>\</code>" (U+005C), followed by the Unicode code point as the
+  smallest possible number of hexadecimal digits in the range 0-9 a-f
+  (U+0030 to U+0039 and U+0061 to U+0066) to represent the code point in
+  base 16, followed by a space (U+0020).</p>
+
+  <p>To <dfn>escape an identifier</dfn> means to create a string represented
+  by the concatenation of, for each character of the identifier:</p>
+  
+  <ul>
+   <li>If the character is in the range U+0000 to U+001F, the character
+   <span title="escape a character as code point">escaped as code point</span>.</li>
+   <li>If the character is the first character and is in the range 0-9
+   (U+0030 to U+0039), the character
+   <span title="escape a character as code point">escaped as code point</span>.</li>
+   <li>If the character is the second character and is in the range 0-9
+   (U+0030 to U+0039) and the first character is a "<code>-</code>"
+   (U+002D), the character
+   <span title="escape a character as code point">escaped as code point</span>.</li>
+   <li>If the character is the second character and is "<code>-</code>"
+   (U+002D) and the first character is "<code>-</code>" too, the
+   <span title="escape a character">escaped</span> character.</li>
+   <li>If the character is not handled by one of the above rules and is
+   greater than or equal to U+0080, is "<code>-</code>" (U+002D) or
+   "<code>_</code>" (U+005F), or is in one of the ranges 0-9 (U+0030 to
+   U+0039), A-Z (U+0041 to U+005A), or a-z (U+0061 to U+007A), the character
+   itself.</li>
+   <li>Otherwise, the <span title="escape a character">escaped</span>
+   character.</li>
+  </ul>
+
+  <p>To <dfn>escape a string</dfn> means to create a string represented by
+  the concatenation of, for each character of the given string:</p>
+  
+  <ul>
+   <li>If the character is in the range U+0000 to U+001F, the character
+   <span title="escape a character as code point">escaped as code point</span>.</li>
+   <li>If the character is '<code>"</code>' (U+0022), "<code>'</code>"
+   (U+0027), or '<code>\</code>' (U+005C), the
+   <span title="escape a character">escaped</span> character.</li>
+   <li>Otherwise, the character itself.</li>
+  </ul>
 
   <!--
   <ol>
@@ -2750,7 +2772,7 @@ <h4>Serializing CSS Values</h4>
   <h5>Examples</h5>
 
   <p>Here are some examples of before and after results on specified values.
-  The before column could be what the author wrote in a stylesheet, while
+  The before column could be what the author wrote in a style sheet, while
   the after column shows what querying the DOM would return.</p>
 
   <div class="example">
@@ -2775,7 +2797,7 @@ <h5>Examples</h5>
 
 
 
-  <h2>DOM Access to CSS Declaraton Blocks</h2>
+  <h2>DOM Access to CSS Declaration Blocks</h2>
 
   <h3>The <code>ElementCSSInlineStyle</code> Interface</h3>
 
@@ -2823,7 +2845,7 @@ <h3>The <code title="">ViewCSS</code> Interface</h3>
   <h2>Resolved Values</h2>
 
   <p><code>getComputedStyle()</code> was historically defined to return the
-  "computed value" of an element or psuedo-element. However, the concept of
+  "computed value" of an element or pseudo-element. However, the concept of
   "computed value" changed between revisions of CSS while the implementation
   of <code>getComputedStyle()</code> had to remain the same for
   compatibility with deployed scripts. To address this issue this