[css-writing-modes] Remove commented out bits of text-combine-horizontal

Author: fantasai

css-writing-modes/Overview.html

@@ -124,8 +124,8 @@ <h2 class="no-num no-toc no-ref heading settled heading" id=contents><span class
 Table Caption Mappings: the <span class=property data-link-type=propdesc title=caption-side>caption-side</span> keywords</a></ul><li><a href=#page-direction><span class=secno>8</span>
 Page Flow: the page progression direction</a><li><a href=#text-combine><span class=secno>9</span>
 Glyph Composition</a><ul class=toc><li><a href=#text-combine-horizontal><span class=secno>9.1</span>
-Horizontal-in-Vertical Composition: the <span class=property data-link-type=propdesc title=text-combine-horizontal>text-combine-horizontal</span> property</a><ul class=toc><li><a href=#text-combine-sequence><span class=secno>9.1.1</span>
-Sequencing Rules</a><li><a href=#text-combine-layout><span class=secno>9.1.2</span>
+Horizontal-in-Vertical Composition: the <span class=property data-link-type=propdesc title=text-combine-horizontal>text-combine-horizontal</span> property</a><ul class=toc><li><a href=#text-combine-runs><span class=secno>9.1.1</span>
+Text Run Rules</a><li><a href=#text-combine-layout><span class=secno>9.1.2</span>
 Layout Rules</a><li><a href=#text-combine-compression><span class=secno>9.1.3</span>
 Compression Rules</a><ul class=toc><li><a href=#text-combine-fullwidth><span class=secno>9.1.3.1</span>
 Full-width Characters</a></ul></ul></ul><li><a href=#changes><span class=secno></span>Changes</a><ul class=toc><li><a href=#changes-201211><span class=secno></span>
@@ -2227,16 +2227,6 @@ <h3 class="heading settled heading" data-level=9.1 id=text-combine-horizontal><s
       all consecutive <a data-link-type=dfn href=#character title=characters>characters</a> within the element
       such that they take up the space of a single character
       within the vertical line box.
-<!--
-    <dt><dfn value for=text-combine-horizontal>numeric</dfn>
-    <dd>Within the element, each sequence of consecutive horizontal numbers
-      that has as many or fewer characters than the integer given is treated
-      as if it were in an anonymous inline box with
-      <span data-link-type="maybe" class="css">text-combine-horizontal: all</span>.
-      For this property, a <dfn>horizontal number</dfn> is any character
-      belonging to a Number category (N*) that does not belong to a
-      <a href="#script-orientations">vertical script</a>.
--->
     <dt><dfn class=css-code data-dfn-for=text-combine-horizontal data-dfn-type=value data-export="" id=valuedef-digits-integer>digits <var>&lt;integer&gt;</var>?<a class=self-link href=#valuedef-digits-integer></a></dfn>
     <dd>Attempt to typeset horizontally
       each maximal sequence of consecutive ASCII digits (U+0030–U+0039)
@@ -2245,30 +2235,6 @@ <h3 class="heading settled heading" data-level=9.1 id=text-combine-horizontal><s
       within the vertical line box.
       If the integer is omitted, it computes to 2.
       Integers outside the range 2-4 are invalid.
