More hanging-punctuation clarification

Author: fantasai

css3-text/Overview.html

@@ -83,14 +83,14 @@
 
    <h1>CSS Text Level 3</h1>
 
-   <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 31 March 2011</h2>
+   <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 2 April 2011</h2>
 
    <dl>
     <dt>This version:
 
     <dd><a href="http://dev.w3.org/csswg/css3-text/Overview.html">$Date:
-     2011/03/30 07:53:26 $ (CVS $Revision$)</a> <!--
-      <dd><a href="http://www.w3.org/TR/2011/WD-css3-text-20110331/">http://www.w3.org/TR/2011/WD-css3-text-20110331/</a></dd>
+     2011/03/31 19:23:21 $ (CVS $Revision$)</a> <!--
+      <dd><a href="http://www.w3.org/TR/2011/WD-css3-text-20110402/">http://www.w3.org/TR/2011/WD-css3-text-20110402/</a></dd>
     -->
 
 
@@ -2901,6 +2901,10 @@ <h3 id=text-justify><span class=secno>8.3. </span> Justification Method:
 
    <dd>Justification primarily stretches <a href="#cursive-scripts">cursive
     scripts</a> through the use of kashida or other calligraphic elongation.
+    This value is <em>optional</em> for conformance to CSS3 Text. (UAs that
+    do not support cursive elongation must <a
+    href="http://www.w3.org/TR/css-beijing/#partial">treat the value as
+    invalid</a>.)
   </dl>
 
   <p>When justifying text, the user agent takes the remaining space between
@@ -4273,39 +4277,45 @@ <h3 id=hanging-punctuation><span class=secno>10.2. </span> Hanging
 
   <p>This property determines whether a punctuation mark, if one is present,
    may be placed outside the line box (or in the indent) at the start or at
-   the end of a line of text. Values have the following meanings:
+   the end of a line of text.
+
+  <p class=note>Note that if there is not sufficient padding on the block
+   container, hanging punctuation can trigger overflow.
+
+  <p>Values have the following meanings:
 
   <dl>
    <dt><dfn id=first
     title="hanging-punctuation:first"><code>first</code></dfn>
 
    <dd>An opening bracket or quote at the start of the <a
     href="http://www.w3.org/TR/CSS21/selector.html#first-line-pseudo">first
-    formatted line</a> of an element hangs outside the line. This applies to
-    all characters in the Unicode categories Ps, Pf, Pi.
+    formatted line</a> of an element hangs. This applies to all characters in
+    the Unicode categories Ps, Pf, Pi.
 
    <dt><dfn id=force-end0
     title="hanging-punctuation:force-end"><code>force-end</code></dfn>
 
-   <dd>A stop or comma at the end of a line hangs outside the line.
+   <dd>A stop or comma at the end of a line hangs.
 
    <dt><dfn id=allow-end
     title="hanging-punctuation:allow-end"><code>allow-end</code></dfn>
 
-   <dd>A stop or comma at the end of a line hangs outside the line if it does
-    not otherwise fit prior to justification.
+   <dd>A stop or comma at the end of a line hangs if it does not otherwise
+    fit prior to justification.
   </dl>
 
   <p>When a punctuation mark hangs, it is not considered when measuring the
-   line's contents for indentation, alignment, or justification. (The
-   punctuation mark is part of the justified contents; it is just not
-   measured when determining how much the contents need to be expanded or
-   compressed.) Depending on the line's alignment, this can push the mark
-   outside the line box. At most one punctuation character may hang outside
-   each edge of the line.
-
-  <p class=note>Note that if there is not sufficient padding on the block
-   container, hanging punctuation can trigger overflow.
+   line's contents for fit, alignment, or justification. Depending on the
+   line's alignment, this can push the mark outside the line box. At most one
+   punctuation character may hang outside each edge of the line.
+
+  <p class=note>A hanging punctuation mark is still enclosed inside its
+   inline box and participates in text justification: its character advance
+   width is just not measured when determining how much content fits on the
+   line, how much the line's contents need to be expanded or compressed for
+   justification, or how to position the content within the line box for text
+   alignment.
 
   <p>Non-zero start and end borders or padding on an inline box are not
    allowed to hang. This can sometimes prevent a hangable punctuation mark

css3-text/Overview.src.html

@@ -3170,32 +3170,37 @@ <h3 id="hanging-punctuation">
     <p>This property determines whether a punctuation mark, if one is present,
       may be placed outside the line box (or in the indent) at the start
       or at the end of a line of text.
-      Values have the following meanings:</p>
+
+    <p class="note">Note that if there is not sufficient padding on the
+      block container, hanging punctuation can trigger overflow.</p>
+
+    <p>Values have the following meanings:</p>
 
     <dl>
       <dt><dfn title="hanging-punctuation:first"><code>first</code></dfn></dt>
         <dd>An opening bracket or quote at the start of the
           <a href="http://www.w3.org/TR/CSS21/selector.html#first-line-pseudo">first
-          formatted line</a> of an element hangs outside the line.
+          formatted line</a> of an element hangs.
           This applies to all characters in the Unicode categories Ps, Pf, Pi.</dd>
       <dt><dfn title="hanging-punctuation:force-end"><code>force-end</code></dfn></dt>
-        <dd>A stop or comma at the end of a line hangs outside the line.</dd>
+        <dd>A stop or comma at the end of a line hangs.</dd>
       <dt><dfn title="hanging-punctuation:allow-end"><code>allow-end</code></dfn></dt>
-        <dd>A stop or comma at the end of a line hangs outside the line if it
+        <dd>A stop or comma at the end of a line hangs if it
           does not otherwise fit prior to justification.</dd>
     </dl>
 
-    <p>When a punctuation mark hangs, it is not considered when measuring the
-      line's contents for indentation, alignment, or justification. (The
-      punctuation mark is part of the justified contents; it is just not
-      measured when determining how much the contents need to be expanded or
-      compressed.)
+    <p>When a punctuation mark hangs, it is not considered when measuring
+      the line's contents for fit, alignment, or justification.
       Depending on the line's alignment, this can push the mark outside the
       line box. At most one punctuation character may hang outside each edge
       of the line.
 
-    <p class="note">Note that if there is not sufficient padding on the
-      block container, hanging punctuation can trigger overflow.</p>
+    <p class="note">A hanging punctuation mark is still enclosed inside
+      its inline box and participates in text justification: its character
+      advance width is just not measured when determining how much content
+      fits on the line, how much the line's contents need to be expanded
+      or compressed for justification, or how to position the content
+      within the line box for text alignment.
 
     <p>Non-zero start and end borders or padding on an inline box are not
       allowed to hang. This can sometimes prevent a hangable punctuation mark