Reorder paragraphs in text-align: <string> section to put less technical bits at the top

Author: fantasai

css3-text/Overview.html

@@ -35,8 +35,8 @@ <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 12 January
    <dl>
     <dt>This version:
 
-    <dd><a href="http://dev.w3.org/csswg/css3-text/">$Date: 2012/01/10
-     01:27:22 $ (CVS $Revision$)</a> <!--
+    <dd><a href="http://dev.w3.org/csswg/css3-text/">$Date: 2012/01/12
+     01:48:25 $ (CVS $Revision$)</a> <!--
       <dd><a href="http://www.w3.org/TR/2012/WD-css3-text-20120112/">http://www.w3.org/TR/2012/WD-css3-text-20120112/</a></dd>
     -->
 
@@ -1987,50 +1987,6 @@ <h4 id=character-alignment><span class=secno>7.1.1. </span>Character-based
    accordingly. (Note that the strings do not have to be the same for each
    cell, although they usually are.)
 
-  <p>If the alignment character appears more than once in the text, the first
-   instance is used for alignment. If the alignment character does not appear
-   in a cell at all, the string is aligned as if the alignment character had
-   been inserted at the end of its contents.
-
-  <p>Character-based alignment occurs before table cell width computation so
-   that auto width computations can leave enough space for alignment. Whether
-   column-spanning cells participate in the alignment prior to or after width
-   computation is undefined. If width constraints on the cell contents
-   prevent full alignment throughout the column, the resulting alignment is
-   undefined.
-
-  <p>A keyword value may be specified in conjunction with the &lt;string&gt;
-   value; if it is not given, it defaults to &lsquo;<code
-   class=css>right</code>&rsquo;. This value is used:
-
-  <ul>
-   <li>when character-based alignment is applied to boxes that are not table
-    cells.
-
-   <li>when the text wraps to multiple lines (at unforced break points).
-
-   <li>when the column is wide enough that the character alignment alone does
-    not determine the positions of its character-aligned contents. In this
-    case the keyword alignment of the first cell in the column with a
-    specified alignment character is used to slide the position of the
-    character-aligned contents to match the keyword alignment insofar as
-    possible without changing the width of the column. For &lsquo;<code
-    class=css>center</code>&rsquo;, the UA may center the aligned contents
-    using its extremes, center the alignment axis itself (insofar as
-    possible), or optically center the aligned contents some other way (such
-    as by taking a weighted average of the extent of the cells' contents to
-    either side of the axis).
-
-   <li>when a character-aligned cell spans more than one column. In this case
-    the keyword alignment value is used to determine which column's axis to
-    align with: the leftmost column for &lsquo;<code
-    class=css>left</code>&rsquo;, the rightmost column for &lsquo;<code
-    class=css>right</code>&rsquo; and &lsquo;<code
-    class=css>center</code>&rsquo;, the startmost column for &lsquo;<code
-    class=css>start</code>&rsquo;, the endmost column for &lsquo;<code
-    class=css>end</code>&rsquo;.
-  </ul>
-
   <div class=example> The following style sheet:
    <pre>TD { text-align: "." center }</pre>
    will cause the column of dollar figures in the following HTML table:
@@ -2067,11 +2023,55 @@ <h4 id=character-alignment><span class=secno>7.1.1. </span>Character-based
 <!-- --></pre>
   </div>
 
+  <p>A keyword value may be specified in conjunction with the &lt;string&gt;
+   value; if it is not given, it defaults to &lsquo;<code
+   class=css>right</code>&rsquo;. This value is used:
+
+  <ul>
+   <li>when character-based alignment is applied to boxes that are not table
+    cells.
+
+   <li>when the text wraps to multiple lines (at unforced break points).
+
+   <li>when a character-aligned cell spans more than one column. In this case
+    the keyword alignment value is used to determine which column's axis to
+    align with: the leftmost column for &lsquo;<code
+    class=css>left</code>&rsquo;, the rightmost column for &lsquo;<code
+    class=css>right</code>&rsquo; and &lsquo;<code
+    class=css>center</code>&rsquo;, the startmost column for &lsquo;<code
+    class=css>start</code>&rsquo;, the endmost column for &lsquo;<code
+    class=css>end</code>&rsquo;.
+
+   <li>when the column is wide enough that the character alignment alone does
+    not determine the positions of its character-aligned contents. In this
+    case the keyword alignment of the first cell in the column with a
+    specified alignment character is used to slide the position of the
+    character-aligned contents to match the keyword alignment insofar as
+    possible without changing the width of the column. For &lsquo;<code
+    class=css>center</code>&rsquo;, the UA may center the aligned contents
+    using its extremes, center the alignment axis itself (insofar as
+    possible), or optically center the aligned contents some other way (such
+    as by taking a weighted average of the extent of the cells' contents to
+    either side of the axis).
+  </ul>
+
   <p class=note>Right alignment is used by default for character-based
    alignment because numbering systems are almost all left-to-right even in
    right-to-left writing systems, and the primary use case of character-based
    alignment is for numerical alignment.
 
