[css2] Changes based on Hakon comments

ianbjacobs · ianbjacobs · commit 02bb7e24c1b2 · 1998-02-21T04:23:42.000Z
--HG--
extra : convert_revision : svn%3A73dc7c4b-06e6-40f3-b4f7-9ed1dbc14bfc/trunk%401058
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.2 1998-02-20 12:19:10 howcome Exp $ -->
+<!-- $Id: page.src,v 2.3 1998-02-21 04:23:42 ijacobs Exp $ -->
 <HEAD>
 <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
 <TITLE>Paged media</TITLE>
@@ -10,11 +10,11 @@
 
 <H2>Introduction to paged media</H2>
 
-<P>Paged media -- paper, transparencies, pages that are displayed on
-computer screens, etc. -- differ from <a
-href="./media.html#continuous-media-group">continuous media</a> in
-that formatting algorithms for pages must manage <a
-href="./#page-breaks">page breaks.</a> To handle page breaks, CSS2
+<P> Paged media (e.g., paper, transparencies, pages that are
+displayed on computer screens, etc.) differ from
+<a href="./media.html#continuous-media-group">continuous media</a>
+in that the content of the document is split into one or more discrete
+pages. To handle page breaks, CSS2
 extends the <a href="visuren.html">visual rendering model</a>
 as follows:</p>
 
@@ -144,8 +144,7 @@ class="propinst-size">'size'</span> property</h3>
 <P>The size of a page box may either be "absolute" (fixed size) or
 "relative" (scalable, i.e., fitting available sheet sizes). Relative
 page boxes allow user agents to scale a document and make optimal use
-of the target size. Absolute page boxes ensure precise formatting when
-that is the author's prerogative.
+of the target size. Absolute page boxes ensure precise formatting.
 
 <P>Three values for the <span class="propinst-size">'size'</span>
 property create a relative page box:</p>
@@ -256,7 +255,7 @@ sheets.
 boxes, the page box will be aligned with the target and the marks
 will be outside the printable area.
 
-<P>The size, style, and position of cross marks depends on the user
+<P>The size, style, and position of cross marks depend on the user
 agent.
 
 <h3>Left, right, and first pages</H3>
@@ -359,8 +358,8 @@ values for <span
 class="propinst-page-break-before">'page-break-before'</span> and
 <span class="propinst-page-break-after">'page-break-after'</span>.
 
-<li>Authors should not position elements in inconvenient locations as
-a means to avoid laying them out. Instead:
+<li>Authors should not position elements in inconvenient locations
+just to avoid rendering them. Instead:
 
 <ul>
 <li>To suppress box generation entirely, set the <span
@@ -426,12 +425,15 @@ the exact rules on how these values force or suppress a page break.
 
 <!-- #include src=properties/widows.srb -->
 
-<P>These properties specify the minimum number of lines of a paragraph
-that must be left at the bottom (<span
-class="propinst-orphans">'orphans'</span>) and top (<span
-class="propinst-widows">'widows'</span>) of a page (see the section on
-<a href="visuren.html#line-box">line boxes</a> for information about
-paragraph formatting).
+<P>The <span class="propinst-orphans">'orphans'</span> property
+specifies the minimum number of lines of a paragraph that must be left
+at the bottom of a page. The <span
+class="propinst-widows">'widows'</span> property specifies the minimum
+number of lines of a paragraph that must be left at the top of a page.
+Examples of they are used to control page breaks are given below.
+
+<P>For information about paragraph formatting, please consult the
+section on <a href="visuren.html#line-box">line boxes</a>.
 
 <h3><a name="allowed-page-breaks">Allowed page breaks</a></h3>
 
@@ -495,9 +497,9 @@ margin, there is at least one with the value 'always', 'left', or
 
 <h3>"Best" page breaks</h3>
 
-<p>CSS does <em>not</em> define which of a set of allowed page breaks
-must be used; CSS does not forbid a user agent from breaking at every
-possible break point, or not to break at all. But CSS does recommend
+<p>CSS2 does <em>not</em> define which of a set of allowed page breaks
+must be used; CSS2 does not forbid a user agent from breaking at every
+possible break point, or not to break at all. But CSS2 does recommend
 that user agents observe the following heuristics (while recognizing
 that they are sometimes contradictory):</p>
 
@@ -511,9 +513,8 @@ the same height.
 </ul>
 
 <div class="example"><P> 
-Suppose, for example, that <span
-class="propinst-orphans">'orphans'</span>=4, <span
-class="propinst-widows">'widows'</span>=2, and 
+Suppose, for example, that the style sheet 
+contains 'orphans : 4', 'widows : 2', and
 there are 20 lines (<a href="visuren.html#line-box">line boxes</a>
 available at the bottom of the current page:</p>
 
@@ -522,7 +523,7 @@ available at the bottom of the current page:</p>
 <li>If a paragraph at the end of the current page contains 20 lines or fewer,
 it should be placed on the current page.
 
-<li>If the paragraph contains 21 - 22 lines, the second part of the
+<li>If the paragraph contains 21 or 22 lines, the second part of the
 paragraph must not violate the <span
 class="propinst-widows">'widows'</span> constraint, and so the
 second part must contain exactly two lines
@@ -532,8 +533,9 @@ contain 20 lines and the second part the remaining lines.
 						    
 </ul>
 
-<P>Now suppose that <span class="propinst-orphans">'orphans'</span>=10,
-<span class="propinst-widows">'widows'</span>=20, 
+<P>Now suppose that <span class="propinst-orphans">'orphans'</span> is
+'10',
+<span class="propinst-widows">'widows'</span> is '20', 
 and there are 8 lines available at the bottom of the current page:</p>
 
 <ul>
