[css2] Generated. Do not edit!

--HG--
extra : convert_revision : svn%3A73dc7c4b-06e6-40f3-b4f7-9ed1dbc14bfc/trunk%402994

Author: bert-github

css2/css2.html

@@ -3314,7 +3314,7 @@ <h2>4.2 <a name="parsing-errors">Rules for handling parsing
 
 
 
-<li><strong>Invalid at-keywords.</strong> User agents must <span
+<li><strong>At-rules with unknown at-keywords.</strong> User agents must <span
 class="index-inst" title="ignore"><a name="x28" href="#ignore">ignore</a></span>
 an invalid at-keyword together with everything following it, up to the
 end of the block that contains the invalid at-keyword, or up to and
@@ -3689,7 +3689,7 @@ <h3>4.3.4 <a name="uri">URLs and URIs</a></h3>
 delimiters in CSS, the entire URI value must be treated as a single
 unit by the tokenizer and normal tokenization behavior does not apply
 within a URI value. Therefore comments are not allowed within a URI
-value.
+value.</em>
 </div>
 
 <p> In order to create modular style sheets that are not dependent on
@@ -10999,8 +10999,8 @@ <h3>10.6.4 <a name="abs-non-replaced-height">Absolutely positioned, non-replaced
 first box of the element if its specified <a href="visuren.html#propdef-position" class="noxref"><span
 class="propinst-position">'position'</span></a> value had been 'static'
 and its specified <a href="visuren.html#propdef-float" class="noxref"><span class="propinst-float">'float'</span></a> had been
