[css-text] Various clarifications for <http://lists.w3.org/Archives/Public/www-style/2013Nov/0116.html>

--HG--
extra : rebase_source : 15ac58ad3272cca15ab51490991973a8adf4463b

Author: fantasai

css-text/Overview.html

@@ -294,8 +294,8 @@ <h2 class="no-num no-toc" id=contents> Table of Contents</h2>
 
      <li><a href="#overflow-wrap-property"><span class=secno>6.2. </span>
       Overflow Wrapping: the ‘<code
-      class=property>word-wrap</code>’/‘<code
-      class=property>overflow-wrap</code>’ property</a>
+      class=property>overflow-wrap</code>’/‘<code
+      class=property>word-wrap</code>’ property</a>
     </ul>
 
    <li><a href="#justification"><span class=secno>7. </span> Alignment and
@@ -1724,7 +1724,7 @@ <h3 id=hyphens-property><span class=secno>6.1. </span>Hyphenation Control:
    <dd>Words may be broken at appropriate hyphenation points either as
     determined by hyphenation characters inside the word or as determined
     automatically by a language-appropriate hyphenation resource. Conditional
-    hyphenation characters inside a word, if present, take priority over
+    hyphenation characters inside a word, if present, suppress the use of
     automatic resources when determining hyphenation opportunities within the
     word.
   </dl>
@@ -1746,9 +1746,9 @@ <h3 id=hyphens-property><span class=secno>6.1. </span>Hyphenation Control:
   </div>
 
   <h3 id=overflow-wrap-property><span class=secno>6.2. </span> Overflow
-   Wrapping: the ‘<a href="#word-wrap"><code
-   class=property>word-wrap</code></a>’/‘<a href="#overflow-wrap"><code
-   class=property>overflow-wrap</code></a>’ property</h3>
+   Wrapping: the ‘<a href="#overflow-wrap"><code
+   class=property>overflow-wrap</code></a>’/‘<a href="#word-wrap"><code
+   class=property>word-wrap</code></a>’ property</h3>
 
   <table class=propdef>
    <tbody>
@@ -1826,7 +1826,7 @@ <h3 id=overflow-wrap-property><span class=secno>6.2. </span> Overflow
    <dd>An unbreakable "word" may be broken at an arbitrary point if there are
     no otherwise-acceptable break points in the line. Shaping characters are
     still shaped as if the word were not broken, and grapheme clusters must
-    together stay as one unit. No hyphenation character is inserted at the
+    stay together as one unit. No hyphenation character is inserted at the
     break point.
   </dl>
 
@@ -2388,12 +2388,13 @@ <h4 id=justify-algos><span class=secno>7.3.5. </span> Possible Algorithms</h4>
     word spaces first, expanding between letters only if the spaces between
     words hit a limit defined by the UA.
 
-   <p>A more sophisticated but slower justification algorithm might use a
-    Knuth/Plass method where <a href="#expansion-opportunity"><i>expansion
-    opportunities</i></a> and limits were assigned weights and assessed with
-    other line breaking considerations. This algorithm could follow the
-    guidelines by giving more weight to <a href="#word-separator"><i>word
-    separators</i></a> than letter spacing.
+   <p>A more sophisticated but harder-to-implement justification algorithm
+    might use a Knuth/Plass method where <a
+    href="#expansion-opportunity"><i>expansion opportunities</i></a> and
+    limits were assigned weights and assessed with other line breaking
+    considerations. This algorithm could follow the guidelines by giving more
+    weight to <a href="#word-separator"><i>word separators</i></a> than
+    letter spacing.
   </div>
 
   <div class=example>
@@ -2517,8 +2518,7 @@ <h3 id=word-spacing-property><span class=secno>8.1. </span> Word Spacing:
     class=css>&lt;length&gt;</code>’</dfn>
 
    <dd>Specifies extra spacing <em>in addition to</em> the intrinsic
-    inter-word spacing defined by the font. Values may be negative, but there
-    may be implementation-dependent limits.
+    inter-word spacing defined by the font.
 
    <dt><dfn id=percentage
     title="&lt;percentage&gt;!!word-spacing">‘<code
@@ -2532,7 +2532,8 @@ <h3 id=word-spacing-property><span class=secno>8.1. </span> Word Spacing:
    separator</i></a> left in the text after the <a
    href="#white-space-rules">white space processing rules</a> have been
    applied, and should be applied half on each side of the character unless
-   otherwise dictated by typographic tradition.
+   otherwise dictated by typographic tradition. Values may be negative, but
+   there may be implementation-dependent limits.
 
   <div class=example>
    <p>The following example will make all the spaces between words in Arabic
