markup reformat. No content changes.

Author: tabatkins

css3-flexbox/Overview.html

@@ -29,11 +29,11 @@
 
    <h1 id=head-box-flexible>CSS Flexible Box Layout Module</h1>
 
-   <h2 class="no-num no-toc" id=w3c-working>Editor's Draft, 17 February 2012</h2>
+   <h2 class="no-num no-toc" id=w3c-working>Editor's Draft, 18 February 2012</h2>
 
    <dl>
     <dt>This version:
-     <!--<dd><a href="http://www.w3.org/TR/2012/ED-css3-flexbox-20120217/">http://www.w3.org/TR/2012/ED-css3-flexbox-20120217/</a>-->
+     <!--<dd><a href="http://www.w3.org/TR/2012/ED-css3-flexbox-20120218/">http://www.w3.org/TR/2012/ED-css3-flexbox-20120218/</a>-->
 
 
     <dd><a
@@ -238,7 +238,7 @@ <h2 class="no-num no-toc" id=table>Table of contents</h2>
    <li><a href="#layout-algorithm"><span class=secno>7. </span> Flexbox
     Layout Algorithm</a>
 
-   <li><a href="#pagination"><span class=secno>8. </span>Page breaks in
+   <li><a href="#pagination"><span class=secno>8. </span> Page breaks in
     flexbox</a>
 
    <li><a href="#conformance"><span class=secno>9. </span> Conformance</a>
@@ -1915,14 +1915,14 @@ <h2 id=layout-algorithm><span class=secno>7. </span> Flexbox Layout
     the flexbox items generate boxes in the box-tree, and how the rest of
     this algorithm deals with the items.
 
-   <li>Determine the hypothetical main size of items
+   <li> Determine the hypothetical main size of items:
     <ol>
      <li>If item has a definite preferred size, it is the hypothetical main
       size.
 
      <li>
       <p>Otherwise layout the flexbox items using the shrink-to-fit
-       algorithm.
+       algorithm.</p>
 
       <p>Calculation of the shrink-to-fit width is similar to calculating the
        width of a table cell using the automatic table layout algorithm.
@@ -2049,23 +2049,22 @@ <h2 id=layout-algorithm><span class=secno>7. </span> Flexbox Layout
    lengths</dfn> of the items within a flexbox line:
 
   <ol>
-   <li>Determine sign of flexibility
+   <li> Determine sign of flexibility
     <ol>
      <li>Add sizes of all items, <i>adjusted for min/max</i>.
 
      <li>If sum of preferred sizes is less than available space, use positive
-      flexibility, otherwise use negative flexibility
+      flexibility, otherwise use negative flexibility.
     </ol>
 
     <p>for the rest of the algorithm use flexibility with the sign determined
-     in this step
+     in this step</p>
 
    <li>Reset all flexible sizes to their preferred size
 
    <li>Find free space by subtracting sum of item sizes from available space.
-    
 
-   <li>Distribute free space proportional to flex
+   <li> Distribute free space proportional to flex:
     <ol>
      <li>If the free space is positive, but step 1 chose negative
       flexibility, do nothing
@@ -2077,7 +2076,7 @@ <h2 id=layout-algorithm><span class=secno>7. </span> Flexbox Layout
       item's flexibility
     </ol>
 
-   <li>Fix min/max violations
+   <li> Fix min/max violations:
     <ol>
      <li>Adjust each flexible item for min/max.
 
@@ -2087,27 +2086,23 @@ <h2 id=layout-algorithm><span class=secno>7. </span> Flexbox Layout
       violation). Accumulate the difference.
     </ol>
 
-   <li>If the sum of all violations is
-    <ol>
-     <li>Zero: done
+   <li> If the sum of all violations is:
+    <dl>
+     <dt>Zero
 
-     <li>Positive:
-      <ol>
-       <li>Freeze items with max violations.
+     <dd>Exit the algorithm.
 
-       <li>Go to step 2
-      </ol>
+     <dt>Positive
 
-     <li>Negative
-      <ol>
-       <li>Freeze items with min violations
+     <dd>Freeze items with max violations, and return to step 2.
 
-       <li>Go to step 2
-      </ol>
-    </ol>
+     <dt>Negative
+
+     <dd>Freeze items with min violations, and return to step 2.
+    </dl>
   </ol>
 
-  <div class=note>
+  <div class=issue>
    <p>Previous algorithm - compare with above and chose one:</p>
 
    <ol>
@@ -2197,7 +2192,7 @@ <h2 id=layout-algorithm><span class=secno>7. </span> Flexbox Layout
    </ol>
   </div>
 
-  <h2 id=pagination><span class=secno>8. </span>Page breaks in flexbox</h2>
+  <h2 id=pagination><span class=secno>8. </span> Page breaks in flexbox</h2>
 
   <p>Flexboxes can break across pages between items, between lines of items
    (in multi-line mode) and inside items, as long as &lsquo;<code
@@ -2218,7 +2213,7 @@ <h2 id=pagination><span class=secno>8. </span>Page breaks in flexbox</h2>
 
    <li>When flexbox is continued after a break, flexbox’s available space
     in block direction is reduced by space consumed in previous pages.
-    Consumed space before page break is
+    Consumed space before page break is:
     <ol>
      <li>If flexbox starts on that page: the distance between start of
       content box of the flexbox and the end of available space
@@ -2230,13 +2225,14 @@ <h2 id=pagination><span class=secno>8. </span>Page breaks in flexbox</h2>
     <p>If as a result of this adjustment block-direction size of flexbox
      becomes negative, it is set to zero.</p>
 
