Shift explanation about page box's containing block into Page Model section. <http://www.w3.org/mid/4EE20B46.3070106@kozea.fr>

Author: fantasai

css3-page/Overview.html

@@ -557,16 +557,30 @@ <h2 id=page-box-page-rule><span class=secno>4. </span>The Page Model</h2>
      display running headers and footers.
    </ul>
 
-   <p>The properties of a <dfn id=page-box0>page box</dfn> are determined by
-    properties <a href="/TR/CSS21/syndata.html#declaration">declared</a>
-    within the <dfn id=page-context0><a href="#page-context">page
-    context</a></dfn>, which is the <a
+   <p>The properties of a <a href="#page-box"><i>page box</i></a> are
+    determined by properties <a
+    href="/TR/CSS21/syndata.html#declaration">declared</a> within the <a
+    href="#page-context"><i>page context</i></a>, which is the <a
     href="/TR/CSS21/syndata.html#x14">declaration block</a> of the <a
-    href="#page"><code>@page</code></a> rule.
-
-   <p>Declarations in the page context can affect the page box and/or inherit
-    to the margin boxes, but they do not apply to or inherit into the
-    document's root element or other content.</p>
+    href="#page"><code>@page</code></a> rule. Similarly the properties of a
+    <i>margin box</i> are determined by properties declared within its <a
+    href="#margin-context"><i>margin context</i></a>. Declarations in the
+    page context can affect the page box and/or inherit to the margin boxes,
+    but they do not apply to or inherit into the document's root element or
+    other content.</p>
+
+   <p>The <a href="#containing-block0"><i>containing block</i></a> of the
+    page box is specified using the ‘<a href="#size"><code
+    class=property>size</code></a>’ property in the <a
+    href="#page-context"><i>page context</i></a>. The width and horizontal
+    margins of the page box are then calculated exactly as for a <a
+    href="http://www.w3.org/TR/CSS21/visudet.html#blockwidth">non-replaced
+    block element in normal flow</a>. <a href="#CSS21"
+    rel=biblioentry>[CSS21]<!--{{!CSS21}}--></a> The height and vertical
+    margins of the page box are calculated analogously (instead of using the
+    block height formulas). In both cases if the values are over-constrained,
+    instead of ignoring any margins, the containing block is resized to
+    coincide with the margin edges of the page box.
 
    <h3 id=content-outside-box><span class=secno>4.1. </span>Content outside
     the page box</h3>
@@ -867,7 +881,7 @@ <h3 id=syntax-page-selector><span class=secno>5.3. </span>@page rule
 
 <span
     id=syntax-prod-margin>margin_box</span> :
-     margin_sym S* '{' declaration? [ ';' S* declaration? ]* '}' S*
+     margin_sym S* '{' S* declaration? [ ';' S* declaration? ]* '}' S*
      ;
 
 <span
@@ -2022,18 +2036,6 @@ <h2 id=page-size><span class=secno>8. </span>Page Size</h2>
     <h3 id=page-size-prop><span class=secno>8.1. </span>Page size: the ‘<a
      href="#size"><code class=property>size</code></a>’ property</h3>
 
-    <p>The containing block of the page box is specified using the ‘<a
-     href="#size"><code class=property>size</code></a>’ property in the <a
-     href="#page-context"><i>page context</i></a>. The width and horizontal
-     margins of the page box are then calculated exactly as for a <a
-     href="http://www.w3.org/TR/CSS21/visudet.html#blockwidth">non-replaced
-     block element in normal flow</a>. <a href="#CSS21"
-     rel=biblioentry>[CSS21]<!--{{!CSS21}}--></a> The height and vertical
-     margins of the page box are calculated analogously (instead of using the
-     block height formulas). In both cases if the values are
-     over-constrained, instead of ignoring any margins, the containing block
-     is resized to coincide with the margin edges of the page box.
-
     <table class=propdef summary="definition of the size property">
      <tbody>
       <tr>
@@ -2079,10 +2081,10 @@ <h3 id=page-size-prop><span class=secno>8.1. </span>Page size: the ‘<a
     </table>
 
     <p>This property specifies the target size and orientation of the <a
