[css-text] Cleanup unused text in comments

Author: kojiishi

css-text/Overview.html

@@ -618,19 +618,6 @@ <h3 id=text-transform-property><span class=secno>2.1. </span> <a
    <dd>Puts all characters in fullwidth form. If the character does not have
     a corresponding fullwidth form, it is left as is. This value is typically
     used to typeset Latin characters and digits like ideographic characters.
-    <!--
-      <dt><dfn title="full-size-kana!!text-transform">''full-size-kana''</dfn></dt>
-        <dd>Converts all small Kana characters to normal Kana.
-          The mappings for small Kana to normal Kana are defined in
-          <a href="#small-kana">Small Kana Mappings</a>.</p>
-        <p class=note>
-          This value is typically used for ruby annotation text, 
-          where due to the small type size, small Kana
-          is often drawn as large Kana.
-          This value allows such underlying text to use correct orthography
-          so that it is accessible and can be styled correctly
-          when not presented as ruby.
--->
   </dl>
 
   <p>The definition of “word“ used for ‘<code
@@ -673,15 +660,6 @@ <h3 id=text-transform-property><span class=secno>2.1. </span> <a
     This rule is thus conditionally defined in Unicode's SpecialCasing.txt
     file.
   </div>
-  <!--
-    <div class="example">
-      <p>An example where the UA may choose to include rules beyond those
-        in Unicode is Greek. In Greek, if the entire word is in upper case
-        (''text-transform: capitalize'' vs. ''text-transform: uppercase''),
-        accents are dropped or transformed according to language-specific rules.
-        http://blogs.msdn.com/b/michkap/archive/2006/08/18/706383.aspx
-    </div>
--->
 
   <p>The definition of fullwidth and halfwidth forms can be found on the
    Unicode consortium web site at <a href="#UAX11"
@@ -705,11 +683,6 @@ <h3 id=text-transform-property><span class=secno>2.1. </span> <a
    ‘<code class=css>@text-transform</code>’ rule similar to ‘<code
    class=css>@counter-style</code>’ from <a href="#CSS-COUNTER-STYLES-3"
    rel=biblioentry>[CSS-COUNTER-STYLES-3]<!--{{CSS-COUNTER-STYLES-3}}--></a>.
-   <!--
-      This mechanism may be used to replace ''full-size-kana''. This would
-      require authors needing this functionality to copy out the conversion
-      tables, however.
--->
 
   <h2 id=white-space-property><span class=secno>3. </span><a
    id=white-space-collapsing></a><a id=text-wrap></a> White Space and
@@ -1226,15 +1199,9 @@ <h2 id=line-breaking><span class=secno>5. </span> Line Breaking and Word
     Japanese, <a href="#ZHMARK" rel=biblioentry>[ZHMARK]<!--{{ZHMARK}}--></a>
     for Chinese, and in <a href="#UAX14"
     rel=biblioentry>[UAX14]<!--{{!UAX14}}--></a> for all scripts in Unicode.
-    <!-- The CSS Working Group notes that although UAX 14 contains a wealth of
-      information about line breaking conventions, a literal implementation
-      of its algorithm has been found to be inadequate in multiple situations. -->
 
    <p class="feedback issue">Any guidance for appropriate references here
     would be much appreciated.
-    <!-- Additionally, some guidance could be provided on how
-      to break or not break Southeast Asian in the absence of a dictionary.
-      (See e.g. <a href="http://lists.w3.org/Archives/Public/www-style/2011Feb/0126.html">notes on Thai</a>.) -->
   </div>
 
   <h3 id=line-break-details><span class=secno>5.1. </span> Line Breaking
@@ -1366,11 +1333,7 @@ <h3 id=line-break-property><span class=secno>5.2. </span> Breaking Rules
 
    <dd>The UA determines the set of line-breaking restrictions to use, and it
     may vary the restrictions based on the length of the line; e.g., use a
-    less restrictive set of line-break rules for short lines. <!--
-        However, if 'word-break' is ''keep-all'',
-        then all the line-breaking restrictions listed below for ''line-break: strict''
-        must be applied.
--->
+    less restrictive set of line-break rules for short lines.
 
    <dt><dfn id=loose title="loose!!line-break">‘<code
     class=css>loose</code>’</dfn>
@@ -1733,8 +1696,6 @@ <h3 id=hyphens-property><span class=secno>6.1. </span>Hyphenation Control:
 
    <dd>Words are only hyphenated where there are characters inside the word
     that explicitly suggest hyphenation opportunities.