@@ -2550,15 +2551,16 @@ <h3 id=word-spacing-property><span class=secno>8.1. </span> Word Spacing:
 
   <p><dfn id=word-separator
    title="word-separator character | word separator">Word-separator
-   characters</dfn> include the space (U+0020), the no-break space (U+00A0),
-   the Ethiopic word space (U+1361), the Aegean word separators
-   (U+10100,U+10101), the Ugaritic word divider (U+1039F), and the Phoenician
-   Word Separator (U+1091F). If there are no word-separator characters, or if
-   a word-separating character has a zero advance width (such as the zero
-   width space U+200B) then the user agent must not create an additional
-   spacing between words. General punctuation and fixed-width spaces (such as
-   U+3000 and U+2000 through U+200A) are not considered word-separator
-   characters.
+   characters</dfn> are <a href="#character"><i>characters</i></a> whose
+   purpose and general usage is to separate words. In [UNICODE] this includes
+   the space (U+0020), the no-break space (U+00A0), the Ethiopic word space
+   (U+1361), the Aegean word separators (U+10100,U+10101), the Ugaritic word
+   divider (U+1039F), and the Phoenician Word Separator (U+1091F). If there
+   are no word-separator characters, or if a word-separating character has a
+   zero advance width (such as the zero width space U+200B) then the user
+   agent must not create an additional spacing between words. General
+   punctuation and fixed-width spaces (such as U+3000 and U+2000 through
+   U+200A) are not considered word-separator characters.
 
   <h3 id=letter-spacing-property><span class=secno>8.2. </span> Tracking: the
    ‘<a href="#letter-spacing"><code
@@ -2741,8 +2743,9 @@ <h3 id=letter-spacing-property><span class=secno>8.2. </span> Tracking: the
     class=color-box>א</span> ב ג
   </div>
 
-  <p>Letter-spacing ignores zero-width characters (such as those from the
-   Unicode Cf category).
+  <p>Letter-spacing ignores invisible zero-width formatting characters (such
+   as those from the Unicode Cf category). Spacing must be added as if those
+   characters did not exist in the document.
 
   <p class=example>For example, ‘<a href="#letter-spacing"><code
    class=property>letter-spacing</code></a>’ applied to
@@ -2843,13 +2846,16 @@ <h3 id=text-indent-property><span class=secno>9.1. </span> First Line
 
   <p>This property specifies the indentation applied to lines of inline
    content in a block. The indent is treated as a margin applied to the start
-   edge of the line box. Unless otherwise specified via the ‘<code
-   class=css>each-line</code>’ and/or ‘<code class=css>hanging</code>’
-   keywords, only lines that are the <a
+   edge of the line box.
+
+  <p>Unless otherwise specified by the ‘<code class=css>each-line</code>’
+   and/or ‘<code class=css>hanging</code>’ keywords, only lines that are
+   the <a
    href="http://www.w3.org/TR/CSS21/selector.html#first-line-pseudo">first
-   formatted line</a> of an element are affected. For example, the first line
-   of an anonymous block box is only affected if it is the first child of its
-   parent element.
+   formatted line</a> <a href="#ref-CSS21"
+   rel=biblioentry>[CSS21]<!--{{!CSS21}}--></a> of an element are affected.
+   For example, the first line of an anonymous block box is only affected if
+   it is the first child of its parent element.
 
   <p>Values have the following meanings:
 
@@ -2868,10 +2874,10 @@ <h3 id=text-indent-property><span class=secno>9.1. </span> First Line
    <dt><dfn id=each-line title="each-line!!text-indent">‘<code
     class=css>each-line</code>’</dfn>
 
-   <dd>Indentation affects the first line of the block container as well as
-    each line after a <a href="#forced-line-break"><i>forced line
-    break</i></a>, but does not affect lines after a <a
-    href="#soft-wrap-break"><i>soft wrap break</i></a>.
+   <dd>Indentation affects the first line of each block container and each
+    line after a <a href="#forced-line-break"><i>forced line break</i></a>
+    (but not lines after a <a href="#soft-wrap-break"><i>soft wrap
+    break</i></a>).
 
    <dt><dfn id=hanging title="hanging!!text-indent">‘<code
     class=css>hanging</code>’</dfn>
@@ -2949,7 +2955,7 @@ <h3 id=hanging-punctuation-property><span class=secno>9.2. </span> Hanging
      <td>as specified
 
     <tr>
-     <th>Animatable:>
+     <th>Animatable:
 
      <td>no
 