-     href="#page-box">page box</a>. In the general case, where one page box
-     is rendered onto one <a href="#page-sheet">page sheet</a>, the <a
-     class=property href="#size">‘<code class=property>size</code>’</a>
-     property also indicates the size of the destination page sheet.</p>
+     href="#page-box">page box</a>‘<code class=css>s containing block. In
+     the general case, where one page box is rendered onto one <a
+     href="#page-sheet">page sheet</a>, the </code>’size' property also
+     indicates the size of the destination page sheet.
 
     <p>The size of a page box can either be "absolute" (fixed size) or
      "relative" (scalable, i.e., fitting available sheet sizes).</p>

css3-page/Overview.src.html

@@ -314,16 +314,27 @@ <h2 id="page-box-page-rule">The Page Model</h2>
   boxes are typically used to display running headers and footers.</li>
 </ul>
 
-<p>The properties of a <dfn>page box</dfn> are determined by properties
+<p>The properties of a <i>page box</i> are determined by properties
 <a href="/TR/CSS21/syndata.html#declaration">declared</a> within the
-<dfn><a href="#page-context">page context</a></dfn>, which is the
+<i>page context</i>, which is the
 <a href="/TR/CSS21/syndata.html#x14">declaration block</a> of the
-<code>@page</code> rule. 
-
-<p>Declarations in the page context can affect the page box and/or inherit
+<code>@page</code> rule. Similarly the properties of a <i>margin box</i>
+are determined by properties declared within its <i>margin context</i>.
+Declarations in the page context can affect the page box and/or inherit
 to the margin boxes, but they do not apply to or inherit into the
 document's root element or other content.</p>
 
+<p>The <i>containing block</i> of the page box is specified using the 'size'
+property in the <i>page context</i>. The width and horizontal margins
+of the page box are then calculated exactly as for a
+<a href="http://www.w3.org/TR/CSS21/visudet.html#blockwidth">non-replaced
+block element in normal flow</a>. [[!CSS21]] The height and vertical margins
+of the page box are calculated analogously (instead of using the block height
+formulas). In both cases if the values are over-constrained, instead of
+ignoring any margins, the containing block is resized to coincide with the
+margin edges of the page box.
+
+
 <h3 id="content-outside-box">Content outside the page box</h3>
 
 <p>When formatting content in the page model, some content may end up outside the
@@ -571,7 +582,7 @@ <h3 id="syntax-page-selector">@page rule grammar</h3>
      ;
 
 <span id="syntax-prod-margin">margin_box</span> :
-     margin_sym S* '{' declaration? [ ';' S* declaration? ]* '}' S*
+     margin_sym S* '{' S* declaration? [ ';' S* declaration? ]* '}' S*
      ;
 
 <span id="syntax-prod-margin-sym">margin_sym</span> :
@@ -1465,16 +1476,6 @@ <h2 id="page-size">Page Size</h2>
 
 <h3 id="page-size-prop">Page size: the 'size' property</h3>
 
-<p>The containing block of the page box is specified using the 'size'
-property in the <i>page context</i>. The width and horizontal margins
-of the page box are then calculated exactly as for a
-<a href="http://www.w3.org/TR/CSS21/visudet.html#blockwidth">non-replaced
-block element in normal flow</a>. [[!CSS21]] The height and vertical margins
-of the page box are calculated analogously (instead of using the block height
-formulas). In both cases if the values are over-constrained, instead of
-ignoring any margins, the containing block is resized to coincide with the
-margin edges of the page box.
-
 <table class="propdef" summary="definition of the size property">
   <tr>
     <th>Name:
@@ -1503,10 +1504,9 @@ <h3 id="page-size-prop">Page size: the 'size' property</h3>
 </table>
 
 <p>This property specifies the target size and orientation of the
-<a href="#page-box">page box</a>. In the general case, where one
-page box is rendered onto one <a href="#page-sheet">page sheet</a>, the
-<span class="property">'size'</span> property also indicates the size of the
-destination page sheet.</p>
+<a href="#page-box">page box</a>'s containing block.
+In the general case, where one page box is rendered onto one <a href="#page-sheet">page sheet</a>,
+the 'size' property also indicates the size of the destination page sheet.
 
 <p>The size of a page box can either be "absolute" (fixed size) or "relative"
 (scalable, i.e., fitting available sheet sizes).</p>