-<!--
-    <dt><dfn value for=text-combine-horizontal>alpha</dfn>
-    <dd>Within the element, each sequence of consecutive horizontal letters
-      that has as many or fewer characters than the integer given is treated
-      as if it were in an anonymous inline box with
-      <span data-link-type="maybe" class="css">text-combine-horizontal: all</span>.
-      For this property, a <dfn>horizontal letter</dfn> is any character belonging
-      to a Letter category (L*) that does not belong to a
-      <a href="#script-orientations">vertical script</a>.
-    <dt><dfn value for=text-combine-horizontal>latin</dfn>
-    <dd>Within the element, each sequence of Latin letters
-      that has as many or fewer characters than the integer given is treated
-      as if it were in an anonymous inline box with
-      <span data-link-type="maybe" class="css">text-combine-horizontal: all</span>.
-      For this property, a <dfn>Latin letter</dfn> is any character belonging to
-      a Letter category (L*) that also belongs to the Latin script.
-      <p class="issue">This definition could replace <span data-link-type="maybe" class="css">alpha</span> as a simplification.
-      However, it wouldn’t work for greek or mixtures of greek and latin (e.g. &mu;m).
-    <dt><dfn value for=text-combine-horizontal>alphanumeric</dfn>
-    <dd>Within the element, each sequence of consecutive horizontal digits and/or
-      letters that has as many or fewer characters than the integer given is treated
-      as if it were in an anonymous inline box with
-      <span data-link-type="maybe" class="css">text-combine-horizontal: all</span>.
--->
   </dl>
 
   <div class=example>
@@ -2302,42 +2268,26 @@ <h3 class="heading settled heading" data-level=9.1 id=text-combine-horizontal><s
       <p class=caption>Example of mis-applied <i lang=ja title="">tate-chu-yoko</i></p>
     </div>
   </div>
-<!--
-<h4 id="text-combine-runs">
-Text Run Rules</h4>
-
-  <p>This feature can only combine plain text,
-  therefore each combined text run must contain only text: no element boundaries.
-  Because the property inherits,
-  the UA must ensure that the contents of the element effecting the combination
-  are not part of a sequence of the specified character pattern
-  that happens to begin or end outside the element;
-  if so, then the text is laid out normally, as if 'text-combine-horizontal' were <span data-link-type="maybe" class="css">none</span>.
-
-  <div class="example">
-    <p>For example, the following sequence of “1234” would be combined:
-<pre>&lt;tcy>&lt;span>1234&lt;/span>&lt;/tcy></pre>    <p>However, the next example would not result in any combined text,
-    even though the inner span (which has inherited a value of <span data-link-type="maybe" class="css">digits 4</span>) contains only text,
-    because “12“ and “34” are both part of the larger sequence “1234”
-<pre>&lt;tcy>12&lt;span>34&lt;/span>&lt;/tcy></pre>    <p>Similarly,
-  </div>
--->
 
-<h4 class="heading settled heading" data-level=9.1.1 id=text-combine-sequence><span class=secno>9.1.1 </span><span class=content>
-Sequencing Rules</span><a class=self-link href=#text-combine-sequence></a></h4>
+<h4 class="heading settled heading" data-level=9.1.1 id=text-combine-runs><span class=secno>9.1.1 </span><span class=content>
+Text Run Rules</span><a class=self-link href=#text-combine-runs></a></h4>
 
   <p>To avoid complexity in the rendering and layout,
-    <a class=property data-link-type=propdesc href=#propdef-text-combine-horizontal title=text-combine-horizontal>text-combine-horizontal</a> only combines consecutive <a data-link-type=dfn href=#character title=characters>characters</a>
-    that are not interrupted by an element boundary.
-    Therefore the UA must evaluate for combination
-    only uninterrupted runs of text.
-
-  <p>However, to avoid combining only part of a sequence,
-    if the boundary of a run is due only to one or more inline element boundaries,
+    <a class=property data-link-type=propdesc href=#propdef-text-combine-horizontal title=text-combine-horizontal>text-combine-horizontal</a> can only combine plain text:
+    consecutive <a data-link-type=dfn href=#character title=characters>characters</a> that are not interrupted by an element boundary.
+
+  <p>However, because the property inherits,
+    the UA must ensure that the contents of the element effecting the combination
+    are not part of an otherwise-combinable sequence
+    that happens to begin or end outside the element;
+    if so, then the text is laid out normally, as if <a class=property data-link-type=propdesc href=#propdef-text-combine-horizontal title=text-combine-horizontal>text-combine-horizontal</a> were <a class=css data-link-type=maybe href=#valuedef-none title=none>none</a>.
+    To avoid combining only part of a sequence:
+    if the boundary of a potentially-combinable run
+    is due only to one or more inline element boundaries,
     the UA must inspect any <a data-link-type=dfn href=#character title=characters>characters</a> that appear
