Reform hanging-punctuation description.

Author: fantasai

css3-text/Overview.html

@@ -90,7 +90,7 @@ <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 17 January
     <dt>This version:
 
     <dd><a href="http://dev.w3.org/csswg/css3-text/Overview.html">$Date:
-     2011/01/17 03:36:37 $ (CVS $Revision$)</a> <!--<dd><a
+     2011/01/17 03:42:43 $ (CVS $Revision$)</a> <!--<dd><a
       href="http://www.w3.org/TR/2010/WD-css3-text-20101005/">http://www.w3.org/TR/2010/WD-css3-text-20101005/</a></dd> -->
 
 
@@ -3709,34 +3709,53 @@ <h3 id=hanging-punctuation><span class=secno>10.2. </span> Hanging
     title="hanging-punctuation:first"><code>first</code></dfn>
 
    <dd>Punctuation (specifically, opening brackets and quotes) may hang
-    outside the start edge of the first line.
+    outside the start edge of the first line: such punctuation is not
+    considered when measuring the line's contents for indentation, alignment,
+    or justification. This applies to all characters in the Unicode
+    categories Ps, Pf, Pi.
 
    <dt><dfn id=last title="hanging-punctuation:last"><code>last</code></dfn>
 
    <dd>Punctuation (specifically, closing brackets and quotes) may hang
-    outside the end edge of the last line.
+    outside the start edge of the first line: such punctuation is not
+    considered when measuring the line's contents for alignment or
+    justification. This applies to all characters in the Unicode categories
+    Pe, Pf, and Pi as well as the stops and commas listed below.
 
    <dt><dfn id=allow-end
     title="hanging-punctuation:allow-end"><code>allow-end</code></dfn>
 
    <dd>Punctuation (specifically, stops and commas) may hang outside the end
-    edge of all lines if the punctuation does not otherwise fit prior to
-    justification.
+    edge of any line if the punctuation does not otherwise fit prior to
+    justification: such punctuation is not considered when measuring the
+    line's contents for alignment or justification.
 
    <dt><dfn id=force-end0
     title="hanging-punctuation:force-end"><code>force-end</code></dfn>
 
    <dd>Punctuation (specifically, stops and commas) may hang outside the end
-    edge of all lines. If justification is enabled on this line, then it will
-    force the punctuation to hang.
+    edge of any line: such punctuation is not considered when measuring the
+    line's contents for alignment or justification.
   </dl>
 
+  <p>Stops and commas allowed to hang include: U+002C COMMA, U+002E FULL
+   STOP, U+060C ARABIC COMMA, U+06D4 ARABIC FULl STOP, U+3001 IDEOGRAPHIC
+   COMMA, U+3002 IDEOGRAPHIC FULL STOP, U+FF0C FULLWIDTH COMMA, U+FF0E
+   FULLWIDTH FULL STOP, U+FE50 SMALL COMMA, U+FE51 SMALL IDEOGRAPHIC COMMA,
+   U+FE52 SMALL FULL STOP, U+FF61 HALFWIDTH IDEOGRAPHIC FULL STOP, U+FF64
+   HALFWIDTH IDEOGRAPHIC COMMA, The UA may include other characters as
+   appropriate.
+
+  <p class=issue>Should other characters be included?
+
+  <p class=note>The CSS Working Group would appreciate if such UAs would
+   inform the working group of such additional characters.
+
   <p>In all cases only one punctuation character may hang outside the edge of
    the line.
 
-  <p class=issue>Need to work on the description. Add Unicode character
-   classes. Cover indentation as well. Check for Western use-cases. Add
-   <code>hyphens</code> value?
+  <p class=issue>Need to work on the description. Cover indentation as well.
+   Check for Western use-cases. Add <code>hyphens</code> value?
 
   <h2 id=decoration><span class=secno>11. </span> <a
    name=text-decoration>Text Decoration</a></h2>

css3-text/Overview.src.html

@@ -2723,7 +2723,7 @@ <h3 id="hanging-punctuation">
         </tr>
         <tr>
           <th>Applies to:</th>
-          <td>block containers</td>
+          <td>inline elements</td>
         </tr>
         <tr>
           <th>Inherited:</th>
@@ -2745,32 +2745,56 @@ <h3 id="hanging-punctuation">
     </table>
 
     <p>This property determines whether a punctuation mark, if one is present,
-      may be placed outside the line box at the start or at the end of a
-      full line of text.
+      may be placed outside the line box (or in the indent) at the start
+      or at the end of a full line of text. Such hanging punctuation is not
+      considered when measuring the line's contents for indentation, alignment,
+      or justification.
       Values have the following meanings:</p>
 
     <dl>
       <dt><dfn title="hanging-punctuation:first"><code>first</code></dfn></dt>
         <dd>Punctuation (specifically, opening brackets and quotes) may hang
-          outside the start edge of the first line.</dd>
+          outside the start edge of the first line. 
+          This applies to all characters in the Unicode categories Ps, Pf, Pi.</dd>
       <dt><dfn title="hanging-punctuation:last"><code>last</code></dfn></dt>
         <dd>Punctuation (specifically, closing brackets and quotes) may hang
-          outside the end edge of the last line.</dd>
+          outside the start edge of the first line.
+          This applies to all characters in the Unicode categories Pe, Pf, and Pi.</dd>
       <dt><dfn title="hanging-punctuation:allow-end"><code>allow-end</code></dfn></dt>
         <dd>Punctuation (specifically, stops and commas) may hang outside the
-          end edge of all lines if the punctuation does not otherwise fit
+          end edge of any line if the punctuation does not otherwise fit
           prior to justification.</dd>
       <dt><dfn title="hanging-punctuation:force-end"><code>force-end</code></dfn></dt>
         <dd>Punctuation (specifically, stops and commas) may hang outside the
-          end edge of all lines. If justification is enabled on this line, then
-          it will force the punctuation to hang.</dd>
+          end edge of any line.</dd>
     </dl>
 
+    <p>Stops and commas allowed to hang include:
+        U+002C COMMA,
+        U+002E FULL STOP,
+        U+060C ARABIC COMMA,
+        U+06D4 ARABIC FULL STOP,
+        U+3001 IDEOGRAPHIC COMMA,
+        U+3002 IDEOGRAPHIC FULL STOP,
+        U+FF0C FULLWIDTH COMMA,
+        U+FF0E FULLWIDTH FULL STOP,
+        U+FE50 SMALL COMMA,
+        U+FE51 SMALL IDEOGRAPHIC COMMA,
+        U+FE52 SMALL FULL STOP,
+        U+FF61 HALFWIDTH IDEOGRAPHIC FULL STOP,
+        U+FF64 HALFWIDTH IDEOGRAPHIC COMMA.
+       The UA may include other characters as appropriate.
+    <p class="issue">Should other characters be included?</p>
+    <p class="note">The CSS Working Group would appreciate if such UAs would
+      inform the working group of such additional characters.</p>
     <p>In all cases only one punctuation character may hang outside the edge
-      of the line. </p>
+      of the line. Furthermore, start and end borders or padding on an inline
+      element are never allowed to hang.</p>
+
+    <p class="note">Note that if there is not sufficient padding on the
+      block container, hanging punctuation may trigger overflow.</p>
 
-    <p class="issue">Need to work on the description. Add Unicode character classes.
-      Cover indentation as well. Check for Western use-cases. Add <code>hyphens</code> value?</p>
+    <p class="issue">Check for Western use-cases. Add <code>hyphens</code> value?</p>
 
 <h2 id="decoration">
   <a name="text-decoration">Text Decoration</a></h2>