Shuffle around some letter-spacing/word-spacing text.

fantasai · fantasai · commit e5b677a81656 · 2012-01-05T19:11:26.000Z
diff --git a/css3-text/Overview.html b/css3-text/Overview.html
@@ -29,14 +29,14 @@
 
    <h1>CSS Text Level 3</h1>
 
-   <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 3 January 2012</h2>
+   <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 5 January 2012</h2>
 
    <dl>
     <dt>This version:
 
-    <dd><a href="http://dev.w3.org/csswg/css3-text/">$Date: 2011/11/23
-     10:55:51 $ (CVS $Revision$)</a> <!--
-      <dd><a href="http://www.w3.org/TR/2012/WD-css3-text-20120103/">http://www.w3.org/TR/2012/WD-css3-text-20120103/</a></dd>
+    <dd><a href="http://dev.w3.org/csswg/css3-text/">$Date: 2012/01/03
+     18:35:25 $ (CVS $Revision$)</a> <!--
+      <dd><a href="http://www.w3.org/TR/2012/WD-css3-text-20120105/">http://www.w3.org/TR/2012/WD-css3-text-20120105/</a></dd>
     -->
      
 
@@ -2512,20 +2512,36 @@ <h3 id=text-justify><span class=secno>7.3. </span> Justification Method:
 
   <h2 id=spacing><span class=secno>8. </span> Spacing</h2>
 
+  <p>CSS offers control over text spacing via the &lsquo;<a
+   href="#word-spacing0"><code class=property>word-spacing</code></a>&rsquo;
+   and &lsquo;<a href="#letter-spacing0"><code
+   class=property>letter-spacing</code></a>&rsquo; properties. While in CSS1
+   and CSS2 these could only be &lsquo;<code class=css>normal</code>&rsquo;
+   (justifiable) or a fixed length, CSS3 can indicate range constraints to
+   control flexibility in justification. In addition the &lsquo;<a
+   href="#word-spacing0"><code class=property>word-spacing</code></a>&rsquo;
+   property can now be specified in percentages, making it possible to, for
+   example, double or eliminate word spacing.
+
+  <div class=example>
+   <p>In the following example, word spacing is halved, but may expand up to
+    its full amount if needed for text justification.
+
+   <pre>p { word-spacing: 50% 100%; }</pre>
+  </div>
+
   <p id=spacing-limit>The <dfn
-   id=ltspacing-limitgt>&lt;spacing-limit&gt;</dfn> value type, which is to
-   represent an optimum, minimum, and maximum for &lsquo;<a
+   id=ltspacing-limitgt>&lt;spacing-limit&gt;</dfn> value type, which
+   represents optimum, minimum, and maximum spacing in &lsquo;<a
    href="#word-spacing0"><code class=property>word-spacing</code></a>&rsquo;
    and &lsquo;<a href="#letter-spacing0"><code
    class=property>letter-spacing</code></a>&rsquo;, is defined as
 
   <pre class=prod><dfn
-   id=ltspacing-limit>&lt;spacing-limit></dfn> = [ normal | &lt;length&gt; | &lt;percentage&gt;]{1,3}
-
-  </pre>
+   id=ltspacing-limit>&lt;spacing-limit></dfn> = [ normal | &lt;length&gt; | &lt;percentage&gt;]{1,3}</pre>
 
   <p>If three values are specified, they represent the optimum, minimum, and
-   maximum respectively. If only two values are specified, then the first
+   maximum in that order. If only two values are specified, then the first
    represents both the optimum and the minimum, and the second represents the
    maximum. If just one value is specified, then it represents the optimum,
    minimum, and maximum. The values are interpreted as defined below:
@@ -2535,18 +2551,8 @@ <h2 id=spacing><span class=secno>8. </span> Spacing</h2>
     class=css>normal</code>&rsquo;</dfn>
 
    <dd>Specifies the normal optimum/minimum/maximum spacing, as defined by
