[css-ruby] Clarifications to white space collapsing section

--HG--
extra : rebase_source : 0ed7ac3e8db94fd86114f9a1a30e0f0c8b79613c

Author: fantasai

css-ruby/Overview.html

@@ -727,29 +727,41 @@ <h3 id=autohide><span class=secno>2.4. </span> Autohiding Annotations</h3>
 
   <h3 id=white-space><span class=secno>2.5. </span> White Space</h3>
 
-  <p class=issue>I'm unsure exactly where space should be trimmed. :/ But
-   pretty sure we need to keep spaces between things, otherwise ruby only
-   works for CJK.
-
-  <p><i>Collapsible</i> white space within a ruby structure is discarded at
-   the beginning and end of a <a href="#ruby-container-box"><i>ruby
-   container</i></a>, <a href="#ruby-annotation-container-box"><i>ruby
-   annotation container</i></a>, or <a
-   href="#ruby-base-container-box"><i>ruby base container</i></a>, and at the
-   beginning/end of a <a href="#ruby-annotation-box"><i>ruby annotation
-   box</i></a> or <a href="#ruby-base-box"><i>ruby base box</i></a> if white
-   space is not its only contents. Between <a href="#ruby-segments"><i>ruby
-   segments</i></a>, between <a href="#ruby-base-box"><i>ruby bases</i></a>,
-   and between <a href="#ruby-annotation-box"><i>ruby annotations</i></a>,
-   however, white space is not discarded. If such white space is
-   <i>collapsible</i>, it will collapse following the standard <a
+  <p><i>Collapsible</i> white space within a ruby structure is discarded
+
+  <ul>
+   <li>at the beginning and end of a <a href="#ruby-container-box"><i>ruby
+    container</i></a>, <a href="#ruby-annotation-container-box"><i>ruby
+    annotation container</i></a>, or <a
+    href="#ruby-base-container-box"><i>ruby base container</i></a>,
+
+   <li>at the beginning/end of a <a href="#ruby-annotation-box"><i>ruby
+    annotation box</i></a> or <a href="#ruby-base-box"><i>ruby base
+    box</i></a> if white space is not its only contents,
+
+   <li>between a <a href="#ruby-base-container-box"><i>ruby base
+    container</i></a> and its following <a
+    href="#ruby-annotation-container-box"><i>ruby annotation
+    container</i></a>,
+
+   <li>between <a href="#ruby-annotation-container-box"><i>ruby annotation
+    containers</i></a>.
+  </ul>
+
+  <p>Between <a href="#ruby-segments"><i>ruby segments</i></a>, between <a
+   href="#ruby-base-box"><i>ruby bases</i></a>, and between <a
+   href="#ruby-annotation-box"><i>ruby annotations</i></a>, however, white
+   space is not discarded.
+
+  <p>Where undiscarded white space is <i>collapsible</i>, it will collapse
+   following the standard <a
    href="http://www.w3.org/TR/css3-text/#white-space-rules">white space
    processing rules</a>. <a href="#CSS3TEXT"
-   rel=biblioentry>[CSS3TEXT]<!--{{!CSS3TEXT}}--></a> Between <a
-   href="#ruby-segments"><i>ruby segments</i></a>, however, the contextual
-   text for determining collapsing behavior is given by the <a
-   href="#ruby-base-box"><i>ruby bases</i></a> on either side, not the text
-   on either side of the white space in the source document.
+   rel=biblioentry>[CSS3TEXT]<!--{{!CSS3TEXT}}--></a> For <i>collapsible</i>
+   white space between <a href="#ruby-segments"><i>ruby segments</i></a>,
+   however, the contextual text for determining collapsing behavior is given
+   by the <a href="#ruby-base-box"><i>ruby bases</i></a> on either side, not
+   the text on either side of the white space in the source document.
 
   <div class=note>
    <p>Note that the white space processing rules cause a white space sequence
@@ -765,12 +777,14 @@ <h3 id=white-space><span class=secno>2.5. </span> White Space</h3>
 <!--		-->  &lt;rt>とう&lt;/rt>&lt;rt>きょう&lt;/rt>
 <!--		-->&lt;/ruby></pre>
 
-   <p>However, this markup will:
+   <p>However, white space that does not contain a <i>segment break</i> does
+    not collapse completely away, so this markup will display with a space
+    between the first and second ruby pairs:
 
    <pre>
 <!--		-->&lt;ruby>
 <!--		-->  &lt;rb>東&lt;/rb>	&lt;rb>京&lt;/rb>
-<!--		-->  &lt;rt>とう&lt;/rt> &lt;rt>きょう&lt;/rt>
+<!--		-->  &lt;rt>とう&lt;/rt>	&lt;rt>きょう&lt;/rt>
 <!--		-->&lt;/ruby></pre>
   </div>
 