-   <li><dfn id=forced-breaks-on-flexbox-items>Forced breaks on flexbox
+   <li> <dfn id=forced-breaks-on-flexbox-items>Forced breaks on flexbox
     items</dfn>
     <ol>
      <li>In a row-direction single-line flexbox, breaks before and after
       items apply to the flexbox
 
-     <li>In column-directon single-line flexbox and all multi-line flexboxes
+     <li>In column-directon single-line flexbox and all multi-line flexboxes:
+      
       <ol>
        <li>Forced break before the first item is applied to the flexbox
 
@@ -2268,17 +2264,17 @@ <h2 id=pagination><span class=secno>8. </span>Page breaks in flexbox</h2>
       sibling from appearing on the same page)
     </ol>
 
-   <li><b>Column-direction flexbox: single-line</b>
+   <li> <b>Column-direction flexbox: single-line</b>
     <ol>
      <li>
       <p>If flexbox main-axis size is definite, flexbox algorithm must be run
        first, without constraints of available space on page and using all
        content of the flexbox. Otherwise items use the preferred size,
-       adjusted for min/max.
+       adjusted for min/max.</p>
 
       <p>If page size varies and flexbox size depends on page size, this step
        has to be repeated on each page, again with the whole content of the
-       flexbox.
+       flexbox.</p>
 
      <li>Set of items that will fit on current page is determined by adding
       main-axis sizes of items until total size exceeds avaialble space or a
@@ -2290,10 +2286,10 @@ <h2 id=pagination><span class=secno>8. </span>Page breaks in flexbox</h2>
      <li>
       <p>Items that fit on a page completely or partially are aligned
        according to ‘flex-pack’ property, independently from the rest of
-       flexbox content.
+       flexbox content.</p>
 
       <p>Note that flexible lenghts are not recalculated on each page, even
-       if there is additional free space.
+       if there is additional free space.</p>
     </ol>
 
     <p class=note>It is the intent of this spec that column-direction
@@ -2302,19 +2298,19 @@ <h2 id=pagination><span class=secno>8. </span>Page breaks in flexbox</h2>
      should paginate identically to a block with non-floating children with
      same content, same used size and same used margins. This rule is
      simplified and not normative, but if there is any difference it should
-     be noted here.
+     be noted here.</p>
 
-   <li><b>Column-direction flexbox: multi-line</b>
+   <li> <b>Column-direction flexbox: multi-line</b>
     <ol>
      <li>Items are collected in lines and laid out as usual, but in available
       space on current page.
 
-     <li>If border box of an item doesn’t fit on main-axis,
+     <li>If border box of an item doesn’t fit on main-axis:
       <ol>
        <li>If it is the last item of the last line, a break inside the item
         is considered
 
-       <li>Otherwise
+       <li>Otherwise:
         <ol>
          <li>If the flexbox is not at the top of the page, it is moved to the
           next page.
@@ -2324,7 +2320,7 @@ <h2 id=pagination><span class=secno>8. </span>Page breaks in flexbox</h2>
           class=property>overflow</code>&rsquo; property of the flexbox is
           set to &lsquo;<code class=property>visible</code>&rsquo;, it is
           paginated using same rules as visible overflow of blocks in normal
-          flow
+          flow.
           <p class=note>After the break, continuation of overflow items may
            overlap with other items and/or content after the flexbox. It is
            undesirable but there is no good resolution for this spacial
@@ -2334,15 +2330,15 @@ <h2 id=pagination><span class=secno>8. </span>Page breaks in flexbox</h2>
       </ol>
     </ol>
 
-   <li><b>Row-direction flexbox: single-line</b>
+   <li> <b>Row-direction flexbox: single-line</b>
     <ol>
      <li>
       <p>Main-axis space distribution in each line is done based on complete
        content of the flexbox and without space constraint in block
-       direction.
+       direction.</p>
 
       <p>If page size varies and flexbox size depends on page size, this step
-       needs to be repeated on each page
+       needs to be repeated on each page.</p>
 
      <li>Items are sized and positioned as usual, but in block-direction
       available space of min(remaining available space in flexbox, remaining
@@ -2359,7 +2355,7 @@ <h2 id=pagination><span class=secno>8. </span>Page breaks in flexbox</h2>
       needed.
 
      <li>Items that fit completely or partially on current page are aligned
-      on cross-axis
+      on cross-axis:
       <ol>
        <li>For the purposes of cross-axis alignment, minimum of remaining
         available space in flexbox and available space at current page is
@@ -2372,9 +2368,9 @@ <h2 id=pagination><span class=secno>8. </span>Page breaks in flexbox</h2>
       </ol>
     </ol>
 
-   <li><b>Row-direction flexbox:multi-line</b>
+   <li> <b>Row-direction flexbox:multi-line</b>
     <ol>
-     <li>Collect items into lines and determine line heights
+     <li>Collect items into lines and determine line heights:
       <ol>
        <li>
         <p>If &lsquo;<a href="#flex-line-pack0"><code
@@ -2383,13 +2379,13 @@ <h2 id=pagination><span class=secno>8. </span>Page breaks in flexbox</h2>
          class=property>stretch</code></a>&rsquo; and flexbox size in block
          direction is definite, layout of the complete flexbox has to be done
          first to determine line heights. Layout is done as usual for
-         non-paginated case, but accounting for forced breaks
+         non-paginated case, but accounting for forced breaks.</p>
 
         <p>If page size varies, this step may have to be redone, again with
          complete content; special consideration should be to be given to
          line breaks to ensure that item at the start of current page is also
          at the start of a line in this hypothetical layout. This
-         specification currently doesn't define how exactly to achieve that.
+         specification currently doesn't define how exactly to achieve that.</p>
 
        <li>Otherwise, items are collected into lines and each line is laid
         out as a single-line flexbox to determine block-direction size of