-    the current font and/or the user agent. Normal minimum and maximum
-    spacing must be defined relative to the optimum spacing so that the
-    minimum and maximum limits increase and decrease with changes to the
-    optimum spacing. These limits may also vary according to some measure of
-    the amount of text on a line (e.g. block width divided by font size), as
-    larger measures can accommodate tighter spacing constraints. Normal
-    optimum/minimum/maximum spacing may also vary based on the value of the
-    <a href="#text-justify">&lsquo;<code
-    class=property>text-justify</code>&rsquo;</a> property, the element's
-    language, and other factors. Normal spacing between a pair of <a
-    href="#connected-scripts">connected</a> or <a
-    href="#cursive-scripts">cursive</a> characters is always zero.
+    the current font and/or the user agent. See <a
+    href="#normal-spacing">below</a>.
 
    <dt><dfn id=ltlengthgt
     title="&lt;spacing-limit&gt;:&lt;length&gt;">&lsquo;<code
@@ -2566,16 +2572,31 @@ <h2 id=spacing><span class=secno>8. </span> Spacing</h2>
     allowed.
   </dl>
 
-  <p>In the absence of justification the optimum spacing must be used. The
-   text justification process may alter the spacing from its optimum (see the
-   <a href="#text-justify">&lsquo;<code
+  <p>In the absence of justification the optimum spacing is be used. The text
+   justification process may alter the spacing from its optimum (see the <a
+   href="#text-justify">&lsquo;<code
    class=property>text-justify</code>&rsquo;</a> property, above) but must
    not violate the minimum spacing limit and should also avoid exceeding the
    maximum.
 
-  <p>If the minimum is more than the maxmimum, then the used maximum is set
-   to the minimum. Likewise for the optimum. If the maximum is less than the
-   optimum, then the used optimum is set to the used maximum.
+  <p>The minimum is treated as a hard constraint: if the maximum is less than
+   the minimum, then the used it is set to the minimum. Likewise for the
+   optimum. Similarly if the maximum is less than the optimum, then the used
+   optimum is set to the used maximum.
+
+  <p><dfn id=normal-spacing>Normal spacing</dfn>: Although &lsquo;<code
+   class=css>normal</code>&rsquo; spacing is UA-defined, the normal minimum
+   and maximum must be defined relative to the optimum so that the minimum
+   and maximum limits increase and decrease with changes to the optimum
+   spacing. These limits may also vary according to some measure of the
+   amount of text on a line (e.g. block width divided by font size), as
+   larger measures can accommodate tighter spacing constraints. Normal
+   optimum/minimum/maximum spacing may also vary based on the value of the <a
+   href="#text-justify">&lsquo;<code
+   class=property>text-justify</code>&rsquo;</a> property, the element's
+   language, and other factors. Normal spacing between a pair of <a
+   href="#connected-scripts">connected</a> or <a
+   href="#cursive-scripts">cursive</a> characters is always zero.
 
   <h3 id=word-spacing><span class=secno>8.1. </span> Word Spacing: the
    &lsquo;<a href="#word-spacing0"><code
@@ -2626,20 +2647,12 @@ <h3 id=word-spacing><span class=secno>8.1. </span> Word Spacing: the
   </table>
 
   <p>This property specifies the minimum, maximum, and optimal spacing
-   between &ldquo;words&rdquo;, as follows:
+   between &ldquo;words&rdquo;.
 
   <p>Spacing is applied to each word-separator character left in the text
    after the <a href="#white-space-rules">white space processing rules</a>
    have been applied, and should be applied half on each side of the
-   character. <dfn id=word-separator>Word-separator characters</dfn> include
-   the space (U+0020), the no-break space (U+00A0), the Ethiopic word space
-   (U+1361), the Aegean word separators (U+10100,U+10101), the Ugaritic word
-   divider (U+1039F), and the Tibetan tsek (U+0F0B, U+0F0C). If there are no
-   word-separator characters, or if the word-separating character has a zero
-   advance width (such as the zero width space U+200B) then the user agent
-   must not create an additional spacing between words. General punctuation
-   and fixed-width spaces (such as U+3000 and U+2000 through U+200A) are not
-   considered word-separator characters.
+   character.
 
   <div class=example>
    <p>The following example will make all the spaces between words in Arabic
@@ -2655,6 +2668,16 @@ <h3 id=word-spacing><span class=secno>8.1. </span> Word Spacing: the
    <pre>p { word-spacing: 0.5ch; }</pre>
   </div>
 
+  <p><dfn id=word-separator>Word-separator characters</dfn> include the space
+   (U+0020), the no-break space (U+00A0), the Ethiopic word space (U+1361),
+   the Aegean word separators (U+10100,U+10101), the Ugaritic word divider
+   (U+1039F), and the Tibetan tsek (U+0F0B, U+0F0C). If there are no
+   word-separator characters, or if the word-separating character has a zero
+   advance width (such as the zero width space U+200B) then the user agent
+   must not create an additional spacing between words. General punctuation
+   and fixed-width spaces (such as U+3000 and U+2000 through U+200A) are not
+   considered word-separator characters.
+
   <h3 id=letter-spacing><span class=secno>8.2. </span> Tracking: the
    &lsquo;<a href="#letter-spacing0"><code
    class=property>letter-spacing</code></a>&rsquo; property</h3>
diff --git a/css3-text/Overview.src.html b/css3-text/Overview.src.html
@@ -1822,13 +1822,27 @@ <h3 id="text-justify">
 <h2 id="spacing">
   Spacing</h2>
 
+  <p>CSS offers control over text spacing via the 'word-spacing'
+  and 'letter-spacing' properties. While in CSS1 and CSS2 these could only
+  be ''normal'' (justifiable) or a fixed length, CSS3 can indicate range
+  constraints to control flexibility in justification.
+  In addition the 'word-spacing' property can now be specified in
+  percentages, making it possible to, for example, double or eliminate
+  word spacing.
+
+  <div class="example">
+    <p>In the following example, word spacing is halved, but may expand up
+    to its full amount if needed for text justification.
+    <pre>p { word-spacing: 50% 100%; }</pre>
+  </div>
+
   <p id="spacing-limit">The <dfn>&lt;spacing-limit&gt;</dfn> value type,
-    which is to represent an optimum, minimum, and maximum for 'word-spacing'
+    which represents optimum, minimum, and maximum spacing in 'word-spacing'
     and 'letter-spacing', is defined as
-  <pre class="prod"><dfn>&lt;spacing-limit></dfn> = [ normal | &lt;length&gt; | &lt;percentage&gt;]{1,3}
+  <pre class="prod"><dfn>&lt;spacing-limit></dfn> = [ normal | &lt;length&gt; | &lt;percentage&gt;]{1,3}</pre>
 
   <p>If three values are specified, they represent the optimum, minimum,
-    and maximum respectively.
+    and maximum in that order.
     If only two values are specified, then the first represents both the
     optimum and the minimum, and the second represents the maximum.
     If just one value is specified, then it represents the optimum,
@@ -1837,20 +1851,7 @@ <h2 id="spacing">
   <dl>
     <dt><dfn title="&lt;spacing-limit&gt;:normal">''normal''</dfn></dt>
       <dd>Specifies the normal optimum/minimum/maximum spacing, as defined
-        by the current font and/or the user agent.
-        Normal minimum and maximum spacing must be defined relative to
-        the optimum spacing so that the minimum and maximum limits
-        increase and decrease with changes to the optimum spacing.
-        These limits may also vary according to some measure of the amount
-        of text on a line (e.g. block width divided by font size), as
-        larger measures can accommodate tighter spacing constraints.
-        Normal optimum/minimum/maximum spacing may also vary based on the
-        value of the <a href="#text-justify">'text-justify'</a> property,
-        the element's language, and other factors.
-        Normal spacing between a pair of
-        <a href="#connected-scripts">connected</a> or
-        <a href="#cursive-scripts">cursive</a>
-        characters is always zero.
+        by the current font and/or the user agent. See <a href="#normal-spacing">below</a>.
       </dd>
     <dt><dfn title="&lt;spacing-limit&gt;:&lt;length&gt;">''&lt;length&gt;''</dfn>
       <dd>Specifies extra spacing <em>in addition to</em> the normal spacing.
@@ -1863,15 +1864,31 @@ <h2 id="spacing">
       </dd>
   </dl>
 
-  <p>In the absence of justification the optimum spacing must be used.
+  <p>In the absence of justification the optimum spacing is be used.
     The text justification process may alter the spacing
     from its optimum (see the <a href="#text-justify">'text-justify'</a>
     property, above) but must not violate the minimum spacing limit
     and should also avoid exceeding the maximum.
 
-  <p>If the minimum is more than the maxmimum, then the used maximum is
-    set to the minimum. Likewise for the optimum. If the maximum is less
-    than the optimum, then the used optimum is set to the used maximum.
+  <p>The minimum is treated as a hard constraint: if the maximum is less
+    than the minimum, then the used it is set to the minimum. Likewise
+    for the optimum. Similarly if the maximum is less than the optimum,
+    then the used optimum is set to the used maximum.
+
+   <p><dfn id="normal-spacing">Normal spacing</dfn>:
+    Although ''normal'' spacing is UA-defined, the normal minimum and
+    maximum must be defined relative to the optimum so that the minimum
+    and maximum limits increase and decrease with changes to the optimum spacing.
+    These limits may also vary according to some measure of the amount
+    of text on a line (e.g. block width divided by font size), as
+    larger measures can accommodate tighter spacing constraints.
+    Normal optimum/minimum/maximum spacing may also vary based on the
+    value of the <a href="#text-justify">'text-justify'</a> property,
+    the element's language, and other factors.
+    Normal spacing between a pair of
+    <a href="#connected-scripts">connected</a> or
+    <a href="#cursive-scripts">cursive</a>
+    characters is always zero.
 
   <h3 id="word-spacing">
     Word Spacing: the 'word-spacing' property</h3>
@@ -1915,23 +1932,12 @@ <h3 id="word-spacing">
     </table>
 
     <p>This property specifies the minimum, maximum, and optimal spacing
-      between &ldquo;words&rdquo;, as follows:
+      between &ldquo;words&rdquo;.
 
     <p>Spacing is applied to each word-separator character
       left in the text after the <a href="#white-space-rules">white space
       processing rules</a> have been applied, and should be applied half on
       each side of the character.
-      <dfn id="word-separator">Word-separator characters</dfn> include the
-      space (U+0020), the no-break space (U+00A0), the Ethiopic word space (U+1361),
-      the Aegean word separators (U+10100,U+10101), the Ugaritic word divider
-      (U+1039F), and the Tibetan tsek (U+0F0B, U+0F0C).
-
-      If there are no word-separator characters, or if the word-separating
-      character has a zero advance width (such as the zero width space U+200B)
-      then the user agent must not create an additional spacing between words.
-
-      General punctuation and fixed-width spaces (such as U+3000 and U+2000
-      through U+200A) are not considered word-separator characters.</p>
 
     <div class="example">
       <p>The following example will make all the spaces between words in Arabic
@@ -1945,6 +1951,18 @@ <h3 id="word-spacing">
       <pre>p { word-spacing: 0.5ch; }</pre>
     </div>
 
+    <p><dfn id="word-separator">Word-separator characters</dfn> include the
+      space (U+0020), the no-break space (U+00A0), the Ethiopic word space (U+1361),
+      the Aegean word separators (U+10100,U+10101), the Ugaritic word divider
+      (U+1039F), and the Tibetan tsek (U+0F0B, U+0F0C).
+
+      If there are no word-separator characters, or if the word-separating
+      character has a zero advance width (such as the zero width space U+200B)
+      then the user agent must not create an additional spacing between words.
+
+      General punctuation and fixed-width spaces (such as U+3000 and U+2000
+      through U+200A) are not considered word-separator characters.</p>
+
   <h3 id="letter-spacing">
     Tracking: the 'letter-spacing' property</h3>
 