@@ -781,10 +795,12 @@ <h3 id=white-space><span class=secno>2.5. </span> White Space</h3>
    (if between <a href="#ruby-annotation-box"><i>ruby annotations</i></a>),
    or <a href="#ruby-container-box"><i>ruby container</i></a> (if between <a
    href="#ruby-segments"><i>ruby segments</i></a>). In the latter case, the
-   text is considered part of the <i>base level</i>. This box does not take
-   part in pairing. It merely ensures separation between adjacent
+   text is considered part of the <i>base level</i>. Such anonynmous boxes do
+   not take part in pairing. They merely ensure separation between adjacent
    bases/annotations.
 
+  <p class=issue>Specify how these anonymous white space boxes impact layout.
+
   <div class=example>
    <p>These rules allow ruby to be used with space-separated scripts such as
     Latin. For example,
@@ -804,8 +820,6 @@ <h3 id=white-space><span class=secno>2.5. </span> White Space</h3>
 <!--		-->&lt;/ruby></pre>
   </div>
 
-  <p class=issue>Specify how this impacts layout, or not.
-
   <h3 id=ruby-layout><span class=secno>2.6. </span> Ruby layout</h3>
 
   <p>When a ruby structure is laid out, its base level is laid out on the

css-ruby/Overview.src.html

@@ -426,18 +426,20 @@ <h3 id="autohide">
 <h3 id="white-space">
 White Space</h3>
 
-	<p class="issue">I'm unsure exactly where space should be trimmed. :/
-	But pretty sure we need to keep spaces between things,
-	otherwise ruby only works for CJK.
-
 	<p><i>Collapsible</i> white space within a ruby structure is discarded
-	at the beginning and end of a <i>ruby container</i>, <i>ruby annotation container</i>, or <i>ruby base container</i>,
-	and at the beginning/end of a <i>ruby annotation box</i> or <i>ruby base box</i> if white space is not its only contents.
-	Between <i>ruby segments</i>, between <i>ruby bases</i>, and between <i>ruby annotations</i>, however,
+	<ul>
+		<li>at the beginning and end of a <i>ruby container</i>, <i>ruby annotation container</i>, or <i>ruby base container</i>,
+		<li>at the beginning/end of a <i>ruby annotation box</i> or <i>ruby base box</i> if white space is not its only contents,
+		<li>between a <i>ruby base container</i> and its following <i>ruby annotation container</i>,
+		<li>between <i>ruby annotation containers</i>.
+	</ul>
+
+	<p>Between <i>ruby segments</i>, between <i>ruby bases</i>, and between <i>ruby annotations</i>, however,
 	white space is not discarded.
-	If such white space is <i>collapsible</i>, it will collapse
+
+	<p>Where undiscarded white space is <i>collapsible</i>, it will collapse
 	following the standard <a href="http://www.w3.org/TR/css3-text/#white-space-rules">white space processing rules</a>. [[!CSS3TEXT]]
-	Between <i>ruby segments</i>, however,
+	For <i>collapsible</i> white space between <i>ruby segments</i>, however,
 	the contextual text for determining collapsing behavior is given by the <i>ruby bases</i> on either side,
 	not the text on either side of the white space in the source document.
 
@@ -452,11 +454,12 @@ <h3 id="white-space">
 <!--		-->  &lt;rb>東&lt;/rb>&lt;rb>京&lt;/rb>
 <!--		-->  &lt;rt>とう&lt;/rt>&lt;rt>きょう&lt;/rt>
 <!--		-->&lt;/ruby></pre>
-		<p>However, this markup will:
+		<p>However, white space that does not contain a <i>segment break</i> does not collapse completely away,
+		so this markup will display with a space between the first and second ruby pairs:
 		<pre>
 <!--		-->&lt;ruby>
 <!--		-->  &lt;rb>東&lt;/rb>	&lt;rb>京&lt;/rb>
-<!--		-->  &lt;rt>とう&lt;/rt> &lt;rt>きょう&lt;/rt>
+<!--		-->  &lt;rt>とう&lt;/rt>	&lt;rt>きょう&lt;/rt>
 <!--		-->&lt;/ruby></pre>
 	</div>
 
@@ -465,8 +468,10 @@ <h3 id="white-space">
 	<i>ruby annotation container</i> (if between <i>ruby annotations</i>),
 	or <i>ruby container</i> (if between <i>ruby segments</i>).
 	In the latter case, the text is considered part of the <i>base level</i>.
-	This box does not take part in pairing.
-	It merely ensures separation between adjacent bases/annotations.
+	Such anonynmous boxes do not take part in pairing.
+	They merely ensure separation between adjacent bases/annotations.
+
+	<p class="issue">Specify how these anonymous white space boxes impact layout.
 
 	<div class="example">
 		<p>These rules allow ruby to be used with space-separated scripts such as Latin.
@@ -484,8 +489,6 @@ <h3 id="white-space">
 <!--		-->&lt;/ruby></pre>
 	</div>
 
-	<p class="issue">Specify how this impacts layout, or not.
-
 <h3 id="ruby-layout">
 Ruby layout</h3>