-    <!-- Characters can be <del>explicit</del><ins>???</ins> or conditional. -->
-
     <div class=example>
      <p>In Unicode, U+00AD is a conditional "soft hyphen" and U+2010 is an
       unconditional hyphen. Unicode Standard Annex #14 describes the <a
@@ -1773,7 +1734,6 @@ <h3 id=hyphens-property><span class=secno>6.1. </span>Hyphenation Control:
    <p>For example, if the word “نوشتنن” were hyphenated, it would
     appear as “ﻧﻮﺷ-ﺘﻦ” not as “ﻧﻮﺵ-ﺗﻦ”.
   </div>
-  <!-- add a sample prioritization algorithm -->
 
   <h3 id=overflow-wrap-property><span class=secno>6.2. </span> Overflow
    Wrapping: the ‘<a href="#word-wrap"><code
@@ -1847,9 +1807,8 @@ <h3 id=overflow-wrap-property><span class=secno>6.2. </span> Overflow
    <dd>Lines may break only at allowed break points. However, the
     restrictions introduced by ‘<code class=css>word-break:
     keep-all</code>’ may be relaxed to match ‘<code class=css>word-break:
-    normal</code>’ <!-- and the various hyphenation limit properties
-      may be ignored -->
-    if there are no otherwise-acceptable break points in the line.
+    normal</code>’ if there are no otherwise-acceptable break points in the
+    line.
 
    <dt><dfn id=break-word title="break-word!!overflow-wrap">‘<code
     class=css>break-word</code>’</dfn>
@@ -2017,18 +1976,7 @@ <h3 id=text-align-property><span class=secno>7.1. </span> Text Alignment:
 
    <dd>Text is justified according to the method specified by the ‘<a
     href="#text-justify"><code class=property>text-justify</code></a>’
-    property, in order to exactly fill the line box. <!--
-    <dt><dfn title="&lt;string>">''<span title="&lt;string&gt;!!text-align"><a
-      class="noxref" href="http://www.w3.org/TR/CSS21/syndata.html#value-def-string"
-      ><span class="value-inst-string">&lt;string&gt;</span></a></span>''</dfn></dt>
-      <dd>The string must be a single <i>character</i>; otherwise the declaration
-        must be <a href="http://www.w3.org/TR/CSS21/conform.html#ignore">ignored</a>.
-        When applied to a table cell, specifies the <dfn>alignment character</dfn>
-        around which the cell's contents will align. See
-        <a href="#character-alignment">below</a> for further details and
-        how this value combines with keywords.
-      </dd>
--->
+    property, in order to exactly fill the line box.
 
    <dt><dfn id=match-parent title="match-parent!!text-align">‘<code
     class=css>match-parent</code>’</dfn>
@@ -2287,18 +2235,6 @@ <h3 id=text-justify-property><span class=secno>7.3. </span> Justification
      <p class=caption>Mixed-script text with ‘<code class=css>text-justify:
       inter-word</code>’
     </div>
-    <!--
-      <dt><dfn title="inter-ideographic!!text-justify">''inter-ideograph''</dfn></dt>
-        <dd>Justification primarily changes spacing at word separators and
-          between characters in <a href="#block-scripts">block scripts</a>.
-          This value is typically used for <abbr title="Chinese/Japanese/Korean">CJK</abbr>
-          languages.</dd>
-      <dt><dfn title="inter-cluster!!text-justify">''inter-cluster''</dfn></dt>
-        <dd>Justification primarily changes spacing at word separators and
-          between characters in <a href="#clustered-scripts">clustered
-          scripts</a>.
-          This value is typically used for Southeast Asian scripts such as Thai.</dd>
--->
 
    <dt><dfn id=distribute title="distribute!!text-justify">‘<code
     class=css>distribute</code>’</dfn>
@@ -2316,26 +2252,7 @@ <h3 id=text-justify-property><span class=secno>7.3. </span> Justification
      <p class=caption>Mixed-script text with ‘<code class=css>text-justify:
       distribute</code>’
     </div>
-    <!--
-      <dt><a name="kashida-prop"></a><a name="text-kashida-space"></a>
-        <dfn title="kashida!!text-justify">''kashida''</dfn></dt>
-        <dd>Justification primarily stretches
-          <a href="#cursive-scripts">cursive scripts</a> through the use of
-          kashida or other calligraphic elongation.
-          This value is <em>optional</em> for conformance to CSS3 Text.
-          (UAs that do not support cursive elongation must
-          <a href="http://www.w3.org/TR/css-2010/#partial">treat the value
-          as invalid</a>.)
--->
   </dl>
