[css-ruby] Some fixup in the line breaking section

Author: fantasai

css-ruby/Overview.html

@@ -20,7 +20,7 @@
 
   <meta content="CSS Ruby Module Level 1" name=dcterms.title>
   <meta content=text name=dcterms.type>
-  <meta content=2013-07-09 name=dcterms.date>
+  <meta content=2013-07-11 name=dcterms.date>
   <meta content="Elika J. Etemad" name=dcterms.creator>
   <meta content="Koji Ishii" name=dcterms.creator>
   <meta content="Richard Ishida" name=dcterms.creator>
@@ -41,8 +41,8 @@
    <h1 class=p-name>CSS Ruby Module Level 1</h1>
 
    <h2 class="no-num no-toc" id=longstatus-date->Editor's Draft <time
-    class=dt-updated datetime=20130709> 9 July 2013</time>
-    <!-- for HTML4 doctype: <span class="value-title" title="20130709"> 9 July 2013</span></span> --></h2>
+    class=dt-updated datetime=20130711>11 July 2013</time>
+    <!-- for HTML4 doctype: <span class="value-title" title="20130711">11 July 2013</span></span> --></h2>
 
    <dl>
     <dt>This version:
@@ -221,8 +221,15 @@ <h2 class="no-num no-toc" id=contents> Table of Contents</h2>
      <li><a href="#box-style"><span class=secno>2.7. </span> Styling Ruby
       Boxes </a>
 
-     <li><a href="#line-breaking"><span class=secno>2.8. </span> Ruby box and
+     <li><a href="#line-breaks"><span class=secno>2.8. </span> Ruby box and
       line breaking</a>
+      <ul class=toc>
+       <li><a href="#break-between"><span class=secno>2.8.1. </span> Breaking
+        between bases</a>
+
+       <li><a href="#break-within"><span class=secno>2.8.2. </span> Breaking
+        within bases</a>
+      </ul>
 
      <li><a href="#line-height"><span class=secno>2.9. </span> Ruby box and
       line stacking</a>
@@ -857,29 +864,51 @@ <h3 id=box-style><span class=secno>2.7. </span> Styling Ruby Boxes</h3>
    However, the UA is not required to support any of the box properties
    (borders, margins, padding), any of the background properties or outline
    properties, or any other property that illustrates the bounds of the box
-   on <a href="#ruby-base-container-box"><i>ruby base container boxes</i></a>
-   or <a href="#ruby-annotation-container-box"><i>ruby annotation container
-   boxes</i></a>. The UA may implement these boxes simply as abstractions for
-   inheritance and control over the layout of their contents.
+   on <a href="#ruby-base-container-box"><i>ruby base container
+   boxes</i></a>, <a href="#ruby-annotation-container-box"><i>ruby annotation
+   container boxes</i></a>, or <a href="#nested-pairing">ruby-internal
+   <i>ruby container boxes</i></a>. The UA may implement these boxes simply
+   as abstractions for inheritance and control over the layout of their
+   contents.
 
   <p class=issue> Alternatively... use margins to control offsets? Or could
    line-height be adequate? Its centering behavior can be awkward.
 
-  <h3 id=line-breaking><span class=secno>2.8. </span> Ruby box and line
+  <h3 id=line-breaks><span class=secno>2.8. </span> Ruby box and line
    breaking</h3>
 
   <p>When there is not enough space for an entire <a
    href="#ruby-container-box"><i>ruby container</i></a> to fit on the line,
-   the ruby may be broken wherever all levels allow a break. In typical
-   cases, line breaks are forbidden within each <a
-   href="#ruby-base-box"><i>ruby base</i></a> and <a
-   href="#ruby-annotation-box"><i>ruby annotation</i></a>, so the <a
+   the ruby may be broken wherever the base level allows a break. Ruby most
+   often breaks between base-annotation sets, but if the line-breaking rules
+   allow it, can also break within a <a href="#ruby-base-box"><i>ruby
+   base</i></a> (and, in parallel, its associated <i>annotation boxes</i>).
+
+  <p>Whenever ruby breaks across lines, <a
+   href="#ruby-annotation-box"><i>ruby annotations</i></a> must stay with
+   their respective <i>bases</i>. The line <em>must not</em> break between a
+   <a href="#ruby-base-box"><i>ruby base</i></a> and its <i>annotations</i>,
+   even in the case of ‘<code class=css>inter-character</code>’
+   <i>annotations</i>.
+
+  <div class=figure> <img
+   alt="Diagram showing the line breaking opportunity in a &#34;Bopomofo&#34; ruby"
+   src="images/r-break-b.gif">
+   <p class=caption>‘<code class=css>inter-character</code>’ ruby line
+    breaking opportunity
+  </div>
+
+  <h4 id=break-between><span class=secno>2.8.1. </span> Breaking between
+   bases</h4>
+
+  <p>In typical cases, <a href="#ruby-base-box"><i>ruby base boxes</i></a>
+   and <a href="#ruby-annotation-box"><i>ruby annotation boxes</i></a> are
+   styled to forbid internal line wrapping and do not contain forced breaks.
+   (See <a href="#default-stylesheet">Appendix A</a>.) In such cases the <a
    href="#ruby-container-box"><i>ruby container</i></a> can only break
    between adjacent <a href="#ruby-base-box"><i>ruby bases</i></a>, and only
    if no <a href="#ruby-annotation-box"><i>ruby annotations</i></a> span