-    immediately before and immediately after the run.
-    If these characters would, without the intervening element,
-    form a sequence that could (if it were not too long) combine,
+    immediately before and immediately after the run,
+    and if these characters would, without the intervening element,
+    form a sequence that would (if it were not too long) combine,
     then the candidate run does not combine.
 
   <p class=note>The above paragraph is at-risk. Comments from implementors are welcome.</p>
@@ -2465,46 +2415,6 @@ <h5 class="heading settled heading" data-level=9.1.3.1 id=text-combine-fullwidth
     can potentially affect the selection of variants for characters included in combined text runs.
     Authors are advised to use these properties with care when <a class=property data-link-type=propdesc href=#propdef-text-combine-horizontal title=text-combine-horizontal>text-combine-horizontal</a> is also used.
 
-<!--
-<h3 id="text-combine-mode">
-Horizontal-in-Vertical Glyph Scaling: the 'text-combine-mode' property</h3>
-
-<table class='propdef'><tr><th>Name:<td>text-combine-mode<tr><th>Value:<td>auto | compress | [ no-compress || use-glyphs ]<tr><th>Initial:<td>auto<tr><th>Applies to:<td>non-replaced inline elements<tr><th>Inherited:<td>yes<tr><th>Media:<td>visual<tr><th>Computed value:<td>specified value<tr><th>Canonical order:<td>n/a<tr><th>Percentages:<td>n/a<tr><th>Animatable:<td>no</table>
-  <p>This property controls how multiple characters are combined into the
-    space of a single character when specified to do so via
-    'text-combine-horizontal'. Values have the following meanings:</p>
-
-  <dl dfn-for=text-combine-mode dfn-type=value>
-    <dt><dfn>auto</dfn>
-    <dd>If the contents are wider than 1em, the UA must attempt to fit the
-      contents within 1em, but may use any method to do so.
-    <dt><dfn>compress</dfn>
-    <dd>Compress the composition (horizontally) as a whole until it fits within 1em.
-      Do not substitute alternate-width glyphs.
-    <dt><dfn>use-glyphs</dfn>
-    <dd>Attempt to substitute narrower glyphs as necessary to make the
-      composition fit within 1em:
-      <ul>
-        <li>a two-character composition uses 1/2-em or proportional glyphs
-        <li>a three-character composition uses 1/3-em glyphs (if the font
-          supports this feature, else fall back to 1/2-em or proportional glyphs)
-        <li>etc.
-      </ul>
-      <p>Since even fonts that have fractional-width glyphs available do
-      not have such glyphs for all characters, the UA must ensure the
-      expected advance width for <span data-link-type="maybe" class="css">use-glyphs</span> by either compressing or
-      padding (equally on both sides) each glyph individually if it does
-      not match the required advance width. (This step does not apply if
-      <span data-link-type="maybe" class="css">no-compress</span> is specified.)
-    <dt><dfn>no-compress</dfn>
-    <dd>Do not compress the composition or perform any glyph substitution
-      in order to make the composition fit within 1em.
-      When combined with <span data-link-type="maybe" class="css">use-glyphs</span>, however, this indicates to perform
-      glyph substitution if possible per <span data-link-type="maybe" class="css">use-glyphs</span> but not to compress
-      the glyphs if they do not fit the size requirements.
-      This value may cause the glyphs to overflow the line significantly.
-  </dl>
--->
 <h2 class="no-num heading settled heading" id=changes><span class=content>Changes</span><a class=self-link href=#changes></a></h2>
   <h3 class="no-num heading settled heading" id=changes-201211><span class=content>
   Changes since the <a href=http://www.w3.org/TR/2012/WD-css3-writing-modes-20121115/>November

css-writing-modes/Overview.src.html

