Add some clarifications to 'text-justify' and 'text-spacing'.

Author: fantasai

css3-text/Overview.html

@@ -35,7 +35,7 @@ <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 19 August 2011</h2>
     <dt>This version:
 
     <dd><a href="http://dev.w3.org/csswg/css3-text/Overview.html">$Date:
-     2011/08/16 22:54:23 $ (CVS $Revision$)</a> <!--
+     2011/08/19 01:01:30 $ (CVS $Revision$)</a> <!--
       <dd><a href="http://www.w3.org/TR/2011/WD-css3-text-20110819/">http://www.w3.org/TR/2011/WD-css3-text-20110819/</a></dd>
     -->
 
@@ -2571,11 +2571,12 @@ <h3 id=text-justify><span class=secno>7.3. </span> Justification Method:
   </table>
 
   <p>This property selects the justification method used when a line's
-   alignment is set to &lsquo;<code class=css>justify</code>&rsquo;. (See
+   alignment is set to &lsquo;<code class=css>justify</code>&rsquo; (see
    &lsquo;<a href="#text-align0"><code
-   class=property>text-align</code></a>&rsquo;.) The property applies to
-   block containers, but the UA may (but is not required to) also support it
-   on inline elements. It takes the following values:
+   class=property>text-align</code></a>&rsquo;), primarily by controlling
+   which scripts' characters are adjusted together or separately. The
+   property applies to block containers, but the UA may (but is not required
+   to) also support it on inline elements. It takes the following values:
 
   <dl>
    <dt><dfn id=auto0 title="text-justify:auto">&lsquo;<code
@@ -2851,8 +2852,13 @@ <h3 id=text-justify><span class=secno>7.3. </span> Justification Method:
    there are traditionally no expansion opportunities between consecutive EM
    DASH U+2014, HORIZONTAL BAR U+2015, HORIZONTAL ELLIPSIS U+2026, or TWO DOT
    LEADER U+2025 characters <a href="#JLREQ"
-   rel=biblioentry>[JLREQ]<!--{{JLREQ}}--></a>; thus a UA may assign these
-   characters to the "never" prioritization level.
+   rel=biblioentry>[JLREQ]<!--{{JLREQ}}--></a>; thus a UA might assign these
+   characters to the "never" prioritization level. As another example,
+   certain fullwidth punctuation characters are considered to contain an
+   expansion opportunity (see &lsquo;<a href="#text-spacing"><code
+   class=property>text-spacing</code></a>&rsquo;). The UA might therefore
+   assign these characters to a higher prioritization level than the
+   opportunities between ideographic characters.
 
   <p id=justify-cursive>For justification of <a
    href="#cursive-scripts0"><i>cursive scripts</i></a>, words may be expanded
@@ -3348,6 +3354,14 @@ <h3 id=text-spacing-prop><span class=secno>8.3. </span> <a
    glyph, then the spacing is determined by the innermost element containing
    that glyph.
 
+  <p class=note>Values other than &lsquo;<code
+   class=css>normal</code>&rsquo;, &lsquo;<code class=css>none</code>&rsquo;,
+   &lsquo;<code class=css>trim-start</code>&rsquo;, &lsquo;<code
+   class=css>trim-end</code>&rsquo;, and &lsquo;<code
+   class=css>space-end</code>&rsquo; are at-risk and may be dropped from this
+   level of CSS. They are defined here currently to help work out a complete
+   design of this feature.
+
   <p>Support for this property is <em>optional</em>. It is strongly
    recommended for UAs that wish to support CJK typography.
 

css3-text/Overview.src.html

@@ -1809,7 +1809,9 @@ <h3 id="text-justify">
     </table>
 
     <p>This property selects the justification method used when a line's
-      alignment is set to ''justify''. (See 'text-align'.)
+      alignment is set to ''justify'' (see 'text-align'), primarily by
+      controlling which scripts' characters are adjusted together or
+      separately.
       The property applies to block containers, but the UA may (but
       is not required to) also support it on inline elements.
       It takes the following values:</p>
@@ -2018,7 +2020,11 @@ <h3 id="text-justify">
       For example, there are traditionally no expansion opportunities
       between consecutive EM DASH U+2014, HORIZONTAL BAR U+2015, HORIZONTAL
       ELLIPSIS U+2026, or TWO DOT LEADER U+2025 characters [[JLREQ]]; thus
-      a UA may assign these characters to the "never" prioritization level.
+      a UA might assign these characters to the "never" prioritization level.
+      As another example, certain fullwidth punctuation characters are
+      considered to contain an expansion opportunity (see 'text-spacing').
+      The UA might therefore assign these characters to a higher prioritization
+      level than the opportunities between ideographic characters.
 
     <p id="justify-cursive">For justification of <i>cursive scripts</i>,
       words may be expanded through kashida elongation or other cursive
@@ -2438,6 +2444,11 @@ <h3 id="text-spacing-prop">
       to a particular glyph, then the spacing is determined by the innermost
       element containing that glyph.
 
+    <p class="note">Values other than ''normal'', ''none'', ''trim-start'',
+      ''trim-end'', and ''space-end'' are at-risk and may be dropped from
+      this level of CSS. They are defined here currently to help work out
+      a complete design of this feature.
+
     <p>Support for this property is <em>optional</em>. It is strongly
       recommended for UAs that wish to support CJK typography.</p>