-   those <a href="#ruby-base-box"><i>ruby bases</i></a>. Whenever ruby breaks
-   across lines, <a href="#ruby-annotation-box"><i>ruby annotations</i></a>
-   <em>must stay with their respective bases. </em>
+   those <a href="#ruby-base-box"><i>ruby bases</i></a>.
 
   <div class=figure>
    <p><img
@@ -892,40 +921,43 @@ <h3 id=line-breaking><span class=secno>2.8. </span> Ruby box and line
   <p>Whether ruby can break between two adjacent <a
    href="#ruby-base-box"><i>ruby bases</i></a> is controlled by normal
    line-breaking rules for the affected text, exactly as if the <a
-   href="#ruby-base-box"><i>ruby bases</i></a> were regular <i>inline</i>
-   boxes.
+   href="#ruby-base-box"><i>ruby bases</i></a> were adjacent <i>inline</i>
+   boxes. (The annotations are ignored when determining soft wrap
+   opportunities for the base level.)
 
   <div class=example>
    <p>For example, if two adjacent ruby bases are “蝴” and “蝶”,
     the line may break between them, because lines are normally allowed to
     break between two Han characters. However, if ‘<code
     class=property>word-break</code>’ is ‘<code
     class=css>keep-all</code>’, that line break is forbidden.
+
+   <pre>&lt;ruby>蝴&lt;rt>hú&lt;/rt>蝶&lt;rt>dié&lt;/rt></pre>
   </div>
 
   <p>Inter-base white space is significant for evaluating line break
    opportunities between <a href="#ruby-base-box"><i>ruby bases</i></a>. As
    with white space between inlines, it collapses when the line breaks there.
+   Similarly, annotation white space is also trimmed at a line break.
 
   <div class=example>
    <p>For example, given the following markup:
 
    <pre>&lt;ruby>&lt;rb>one&lt;/rb> &lt;rb>two&lt;/rb> &lt;rt>1&lt;/rt> &lt;rt>2&lt;/rt>&lt;/ruby></pre>
 
    <p>Due to the space, the line may break between “one” and “two“.
-    If the line breaks there, that space disappears, in accordance with
-    standard CSS white space processing rules. [[CSS3-TEXT]]
+    If the line breaks there, that space—and the space between “1” and
+    “2”—disappears, in accordance with standard CSS white space
+    processing rules. <a href="#CSS3TEXT"
+    rel=biblioentry>[CSS3TEXT]<!--{{CSS3TEXT}}--></a>
   </div>
 
-  <p>The line <em>must not</em> break between a <a
-   href="#ruby-base-box"><i>ruby base</i></a> and its annotations.
+  <h4 id=break-within><span class=secno>2.8.2. </span> Breaking within bases</h4>
 
-  <div class=figure> <img
-   alt="Diagram showing the line breaking opportunity in a &#34;Bopomofo&#34; ruby"
-   src="images/r-break-b.gif">
-   <p class=caption>‘<code class=css>inter-character</code>’ ruby line
-    breaking opportunity
-  </div>
+  <p class=issue>Fill in this section...
+
+  <p>There are no line breaking opportunities within ‘<code
+   class=css>inter-character</code>’ <i>annotations</i>.
 
   <h3 id=line-height><span class=secno>2.9. </span> Ruby box and line
    stacking</h3>

css-ruby/Overview.src.html

@@ -542,24 +542,43 @@ <h3 id="box-style">
 	any of the box properties (borders, margins, padding),
 	any of the background properties or outline properties,
 	or any other property that illustrates the bounds of the box
-	on <i>ruby base container boxes</i> or <i>ruby annotation container boxes</i>.
+	on <i>ruby base container boxes</i>, <i>ruby annotation container boxes</i>,
+	or <a href="#nested-pairing">ruby-internal <i>ruby container boxes</i></a>.
 	The UA may implement these boxes simply as abstractions for inheritance
 	and control over the layout of their contents.
 
 	<p class="issue">
 		Alternatively... use margins to control offsets?
 		Or could line-height be adequate? Its centering behavior can be awkward.
 