@@ -2235,16 +2235,6 @@ <h3 id="text-combine-horizontal">
       all consecutive <i>characters</i> within the element
       such that they take up the space of a single character
       within the vertical line box.
-<!--
-    <dt><dfn value for=text-combine-horizontal>numeric</dfn>
-    <dd>Within the element, each sequence of consecutive horizontal numbers
-      that has as many or fewer characters than the integer given is treated
-      as if it were in an anonymous inline box with
-      ''text-combine-horizontal: all''.
-      For this property, a <dfn>horizontal number</dfn> is any character
-      belonging to a Number category (N*) that does not belong to a
-      <a href="#script-orientations">vertical script</a>.
--->
     <dt><dfn value for=text-combine-horizontal>digits <var>&lt;integer></var>?</dfn>
     <dd>Attempt to typeset horizontally
       each maximal sequence of consecutive ASCII digits (U+0030&ndash;U+0039)
@@ -2253,30 +2243,6 @@ <h3 id="text-combine-horizontal">
       within the vertical line box.
       If the integer is omitted, it computes to 2.
       Integers outside the range 2-4 are invalid.
-<!--
-    <dt><dfn value for=text-combine-horizontal>alpha</dfn>
-    <dd>Within the element, each sequence of consecutive horizontal letters
-      that has as many or fewer characters than the integer given is treated
-      as if it were in an anonymous inline box with
-      ''text-combine-horizontal: all''.
-      For this property, a <dfn>horizontal letter</dfn> is any character belonging
-      to a Letter category (L*) that does not belong to a
-      <a href="#script-orientations">vertical script</a>.
-    <dt><dfn value for=text-combine-horizontal>latin</dfn>
-    <dd>Within the element, each sequence of Latin letters
-      that has as many or fewer characters than the integer given is treated
-      as if it were in an anonymous inline box with
-      ''text-combine-horizontal: all''.
-      For this property, a <dfn>Latin letter</dfn> is any character belonging to
-      a Letter category (L*) that also belongs to the Latin script.
-      <p class="issue">This definition could replace ''alpha'' as a simplification.
-      However, it wouldn't work for greek or mixtures of greek and latin (e.g. &mu;m).
-    <dt><dfn value for=text-combine-horizontal>alphanumeric</dfn>
-    <dd>Within the element, each sequence of consecutive horizontal digits and/or
-      letters that has as many or fewer characters than the integer given is treated
-      as if it were in an anonymous inline box with
-      ''text-combine-horizontal: all''.
--->
   </dl>
 
   <div class="example">
@@ -2317,44 +2283,26 @@ <h3 id="text-combine-horizontal">
       <p class="caption">Example of mis-applied <i lang="ja" title=''>tate-chu-yoko</i></p>
     </div>
   </div>
-<!--
+
 <h4 id="text-combine-runs">
 Text Run Rules</h4>
 
-  <p>This feature can only combine plain text,
-  therefore each combined text run must contain only text: no element boundaries.
-  Because the property inherits,
-  the UA must ensure that the contents of the element effecting the combination
-  are not part of a sequence of the specified character pattern
-  that happens to begin or end outside the element;
-  if so, then the text is laid out normally, as if 'text-combine-horizontal' were ''none''.
-
-  <div class="example">
-    <p>For example, the following sequence of “1234” would be combined:
-    <pre>&lt;tcy>&lt;span>1234&lt;/span>&lt;/tcy></pre>
-    <p>However, the next example would not result in any combined text,
-    even though the inner span (which has inherited a value of ''digits 4'') contains only text,
-    because “12“ and “34” are both part of the larger sequence “1234”
-    <pre>&lt;tcy>12&lt;span>34&lt;/span>&lt;/tcy></pre>
-    <p>Similarly,
-  </div>
--->
-
-<h4 id="text-combine-sequence">
-Sequencing Rules</h4>
-
   <p>To avoid complexity in the rendering and layout,