@@ -3293,16 +3299,16 @@ <h2 class=no-num id=order>Appendix A: Text Processing Order of Operations</h2>
 
      <li><a href="#white-space-phase-2">white space processing</a> part II
 
-     <li>‘<a href="#letter-spacing"><code
-      class=property>letter-spacing</code></a>’ and ‘<a
-      href="#word-spacing"><code class=property>word-spacing</code></a>’
-
      <li><a href="http://www.w3.org/TR/css3-fonts/">font/glyph selection and
       positioning</a> <a href="#ref-CSS21"
       rel=biblioentry>[CSS21]<!--{{!CSS21}}--></a> / <a
       href="#ref-CSS3-FONTS"
       rel=biblioentry>[CSS3-FONTS]<!--{{!CSS3-FONTS}}--></a>
 
+     <li>‘<a href="#letter-spacing"><code
+      class=property>letter-spacing</code></a>’ and ‘<a
+      href="#word-spacing"><code class=property>word-spacing</code></a>’
+
      <li><a href="#hanging-punctuation">hanging punctuation</a>
     </ol>
 
@@ -3315,7 +3321,8 @@ <h2 class=no-num id=order>Appendix A: Text Processing Order of Operations</h2>
   <h2 class=no-num id=default-stylesheet> Appendix B: Default UA Stylesheet</h2>
 
   <p>This appendix is informative, and is to help UA developers to implement
-   default stylesheet, but UA developers are free to ignore or change.
+   a default stylesheet for HTML, but UA developers are free to ignore or
+   modify as appropriate.
 
   <div class=example>
    <pre>

css-text/Overview.src.html

@@ -1214,8 +1214,8 @@ <h3 id="hyphens-property">Hyphenation Control: the 'hyphens' property</h3>
           as determined by hyphenation characters inside the word or
           as determined automatically by a language-appropriate hyphenation resource.
           Conditional hyphenation characters inside a word, if present,
-          take priority over automatic resources when determining
-          hyphenation opportunities within the word.
+          suppress the use of automatic resources
+          when determining hyphenation opportunities within the word.
     </dl>
 
     <p>Correct automatic hyphenation requires a hyphenation resource
@@ -1237,7 +1237,7 @@ <h3 id="hyphens-property">Hyphenation Control: the 'hyphens' property</h3>
 
 
   <h3 id="overflow-wrap-property">
-    Overflow Wrapping: the 'word-wrap'/'overflow-wrap' property</h3>
+    Overflow Wrapping: the 'overflow-wrap'/'word-wrap' property</h3>
 
     <table class="propdef">
         <tr>
@@ -1294,7 +1294,7 @@ <h3 id="overflow-wrap-property">
     <dd>An unbreakable "word" may be broken at an arbitrary point if
       there are no otherwise-acceptable break points in the line.
       Shaping characters are still shaped as if the word were not
-      broken, and grapheme clusters must together stay as one unit.
+      broken, and grapheme clusters must stay together as one unit.
       No hyphenation character is inserted at the break point.
     </dl>
 
@@ -1708,7 +1708,7 @@ <h4 id="justify-algos">
     This algorithm could follow the guidelines by expanding word spaces first,
     expanding between letters only if the spaces between words hit a limit defined by the UA.
 
-    <p>A more sophisticated but slower justification algorithm
+    <p>A more sophisticated but harder-to-implement justification algorithm
     might use a Knuth/Plass method
     where <i>expansion opportunities</i> and limits were assigned weights
     and assessed with other line breaking considerations.
@@ -1805,7 +1805,6 @@ <h3 id="word-spacing-property">
     <dt><dfn title="&lt;length&gt;!!word-spacing">''&lt;length&gt;''</dfn>
       <dd>Specifies extra spacing <em>in addition to</em>
         the intrinsic inter-word spacing defined by the font.
-        Values may be negative, but there may be implementation-dependent limits.
     <dt><dfn title="&lt;percentage&gt;!!word-spacing">''&lt;percentage&gt;''</dfn>
       <dd>Specifies the additional spacing as a percentage of the affected
         character's <i>advance measure</i>.
@@ -1815,6 +1814,7 @@ <h3 id="word-spacing-property">
     left in the text after the <a href="#white-space-rules">white space processing rules</a> have been applied,
     and should be applied half on each side of the character
     unless otherwise dictated by typographic tradition.
+    Values may be negative, but there may be implementation-dependent limits.      
 
   <div class="example">
     <p>The following example will make all the spaces between words in Arabic
@@ -1828,7 +1828,9 @@ <h3 id="word-spacing-property">
     <pre>p { word-spacing: 0.5ch; }</pre>
   </div>
 
