[css2] Improved illustration in 13.2.1, minor text clarifications

ianbjacobs · ianbjacobs · commit 603e808d16a3 · 1998-04-17T19:10:12.000Z
--HG--
extra : convert_revision : svn%3A73dc7c4b-06e6-40f3-b4f7-9ed1dbc14bfc/trunk%401503
diff --git a/css2/page.src b/css2/page.src
@@ -1,6 +1,6 @@
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
 <html lang="en">
-<!-- $Id: page.src,v 2.22 1998-04-16 22:13:41 ijacobs Exp $ -->
+<!-- $Id: page.src,v 2.23 1998-04-17 19:10:12 ijacobs Exp $ -->
 <HEAD>
 <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
 <TITLE>Paged media</TITLE>
@@ -25,8 +25,8 @@ model</a> to allow authors to specify the size of a page, its margins,
 etc.  
 
 <li>The <span class="index-def" title="page model"><dfn>page
-model</dfn></span> extends the visual rendering layout model to
-account for <a href="#page-breaks">page breaks.</a>
+model</dfn></span> extends the <a href="visuren.html">visual rendering
+model</a> to account for <a href="#page-breaks">page breaks.</a>
 </ol>
 
 <P>The CSS2 <a name="page-model">page model</a> specifies how a
@@ -60,19 +60,16 @@ orientation</a>.
 <H2><a name="page-box">Page boxes</a>: the @page rule</H2>
 
 <P>The <span class="index-def" title="page box"><dfn>page
-box</dfn></span> is a rectangular region that contains two
-embedded areas:</p>
+box</dfn></span> is a rectangular region that contains two areas:</p>
 
 <ul>
 <li>The <span class="index-def" title="page area"><a
 name="page-area"><dfn>page area</dfn></a></span>. The page
 area includes the boxes laid out on that page.
-The edges of the page area act as a <a
-href="visuren.html#containing-block">containing block</a> for layout
-that occurs between page breaks. It also acts as the <a
-href="visuren.html#initial-containing-block">initial containing
-block</a>. 
-<li>The margin area.
+The edges of the page area act as the initial <a
+href="visuren.html#initial-containing-block">containing block</a> 
+for layout that occurs between page breaks.
+<li>The margin area, which surrounds the page area.
 </ul>
 
 <div class="note"><P> 
@@ -98,18 +95,23 @@ all left pages, all right pages, or a page with a specific name.
 </p>
 
 <P>The dimensions of the page box are set with the <span
-class="propinst-size">'size'</span> property.  The <span
-class="propinst-marks">'marks'</span> property specifies crop and
-cross marks.
+class="propinst-size">'size'</span> property. The dimensions
+of the page area are the dimensions of the page box minus
+the margin area. 
 
 <div class="example"><P>
-For example, the following @page rule sets the margins of the page to 2cm.
+For example, the following @page rule sets the 
+page box size to 8.5 x 11 inches and creates '2cm' margin
+on all sides between the page box edge and the page area:</p>
 
 <pre>
-@page { margin: 2cm }
+@page { size 8.5in 11in; margin: 2cm }
 </pre>
 </div>
 
+The <span class="propinst-marks">'marks'</span> property in an @page
+rule specifies crop and cross marks for the page box.
+
 <h3><a name="page-margins">Page margins</a></h3>
 
 <P>The <a href="box.html#margin-properties">margin properties</a>
@@ -121,14 +123,13 @@ class="propinst-margin">'margin'</span>) apply within the <a
 href="#page-context">page context</a>. The following diagram shows the
 relationships between the sheet, page box, and page margins:</P>
 
-<P><img src="./images/page-info.gif" alt="Illustration of sheet, page box, and margin."></p>
+<div class="figure">
+<P><img src="./images/page-info.gif" alt="Illustration of sheet, page
+box, margin, and page area."></p>
+</div>
 
-<P>The actual value of element margins that fall at the top or
-bottom of a page is set to 0.
-<!-- The CSS2 rules for <a
-href="box.html#collapsing-margins">collapsing vertical margins</a>
-apply to page margins as well. For example, the margin of the first
-box on a page will collapse with the page margin. -->
+<P>The actual value of box margins at the top or bottom of the page
+area is '0'.
 
 <p>The <a href="#page-context">page context</a> has no notion of
 fonts, so 'em' and 'ex' units are not allowed. Percentage values on
@@ -217,7 +218,7 @@ being printed).
 
 <h4>Rendering page boxes that do not fit a target sheet</h4>
 
-<P>If the page box does not fit the target sheet dimensions, the 
+<P>If a page box does not fit the target sheet dimensions, the 
 user agent may choose to:</p>
 
 <UL>
@@ -367,7 +368,7 @@ just to avoid rendering them. Instead:
 <ul>
 <li>To suppress box generation entirely, set the <span
 class="propinst-display">'display'</span> property to 'none'.
-<li>To render a box invisible, use the <span
+<li>To make a box invisible, use the <span
 class="propinst-visibility">'visibility'</span> property.
 </ul>
 
@@ -534,6 +535,8 @@ properties are set to '0'.
 inside a <a href="visuren.html#block-box">block</a> box.
 </ol>
 
+<!-- What about line boxes next to a float? -IJ -->
+
 <p>These breaks are subject to the following rules:
 
 <ul>
@@ -553,10 +556,11 @@ class="propinst-page-break-inside">'page-break-inside'</span> value of
 <li>
 <strong>Rule C:</strong> Breaking at (2) is allowed only if the number of <a
 href="visuren.html#line-box">line boxes</a> between the
-break and the start of the enclosing block box is <span
+break and the start of the enclosing block box is 
+the value of <span
 class="propinst-orphans">'orphans'</span> or more, and the number of
-line boxes between the break and the end of the box is <span
-class="propinst-widows">'widows'</span> or more.
+line boxes between the break and the end of the box is 
+the value of <span class="propinst-widows">'widows'</span> or more.
 
 <li><strong>Rule D:</strong> In addition, breaking at (2) is allowed only if the <span
 class="propinst-page-break-inside">'page-break-inside'</span> property