-    'text-combine-horizontal' only combines consecutive <i>characters</i>
-    that are not interrupted by an element boundary.
-    Therefore the UA must evaluate for combination
-    only uninterrupted runs of text.
-
-  <p>However, to avoid combining only part of a sequence,
-    if the boundary of a run is due only to one or more inline element boundaries,
+    'text-combine-horizontal' can only combine plain text:
+    consecutive <i>characters</i> that are not interrupted by an element boundary.
+
+  <p>However, because the property inherits,
+    the UA must ensure that the contents of the element effecting the combination
+    are not part of an otherwise-combinable sequence
+    that happens to begin or end outside the element;
+    if so, then the text is laid out normally, as if 'text-combine-horizontal' were ''none''.
+    To avoid combining only part of a sequence:
+    if the boundary of a potentially-combinable run
+    is due only to one or more inline element boundaries,
     the UA must inspect any <i>characters</i> that appear
-    immediately before and immediately after the run.
-    If these characters would, without the intervening element,
-    form a sequence that could (if it were not too long) combine,
+    immediately before and immediately after the run,
+    and if these characters would, without the intervening element,
+    form a sequence that would (if it were not too long) combine,
     then the candidate run does not combine.
 
   <p class="note">The above paragraph is at-risk. Comments from implementors are welcome.</p>
@@ -2490,58 +2438,6 @@ <h5 id="text-combine-fullwidth">
     can potentially affect the selection of variants for characters included in combined text runs.
     Authors are advised to use these properties with care when 'text-combine-horizontal' is also used.
 
-<!--
-<h3 id="text-combine-mode">
-Horizontal-in-Vertical Glyph Scaling: the 'text-combine-mode' property</h3>
-
-  <pre class='propdef'>q
-  Name: text-combine-mode
-  Value: auto | compress | [ no-compress || use-glyphs ]
-  Initial: auto
-  Applies to: non-replaced inline elements
-  Inherited: yes
-  Percentages: n/a
-  Media: visual
-  Computed value: specified value
-  Animatable: no
-  Canonical order: n/a
-  </pre>
-
-  <p>This property controls how multiple characters are combined into the
-    space of a single character when specified to do so via
-    'text-combine-horizontal'. Values have the following meanings:</p>
-
-  <dl dfn-for=text-combine-mode dfn-type=value>
-    <dt><dfn>auto</dfn>
-    <dd>If the contents are wider than 1em, the UA must attempt to fit the
-      contents within 1em, but may use any method to do so.
-    <dt><dfn>compress</dfn>
-    <dd>Compress the composition (horizontally) as a whole until it fits within 1em.
-      Do not substitute alternate-width glyphs.
-    <dt><dfn>use-glyphs</dfn>
-    <dd>Attempt to substitute narrower glyphs as necessary to make the
-      composition fit within 1em:
-      <ul>
-        <li>a two-character composition uses 1/2-em or proportional glyphs
-        <li>a three-character composition uses 1/3-em glyphs (if the font
-          supports this feature, else fall back to 1/2-em or proportional glyphs)
-        <li>etc.
-      </ul>
-      <p>Since even fonts that have fractional-width glyphs available do
-      not have such glyphs for all characters, the UA must ensure the
-      expected advance width for ''use-glyphs'' by either compressing or
-      padding (equally on both sides) each glyph individually if it does
-      not match the required advance width. (This step does not apply if
-      ''no-compress'' is specified.)
-    <dt><dfn>no-compress</dfn>
-    <dd>Do not compress the composition or perform any glyph substitution
-      in order to make the composition fit within 1em.
-      When combined with ''use-glyphs'', however, this indicates to perform
-      glyph substitution if possible per ''use-glyphs'' but not to compress
-      the glyphs if they do not fit the size requirements.
-      This value may cause the glyphs to overflow the line significantly.
-  </dl>
--->
 <h2 class="no-num" id="changes">Changes</h2>
   <h3 class="no-num" id="changes-201211">
   Changes since the <a href="http://www.w3.org/TR/2012/WD-css3-writing-modes-20121115/">November