-    <p><dfn id="word-separator" title="word-separator character | word separator">Word-separator characters</dfn> include 
+    <p><dfn id="word-separator" title="word-separator character | word separator">Word-separator characters</dfn>
+      are <i>characters</i> whose purpose and general usage is to separate words.
+      In [UNICODE] this includes
       the space (U+0020), the no-break space (U+00A0), the Ethiopic word space (U+1361),
       the Aegean word separators (U+10100,U+10101), the Ugaritic word divider (U+1039F),
       and the Phoenician Word Separator (U+1091F).
@@ -1984,8 +1986,9 @@ <h3 id="letter-spacing-property">
     <p class="ls-ex">a&emsp;b</span>&emsp;<span class="color-box">c</span>&emsp;<span class="color-box">&#x5d0;</span>&emsp;&#x5d1;&emsp;&#x5d2;</p>
   </div>
 
-    <p>Letter-spacing ignores zero-width characters (such as those from the
-      Unicode Cf category).
+    <p>Letter-spacing ignores invisible zero-width formatting characters
+      (such as those from the Unicode Cf category).
+      Spacing must be added as if those characters did not exist in the document.
 
     <p class="example">For example, 'letter-spacing' applied to
       <code>A&amp;zwsp;B</code> is identical to <code>AB</code>,
@@ -2066,12 +2069,14 @@ <h3 id="text-indent-property">
 
     <p>This property specifies the indentation applied to lines of inline
       content in a block. The indent is treated as a margin applied to
-      the start edge of the line box. Unless otherwise specified via the
-      ''each-line'' and/or ''hanging'' keywords, only lines that are the
-      <a href="http://www.w3.org/TR/CSS21/selector.html#first-line-pseudo">first
-      formatted line</a> of an element are affected. For example, the first line of
-      an anonymous block box is only affected if it is the first child
-      of its parent element.
+      the start edge of the line box.
+
+    <p>Unless otherwise specified by the ''each-line'' and/or ''hanging'' keywords,
+      only lines that are the
+      <a href="http://www.w3.org/TR/CSS21/selector.html#first-line-pseudo">first formatted line</a> [[!CSS21]]
+      of an element are affected.
+      For example, the first line of an anonymous block box is only affected
+      if it is the first child of its parent element.
 
     <p>Values have the following meanings:</p>
 
@@ -2082,9 +2087,9 @@ <h3 id="text-indent-property">
       <dd>Gives the amount of the indent as a percentage of the containing
         block's logical width.</dd>
       <dt><dfn title="each-line!!text-indent">''each-line''</dfn>
-      <dd>Indentation affects the first line of the block container as
-        well as each line after a <i>forced line break</i>,
-        but does not affect lines after a <i>soft wrap break</i>.
+      <dd>Indentation affects the first line of each block container
+        and each line after a <i>forced line break</i>
+        (but not lines after a <i>soft wrap break</i>).
       <dt><dfn title="hanging!!text-indent">''hanging''</dfn>
       <dd>Inverts which lines are affected.</dd>
     </dl>
@@ -2146,7 +2151,7 @@ <h3 id="hanging-punctuation-property">
           <td>as specified</td>
         </tr>
         <tr>
-          <th>Animatable:>
+          <th>Animatable:
           <td>no
         <tr>
           <th>Canonical order:
@@ -2358,8 +2363,8 @@ <h2 class="no-num" id="order">Appendix A:
         <li><a href="#text-indent">indentation</a>
         <li><a href="http://www.w3.org/TR/css3-writing-modes/#text-direction">bidirectional reordering</a> [[!CSS21]] / [[!CSS3-WRITING-MODES]]
         <li><a href="#white-space-phase-2">white space processing</a> part II
-        <li>'letter-spacing' and 'word-spacing'
         <li><a href="http://www.w3.org/TR/css3-fonts/">font/glyph selection and positioning</a> [[!CSS21]] / [[!CSS3-FONTS]]
+        <li>'letter-spacing' and 'word-spacing'
         <li><a href="#hanging-punctuation">hanging punctuation</a>
       </ol>
     <li><a href="#justification">justification</a> (which may affect glyph selection and/or text wrapping, looping back into that step)
@@ -2370,8 +2375,8 @@ <h2 class="no-num" id="default-stylesheet">
 Appendix B: Default UA Stylesheet</h2>
 
   <p>This appendix is informative,
-  and is to help UA developers to implement default stylesheet,
-  but UA developers are free to ignore or change.
+  and is to help UA developers to implement a default stylesheet for HTML,
+  but UA developers are free to ignore or modify as appropriate.
 
   <div class="example">
     <pre>