+  <p>If the alignment character appears more than once in the text, the first
+   instance is used for alignment. If the alignment character does not appear
+   in a cell at all, the string is aligned as if the alignment character had
+   been inserted at the end of its contents.
+
+  <p>Character-based alignment occurs before table cell width computation so
+   that auto width computations can leave enough space for alignment. Whether
+   column-spanning cells participate in the alignment prior to or after width
+   computation is undefined. If width constraints on the cell contents
+   prevent full alignment throughout the column, the resulting alignment is
+   undefined.
+
   <h3 id=text-align-last><span class=secno>7.2. </span> Last Line Alignment:
    the &lsquo;<a href="#text-align-last0"><code
    class=property>text-align-last</code></a>&rsquo; property</h3>

css3-text/Overview.src.html

@@ -1386,42 +1386,6 @@ <h4 id="character-alignment">Character-based Alignment in a Table Column</h4>
       shifted accordingly. (Note that the strings do not have to be the same
       for each cell, although they usually are.)
 
-    <p>If the alignment character appears more than once in the text, the first
-      instance is used for alignment. If the alignment character does not appear
-      in a cell at all, the string is aligned as if the alignment character had
-      been inserted at the end of its contents.
-
-    <p>Character-based alignment occurs before table cell width computation so
-      that auto width computations can leave enough space for alignment.
-      Whether column-spanning cells participate in the alignment prior to
-      or after width computation is undefined.
-      If width constraints on the cell contents prevent full alignment
-      throughout the column, the resulting alignment is undefined.
-
-    <p>A keyword value may be specified in conjunction with the &lt;string&gt;
-      value; if it is not given, it defaults to ''right''. This value is used:
-    <ul>
-      <li>when character-based alignment is applied to boxes that are not table
-        cells.
-      <li>when the text wraps to multiple lines (at unforced break points).
-      <li>when the column is wide enough that the character alignment alone does
-        not determine the positions of its character-aligned contents. In this
-        case the keyword alignment of the first cell in the column with a
-        specified alignment character is used to slide the position of the
-        character-aligned contents to match the keyword alignment insofar as
-        possible without changing the width of the column.
-        For ''center'', the UA may center
-        the aligned contents using its extremes, center the alignment axis
-        itself (insofar as possible), or optically center the aligned contents
-        some other way (such as by taking a weighted average of the extent of
-        the cells' contents to either side of the axis).
-      <li>when a character-aligned cell spans more than one column. In this
-        case the keyword alignment value is used to determine which column's
-        axis to align with: the leftmost column for ''left'', the rightmost
-        column for ''right'' and ''center'', the startmost column for ''start'',
-        the endmost column for ''end''.
-    </ul>
-
     <div class="example">
       The following style sheet:
       <pre>TD { text-align: "." center }</pre>
@@ -1458,11 +1422,47 @@ <h4 id="character-alignment">Character-based Alignment in a Table Column</h4>
 <!-- --></pre>
     </div>
 
+    <p>A keyword value may be specified in conjunction with the &lt;string&gt;
+      value; if it is not given, it defaults to ''right''. This value is used:
+    <ul>
+      <li>when character-based alignment is applied to boxes that are not table
+        cells.
+      <li>when the text wraps to multiple lines (at unforced break points).
+      <li>when a character-aligned cell spans more than one column. In this
+        case the keyword alignment value is used to determine which column's
+        axis to align with: the leftmost column for ''left'', the rightmost
+        column for ''right'' and ''center'', the startmost column for ''start'',
+        the endmost column for ''end''.
+      <li>when the column is wide enough that the character alignment alone does
+        not determine the positions of its character-aligned contents. In this
+        case the keyword alignment of the first cell in the column with a
+        specified alignment character is used to slide the position of the
+        character-aligned contents to match the keyword alignment insofar as
+        possible without changing the width of the column.
+        For ''center'', the UA may center
+        the aligned contents using its extremes, center the alignment axis
+        itself (insofar as possible), or optically center the aligned contents
+        some other way (such as by taking a weighted average of the extent of
+        the cells' contents to either side of the axis).
+    </ul>
+
     <p class="note">Right alignment is used by default for character-based
       alignment because numbering systems are almost all left-to-right even
       in right-to-left writing systems, and the primary use case of
       character-based alignment is for numerical alignment.</p>
 
+    <p>If the alignment character appears more than once in the text, the first
+      instance is used for alignment. If the alignment character does not appear
+      in a cell at all, the string is aligned as if the alignment character had
+      been inserted at the end of its contents.
+
+    <p>Character-based alignment occurs before table cell width computation so
+      that auto width computations can leave enough space for alignment.
+      Whether column-spanning cells participate in the alignment prior to
+      or after width computation is undefined.
+      If width constraints on the cell contents prevent full alignment
+      throughout the column, the resulting alignment is undefined.
+
   <h3 id="text-align-last">
     Last Line Alignment: the 'text-align-last' property</h3>