[css-text] Further clarifications to word-break.

--HG--
extra : rebase_source : 58321531e02f174f365a12e025bc865040494426

Author: fantasai

css-text/Overview.bs

@@ -894,6 +894,9 @@ Line Breaking Details</h3>
 
     <p>This property specifies <i>soft wrap opportunities</i> between letters,
       i.e. where it is “normal” and permissible to break lines of text.
+      It does not affect rules governing the <i>soft wrap opportunities</i>
+      created by spaces and punctuation.
+      (See 'line-break' for controls affecting punctuation.)
 
     <div class="example">
       <p>For example, in some styles of CJK typesetting, English words are allowed
@@ -923,23 +926,28 @@ Line Breaking Details</h3>
 
     <dl dfn-for=word-break dfn-type=value>
       <dt><dfn>normal</dfn></dt>
-      <dd><i>Soft wrap opportunities</i> are as defined <a href="#line-breaking">above</a>.</dd>
+      <dd>Words break according to their customary rules,
+       as described <a href="#line-breaking">above</a>.
+       Korean, which commonly exhibits two different behaviors,
+       allows breaks between any two consecutive Hangul/Hanja.
+
       <dt><dfn>break-all</dfn></dt>
-      <dd>In addition to ''word-break:normal'' <i>soft wrap opportunities</i>,
+      <dd>In addition to ''word-break/normal'' <i>soft wrap opportunities</i>,
         lines may break between any two <i>semantically-perceived letters</i>
         (except where forbidden by the 'line-break' property).
         Hyphenation is not applied. This option is used mostly in a context where
         the text is predominantly using CJK characters with few non-CJK excerpts
         and it is desired that the text be better distributed on each line.</dd>
+
       <dt><dfn>keep-all</dfn></dt>
       <dd>
         Implicit <i>soft wrap opportunities</i> between <i>semantically-perceived letters</i> are suppressed,
         i.e. breaks are prohibited between pairs of letters
         (including those explicitly allowed by 'line-break')
         except where opportunities exist due to dictionary-based breaking.
-        Otherwise this option is equivalent to ''word-break:normal''.
+        Otherwise this option is equivalent to ''word-break/normal''.
         In this style, sequences of CJK characters do not break.
-        <p class=note>This is sometimes seen in Korean (which uses spaces between words),
+        <p class=note>This is the other common behavior for Korean (which uses spaces between words),
         and is also useful for mixed-script text where CJK snippets are mixed
         into another language that uses spaces for separation.</dd>
     </dl>

css-text/Overview.html

@@ -1065,6 +1065,9 @@ <h3 class="heading settled heading" data-level=5.2 id=word-break-property><span
 
     <p>This property specifies <a data-link-type=dfn href=#soft-wrap-opportunity title="soft wrap opportunities">soft wrap opportunities</a> between letters,
       i.e. where it is “normal” and permissible to break lines of text.
+      It does not affect rules governing the <a data-link-type=dfn href=#soft-wrap-opportunity title="soft wrap opportunities">soft wrap opportunities</a>
+      created by spaces and punctuation.
+      (See <a class=property data-link-type=propdesc href=#propdef-line-break title=line-break>line-break</a> for controls affecting punctuation.)
 
     <div class=example>
       <p>For example, in some styles of CJK typesetting, English words are allowed
@@ -1094,23 +1097,28 @@ <h3 class="heading settled heading" data-level=5.2 id=word-break-property><span
 
     <dl data-dfn-for=word-break data-dfn-type=value>
       <dt><dfn class=css-code data-dfn-for=word-break data-dfn-type=value data-export="" id=valuedef-normal1>normal<a class=self-link href=#valuedef-normal1></a></dfn></dt>
-      <dd><a data-link-type=dfn href=#soft-wrap-opportunity title="soft wrap opportunities">Soft wrap opportunities</a> are as defined <a href=#line-breaking>above</a>.</dd>
+      <dd>Words break according to their customary rules,
+       as described <a href=#line-breaking>above</a>.
+       Korean, which commonly exhibits two different behaviors,
+       allows breaks between any two consecutive Hangul/Hanja.
+
       <dt><dfn class=css-code data-dfn-for=word-break data-dfn-type=value data-export="" id=valuedef-break-all>break-all<a class=self-link href=#valuedef-break-all></a></dfn></dt>
-      <dd>In addition to <span class=css data-link-type=maybe title=word-break:normal>word-break:normal</span> <a data-link-type=dfn href=#soft-wrap-opportunity title="soft wrap opportunities">soft wrap opportunities</a>,
+      <dd>In addition to <a class=css data-link-for=word-break data-link-type=maybe href=#valuedef-normal1 title=normal>normal</a> <a data-link-type=dfn href=#soft-wrap-opportunity title="soft wrap opportunities">soft wrap opportunities</a>,
         lines may break between any two <a data-link-type=dfn href=#semantically-perceived-letter title="semantically-perceived letters">semantically-perceived letters</a>
         (except where forbidden by the <a class=property data-link-type=propdesc href=#propdef-line-break title=line-break>line-break</a> property).
         Hyphenation is not applied. This option is used mostly in a context where
         the text is predominantly using CJK characters with few non-CJK excerpts
         and it is desired that the text be better distributed on each line.</dd>
+
       <dt><dfn class=css-code data-dfn-for=word-break data-dfn-type=value data-export="" id=valuedef-keep-all>keep-all<a class=self-link href=#valuedef-keep-all></a></dfn></dt>
       <dd>
         Implicit <a data-link-type=dfn href=#soft-wrap-opportunity title="soft wrap opportunities">soft wrap opportunities</a> between <a data-link-type=dfn href=#semantically-perceived-letter title="semantically-perceived letters">semantically-perceived letters</a> are suppressed,
         i.e. breaks are prohibited between pairs of letters
         (including those explicitly allowed by <a class=property data-link-type=propdesc href=#propdef-line-break title=line-break>line-break</a>)
         except where opportunities exist due to dictionary-based breaking.
-        Otherwise this option is equivalent to <span class=css data-link-type=maybe title=word-break:normal>word-break:normal</span>.
+        Otherwise this option is equivalent to <a class=css data-link-for=word-break data-link-type=maybe href=#valuedef-normal1 title=normal>normal</a>.
         In this style, sequences of CJK characters do not break.
-        <p class=note>This is sometimes seen in Korean (which uses spaces between words),
+        <p class=note>This is the other common behavior for Korean (which uses spaces between words),
         and is also useful for mixed-script text where CJK snippets are mixed
         into another language that uses spaces for separation.</dd>
     </dl>