-<h3 id="line-breaking">
+<h3 id="line-breaks">
 Ruby box and line breaking</h3>
 
 	<p>When there is not enough space for an entire <i>ruby container</i> to fit on the line,
-	the ruby may be broken wherever all levels allow a break.
-	In typical cases, line breaks are forbidden within each <i>ruby base</i> and <i>ruby annotation</i>,
-	so the <i>ruby container</i> can only break between adjacent <i>ruby bases</i>,
+	the ruby may be broken wherever the base level allows a break.
+	Ruby most often breaks between base-annotation sets,
+	but if the line-breaking rules allow it, can also break within a <i>ruby base</i>
+	(and, in parallel, its associated <i>annotation boxes</i>).
+
+	<p>Whenever ruby breaks across lines, <i>ruby annotations</i> must stay
+	with their respective <i>bases</i>.
+	The line <em>must not</em> break between a <i>ruby base</i> and its <i>annotations</i>,
+	even in the case of ''inter-character'' <i>annotations</i>.
+
+	<div class="figure">
+		<img src="images/r-break-b.gif"
+		     alt='Diagram showing the line breaking opportunity in a "Bopomofo" ruby'>
+		<p class="caption">''inter-character'' ruby line breaking opportunity
+	</div>
+
+<h4 id="break-between">
+Breaking between bases</h4>
+
+	<p>In typical cases, <i>ruby base boxes</i> and <i>ruby annotation boxes</i>
+	are styled to forbid internal line wrapping and do not contain forced breaks.
+	(See <a href="#default-stylesheet">Appendix A</a>.)
+	In such cases the <i>ruby container</i> can only break between adjacent <i>ruby bases</i>,
 	and only if no <i>ruby annotations</i> span those <i>ruby bases</i>.
-	Whenever ruby breaks across lines, <i>ruby annotations</i>
-	<em>must</i> stay with their respective bases.
 
 	<div class="figure">
 		<p><img src="images/r-break-a.gif"
@@ -569,33 +588,35 @@ <h3 id="line-breaking">
 
 	<p>Whether ruby can break between two adjacent <i>ruby bases</i>
 	is controlled by normal line-breaking rules for the affected text,
-	exactly as if the <i>ruby bases</i> were regular <i>inline</i> boxes.
+	exactly as if the <i>ruby bases</i> were adjacent <i>inline</i> boxes.
+	(The annotations are ignored when determining soft wrap opportunities for the base level.)
 
 	<div class="example">
 		<p>For example, if two adjacent ruby bases are “蝴” and “蝶”,
 		the line may break between them,
 		because lines are normally allowed to break between two Han characters.
 		However, if 'word-break' is ''keep-all'', that line break is forbidden.
+		<pre>&lt;ruby>蝴&lt;rt>hú&lt;/rt>蝶&lt;rt>dié&lt;/rt></pre>
 	</div>
 
 	<p>Inter-base white space is significant for evaluating line break opportunities between <i>ruby bases</i>.
 	As with white space between inlines, it collapses when the line breaks there.
+	Similarly, annotation white space is also trimmed at a line break.
 
 	<div class="example">
 		<p>For example, given the following markup:
 		<pre>&lt;ruby>&lt;rb>one&lt;/rb> &lt;rb>two&lt;/rb> &lt;rt>1&lt;/rt> &lt;rt>2&lt;/rt>&lt;/ruby></pre>
 		<p>Due to the space, the line may break between “one” and “two“.
-		If the line breaks there, that space disappears,
-		in accordance with standard CSS white space processing rules. [[CSS3-TEXT]]
+		If the line breaks there, that space&mdash;and the space between “1” and “2”&mdash;disappears,
+		in accordance with standard CSS white space processing rules. [[CSS3TEXT]]
 	</div>
 
-	<p>The line <em>must not</em> break between a <i>ruby base</i> and its annotations.
+<h4 id="break-within">
+Breaking within bases</h4>
 
-	<div class="figure">
-		<img src="images/r-break-b.gif"
-		     alt='Diagram showing the line breaking opportunity in a "Bopomofo" ruby'>
-		<p class="caption">''inter-character'' ruby line breaking opportunity
-	</div>
+	<p class="issue">Fill in this section...
+
+	<p>There are no line breaking opportunities within ''inter-character'' <i>annotations</i>.
 
 <h3 id="line-height">
 Ruby box and line stacking</h3>