-'none' and <a href="visuren.html#propdef-clear" class="noxref"><span class="propinst-clear">'clear'</span></a> had been
-'none'. (Note that due to the rules
+'none' and its specified <a href="visuren.html#propdef-clear" class="noxref"><span class="propinst-clear">'clear'</span></a>
+had been 'none'. (Note that due to the rules
 in <a href="visuren.html#dis-pos-flo">section&nbsp;9.7</a> this might
 require also assuming a different computed value for 'display'.)
 The value is negative if the hypothetical box is above the containing
@@ -13040,7 +13040,8 @@ <h3>12.5.1 <a name="list-style">Lists:</a> the <a href="generate.html#propdef-li
 </div>
 
 
-<P> This property specifies the position of the marker box in the
+<P> This property specifies the position of the marker box with
+respect to the
 principal block box. Values have the following meanings:</p>
 
 <dl>
@@ -13323,16 +13324,30 @@ <h2>13.2 <a name="page-box">Page boxes</a>: the @page rule</h2>
 <P>Authors can specify the margins of a page box inside an <a name="x3"><span
 class="index-def" title="@page">@page</span></a> rule. An @page rule
 consists of the keyword "@page", followed by an optional page
-selector, followed by a block of declarations. The declarations in an
+selector, followed by a block containing declarations and
+at-rules. The declarations in an
 @page rule are said to be in the <span class="index-def"
 title="page-context"><a name="page-context"><dfn>page
 context</dfn></a></span>.</p>
 
+<p class=note>Note: CSS level&nbsp;2 has no at-rules that may appear
+inside @page, but such at-rules are expected to be defined in
+level&nbsp;3.
+
 <P>The <a name="x5"><span class="index-def" title="page selector"><dfn>page
 selector</dfn></span></a> specifies for which pages the declarations
 apply. In CSS&nbsp;2.1, page selectors may designate the first page,
 all left pages, or all right pages</p>
 
+<P>The rules for handling malformed declarations, malformed
+statements, and invalid at-rules inside @page are as defined in <a
+href="syndata.html#parsing-errors">section&nbsp;4.2,</a> with the
+following addition: when the UA expects the start of a declaration or
+at-rule (i.e., an IDENT token or an ATKEYWORD token) but finds an
+unexpected token instead, that token is considered to be the first
+token of a malformed declaration. I.e., the rule for malformed
+declarations, rather than malformed statements is used to determine
+which tokens to ignore in that case.
 
 <h3>13.2.1 <a name="page-margins">Page margins</a></h3>
 

css2/diffs-rec/generate.html

@@ -101,26 +101,40 @@ <h2> <del>Although CSS2 does not specify how user agents transfer page boxes to
 <P>Authors <ins>can</ins> specify the  <del>dimensions, orientation, margins, etc.</del><ins>margins</ins> of a page box  <del>within</del><ins>inside</ins> an <a name="x3"><span
 class="index-def" title="@page">@page</span></a> rule. An @page rule
 consists of the keyword "@page",  <del>a page selector (followed with no intervening space</del><ins>followed</ins> by an optional page
- <del>pseudo-class), and</del><ins>selector, followed by</ins> a block of <ins>declarations. The</ins> declarations  <del>(said</del><ins>in an
+ <del>pseudo-class), and</del><ins>selector, followed by</ins> a block  <del>of</del><ins>containing declarations and
+at-rules. The</ins> declarations  <del>(said</del><ins>in an
 @page rule are said</ins> to be in the <span class="index-def"
 title="page-context"><a name="page-context"><dfn>page
 context</dfn></a></span> <del>).</del><ins>.</ins></p>
 
+<p class=note><ins>Note: CSS level&nbsp;2 has no at-rules that may appear
+inside @page, but such at-rules are expected to be defined in
+level&nbsp;3.</ins>
+
 <P>The <a name="x5"><span class="index-def" title="page selector"><dfn>page
 selector</dfn></span></a> specifies for which pages the declarations
 apply. In  <del>CSS2,</del><ins>CSS&nbsp;2.1,</ins> page selectors may designate the first page,
-all left pages, <ins>or</ins> all right  <del>pages, or a</del><ins>pages</ins></p>
-
-
-<h3><ins>13.2.1</ins> <a name="page-margins">Page  <del>with a specific name.</del><ins>margins</ins></a></h3>
-
-<P><ins>In CSS&nbsp;2.1, only</ins> the <a href="box.html#margin-properties"> <del>dimensions of</del><ins>margin
-properties</ins></a> <ins>(</ins><a href="box.html#propdef-margin-top" class="noxref"><span class="propinst-margin-top"><ins>'margin-top'</ins></span></a><ins>,</ins>
-<a href="box.html#propdef-margin-right" class="noxref"><span class="propinst-margin-right"><ins>'margin-right'</ins></span></a><ins>,</ins> <a href="box.html#propdef-margin-bottom" class="noxref"><span
-class="propinst-margin-bottom"><ins>'margin-bottom'</ins></span></a><ins>,</ins> <a href="box.html#propdef-margin-left" class="noxref"><span
-class="propinst-margin-left"><ins>'margin-left'</ins></span></a><ins>, and</ins> <a href="box.html#propdef-margin" class="noxref"><span
-class="propinst-margin"><ins>'margin'</ins></span></a><ins>) apply within</ins> the <a
-href="#page-context">page  <del>box are set with</del><ins>context</ins></a><ins>.</ins> The  <del>'size' property. The dimensions of the page area are the dimensions of the page box minus the margin area. Example(s): 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: @page { size 8.5in 11in; margin: 2cm } The 'marks' property in an @page rule specifies crop and cross marks for the page box. 13.2.1 Page margins The margin properties ( 'margin-top' , 'margin-right' , 'margin-bottom' , 'margin-left' , and 'margin' ) apply within the page context . The following diagram shows</del><ins>following diagram shows</ins> the
+all left pages, <ins>or</ins> all right  <del>pages, or a page with a specific name. The dimensions of</del><ins>pages</ins></p>
+
+<P>The  <del>page box</del><ins>rules for handling malformed declarations, malformed
+statements, and invalid at-rules inside @page</ins> are  <del>set</del><ins>as defined in</ins> <a
+href="syndata.html#parsing-errors"><ins>section&nbsp;4.2,</ins></a> with the
+ <del>'size' property. The dimensions of</del><ins>following addition: when</ins> the  <del>page area are</del><ins>UA expects</ins> the  <del>dimensions</del><ins>start</ins> of  <del>the page box minus the margin area. Example(s): For example, the following @page rule sets the page box size</del><ins>a declaration or
+at-rule (i.e., an IDENT token or an ATKEYWORD token) but finds an
+unexpected token instead, that token is considered</ins> to  <del>8.5 x 11 inches and creates '2cm' margin on all sides between the page box edge and</del><ins>be</ins> the  <del>page area: @page { size 8.5in 11in; margin: 2cm }</del><ins>first
+token of a malformed declaration. I.e.,</ins> the  <del>'marks' property in an @page</del>rule  <del>specifies crop and cross marks</del>for  <del>the page box.</del><ins>malformed
+declarations, rather than malformed statements is used to determine
+which tokens to ignore in that case.</ins>
+
+<h3>13.2.1 <a name="page-margins">Page margins</a></h3>
+
+<P><ins>In CSS&nbsp;2.1, only</ins> the <a href="box.html#margin-properties">margin
+properties</a> (<a href="box.html#propdef-margin-top" class="noxref"><span class="propinst-margin-top">'margin-top'</span></a>,
+<a href="box.html#propdef-margin-right" class="noxref"><span class="propinst-margin-right">'margin-right'</span></a>, <a href="box.html#propdef-margin-bottom" class="noxref"><span
+class="propinst-margin-bottom">'margin-bottom'</span></a>, <a href="box.html#propdef-margin-left" class="noxref"><span
+class="propinst-margin-left">'margin-left'</span></a>, and <a href="box.html#propdef-margin" class="noxref"><span
+class="propinst-margin">'margin'</span></a>) 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>
 
 <div class="figure">
@@ -141,7 +155,7 @@ <h3><ins>13.2.1</ins> <a name="page-margins">Page  <del>with a specific name.</d
 
 <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
-the margin  <del>properties are relative to the dimensions of the page box ; for left and right margins, they refer to page box width while for top and bottom margins, they refer to page box height. All other units associated with the respective CSS2 properties are allowed. Due to negative margin values (either on the page box or on elements) or absolute positioning content may end up outside the page box, but this content may be "cut" -- by the user agent, the printer, or ultimately, the paper cutter. 13.2.2 Page size : the 'size' property 'size' Value: &nbsp;&nbsp; &lt;length&gt; {1,2} | auto | portrait | landscape | inherit Initial: &nbsp;&nbsp; auto Applies to: &nbsp;&nbsp; the page context Inherited: &nbsp;&nbsp; N/A Percentages: &nbsp;&nbsp; N/A Media: &nbsp;&nbsp; visual , paged This property specifies the size and orientation of a page box. 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. Three values for the 'size' property create a relative page box: auto The page box will be set to the size and orientation of the target sheet. landscape Overrides the target's orientation. The page box is the same size as the target, and the longer sides are horizontal. portrait Overrides the target's orientation. The page box is the same size as the target, and the shorter sides are horizontal. Example(s): In the following example, the outer edges of the page box will align with the target. The percentage value on the 'margin' property is relative to the target size so if the target sheet dimensions are 21.0cm x 29.7cm (i.e., A4), the margins are 2.10cm and 2.97cm. @page { size: auto; /* auto is the initial value */ margin: 10%; } Length values for the 'size' property create an absolute page box. If only one length value is specified, it sets both the width and height of the page box (i.e., the box is a square). Since the page box is the initial containing block , percentage values are not allowed for the 'size' property. Example(s): For example: @page { size: 8.5in 11in; /* width height */ } The above example set the width of the page box to be 8.5in and the height to be 11in. The page box in this example requires a target sheet size of 8.5&quot;x11&quot; or larger. User agents may allow users to control the transfer of the page box to the sheet (e.g., rotating an absolute page box that's being printed). Rendering page boxes that do not fit a target sheet If a page box does not fit the target sheet dimensions, the user agent may choose to: Rotate the page box 90° if this will make the page box fit. Scale the page to fit the target. The user agent should consult the user before performing these operations. Positioning the page box on the sheet When the page box is smaller than the target size, the user agent is free</del><ins>properties are relative</ins> to  <del>place</del><ins>the dimensions of</ins> the <a
+the margin properties  <del>are relative to the dimensions of the page box ; for left and right margins, they refer to page box width while for top and bottom margins, they refer to page box height. All other units associated with the respective CSS2 properties are allowed. Due to negative margin values (either on the page box or on elements) or absolute positioning content may end up outside the page box, but this content may be "cut" -- by the user agent, the printer, or ultimately, the paper cutter. 13.2.2 Page size : the 'size' property 'size' Value: &nbsp;&nbsp; &lt;length&gt; {1,2} | auto | portrait | landscape | inherit Initial: &nbsp;&nbsp; auto Applies to: &nbsp;&nbsp; the page context Inherited: &nbsp;&nbsp; N/A Percentages: &nbsp;&nbsp; N/A Media: &nbsp;&nbsp; visual , paged This property specifies the size and orientation of a page box. 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. Three values for the 'size' property create a relative page box: auto The page box will be set to the size and orientation of the target sheet. landscape Overrides the target's orientation. The page box is the same size as the target, and the longer sides are horizontal. portrait Overrides the target's orientation. The page box is the same size as the target, and the shorter sides are horizontal. Example(s): In the following example, the outer edges of the page box will align with the target. The percentage value on the 'margin' property is relative to the target size so if the target sheet dimensions are 21.0cm x 29.7cm (i.e., A4), the margins are 2.10cm and 2.97cm. @page { size: auto; /* auto is the initial value */ margin: 10%; } Length values for the 'size' property create an absolute page box. If only one length value is specified, it sets both the width and height of the page box (i.e., the box is a square). Since the page box is the initial containing block , percentage values are not allowed for the 'size' property. Example(s): For example: @page { size: 8.5in 11in; /* width height */ } The above example set the width of the page box to be 8.5in and the height to be 11in. The page box in this example requires a target sheet size of 8.5&quot;x11&quot; or larger. User agents may allow users to control the transfer of the page box to the sheet (e.g., rotating an absolute page box that's being printed). Rendering page boxes that do not fit a target sheet If a page box does not fit the target sheet dimensions, the user agent may choose to: Rotate the page box 90° if this will make the page box fit. Scale the page to fit the target. The user agent should consult the user before performing these operations. Positioning the page box on the sheet When the page box is smaller than the target size, the user agent is free</del><ins>are relative</ins> to  <del>place</del><ins>the dimensions of</ins> the <a
 href="#page-box">page box</a> <del>anywhere on</del><ins>; for left and right margins, they refer
 to</ins> the  <del>sheet. However, it is recommended that</del><ins>width of</ins> the page box  <del>be centered on the sheet since this will align double-sided pages</del><ins>while for top</ins> and  <del>avoid accidental loss of information that is printed near</del><ins>bottom margins, they
 refer to</ins> the  <del>edge</del><ins>height</ins> of the  <del>sheet. 13.2.3 Crop marks : the 'marks' property 'marks' Value: &nbsp;&nbsp; [ crop || cross ] | none | inherit Initial: &nbsp;&nbsp; none Applies to: &nbsp;&nbsp; page context Inherited: &nbsp;&nbsp; N/A Percentages: &nbsp;&nbsp; N/A Media: &nbsp;&nbsp; visual , paged In high-quality printing, marks are often added outside the</del>page box.  <del>This property specifies whether cross marks or crop marks or both should be rendered just outside the page box edge. Crop marks indicate where</del><ins>All other units associated with</ins>