-  <!--
-      <div class="figure" id="fig-text-justify">
-        <p>
-          <img alt="Examples of text-justify values commonly used in East Asian scripts"
-               src="text-justify-east-asia.png" height="376" width="491"></p>
-        <p class="caption">Values of 'text-justify': ''inter-word'', ''auto'', and ''distribute''</p>
-      </div>
--->
 
   <p>The exact justification algorithm is UA-dependent; however, CSS provides
    some general guidelines...
@@ -3411,114 +3328,6 @@ <h2 class=no-num id=script-groups> Appendix C: Cursive Scripts</h2>
   <p>User agents should update this list as they update their Unicode support
    to handle as-yet-unencoded cursive scripts in future versions of Unicode,
    and are encourage to request the CSSWG to update this spec accordingly.
-   <!--
-  <p>Typographic behavior varies somewhat by language, but varies drastically
-    by writing system. This appendix categorizes some common scripts in
-    Unicode 6.0 according to their justification and spacing behavior. Category
-    descriptions are descriptive, not prescriptive; the determining factor is
-    the prioritization of <i>expansion opportunities</i>.
-
-  <dl>
-    <dt id="block-scripts"><dfn>block scripts</dfn></dt>
-      <dd>CJK and by extension all Wide characters. (See [[!UAX11]])
-        The following scripts are included:
-        Bopomofo,
-        Han,
-        Hangul,
-        Hiragana,
-        Katakana,
-        Yi
-      </dd>
-    <dt id="clustered-scripts"><dfn>clustered scripts</dfn></dt>
-      <dd>Scripts that have discrete units but do not use spaces between words,
-        such as many Southeast Asian systems.
-        The following scripts are included:
-        Javanese,
-        Khmer,
-        Lao,
-        Myanmar,
-        Thai,
-      <span class="issue">This list is likely incomplete. What else fits here?</span>
-      </dd>
-    <dt id="connected-scripts"><dfn>connected scripts</dfn></dt>
-      <dd>Devanagari, Ogham, and other scripts that use spaces between
-        words and baseline connectors within words.
-        By extension this category also includes any other Indic scripts
-        whose typographic behavior is similar to Devanagari.
-      The following scripts are included:
-      Bengali,
-      Brahmi,
-      Devanagari,
-      Gujarati,
-      Gurmukhi,
-      Kannada,
-      Malayalam,
-      Oriya?,
-      Ogham,
-      Tamil?,
-      Telugu
-      </dd>
-    <dt id="cursive-scripts"><dfn>cursive scripts</dfn></dt>
-      <dd>Arabic and similar inherently cursive scripts.
-      The following scripts are included:
-      Arabic,
-      Mongolian,
-      N'Ko,
-      Phags Pa,
-      Syriac
-      </dd>
-    <dt id="discrete-scripts"><dfn>discrete scripts</dfn></dt>
-      <dd>Scripts that use spaces or visible word-separating
-        punctuation between words and have discrete,
-        unconnected (in print) units within words.
-      The following scripts are included:
-      Armenian,
-      Bamum?,
-      Braille,
-      Canadian Aboriginal,
-      Cherokee,
-      Coptic,
-      Cyrillic,
-      Deseret,
-      Ethiopic
-      Greek,
-      Hebrew,
-      Kharoshthi,
-      Latin,
-      Lisu,
-      Osmanya,
-      Shavian,
-      Tifinagh,
-      Vai?
-      </dd>
-</dl>
-
-<p>UAs should treat unrecognized scripts as <i>discrete</i>.
-
-<p class="issue">This listing should ideally be exhaustive wrt Unicode.
-Please <a href="#status">send</a> suggestions and corrections to the CSS
-Working Group.</p>
-
-<div class="note">
-  <p>Guidelines for classification consider letter-spacing and justification:
-  <ol>
-    <li>If the script is cursive and may expand cursively but must not
-      space between letters, it is <i>cursive</i>.
-    <li>If the script primarily flexes word separators, it is either
-      <i>discrete</i> or <i>connected</i>. <i>Discrete</i> scripts can
-      space between letters. <i>Connected</i> scripts must not space
-      between letters (typically because that would break the connections
-      or otherwise look bad).
-    <li>If the script commonly expands equally between its "letters"
-      in native typesettings, it is either <i>block</i> or
-      <i>clustered</i>. The exact classification depends on whether it
-      always spaces when mixed with CJK and sometimes stays together
-      when mixed with Thai and related scripts (<i>block</i>) or
-      sometimes spaces when mixed with CJK and always spaces with Thai
-      (<i>clustered</i>).
-  </ol>
-</div>
--->
 
   <h2 class=no-num id=acknowledgements> Acknowledgements</h2>