Skip to content

Commit bb9093a

Browse files
SimonSapinSimonSapin
committed
[css3-page] Deduplicate and clarify Page Properties and related appendix.
1 parent c412fad commit bb9093a

2 files changed

Lines changed: 79 additions & 214 deletions

File tree

‎css3-page/Overview.html‎

Lines changed: 43 additions & 153 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@
99
rel=dcterms.rights>
1010
<meta content=" CSS Paged Media Module Level 3" name=dcterms.title>
1111
<meta content=text name=dcterms.type>
12-
<meta content=2013-02-24 name=dcterms.issued>
12+
<meta content=2013-02-25 name=dcterms.issued>
1313
<meta content="Melinda Grant" name=dcterms.creator>
1414
<meta content="Håkon Wium Lie" name=dcterms.creator>
1515
<meta content="Elika J. Etemad" name=dcterms.creator>
@@ -100,15 +100,15 @@
100100
<h1 class=p-name>CSS Paged Media Module Level 3</h1>
101101

102102
<h2 class="no-num no-toc" id=w3c-working>Editor's Draft <span
103-
class=dt-updated><span class=value-title title=20130224>24 February
103+
class=dt-updated><span class=value-title title=20130225>25 February
104104
2013</span></span></h2>
105105

106106
<dl>
107107
<dt>This version:
108108

109109
<dd><a class=u-url
110110
href="http://dev.w3.org/csswg/css3-page/">http://dev.w3.org/csswg/css3-page/</a></dd>
111-
<!-- <dd><a class="u-url" href="http://dev.w3.org/csswg/css3-page/">http://www.w3.org/TR/2013/WD-css3-page-20130224</a></dd> -->
111+
<!-- <dd><a class="u-url" href="http://dev.w3.org/csswg/css3-page/">http://www.w3.org/TR/2013/WD-css3-page-20130225</a></dd> -->
112112

113113
<dt>Latest version:
114114

@@ -219,7 +219,7 @@ <h2 class="no-num no-toc" id=status>Status of this Document</h2>
219219
<p>This document contains the <abbr
220220
title="Cascading Style Sheets">CSS3</abbr> Paged Media Module W3C Last
221221
Call <a href="/2005/10/Process-20051014/tr.html#RecsWD">Working Draft</a>
222-
of 24 February 2013. The Last Call period ends on <span
222+
of 25 February 2013. The Last Call period ends on <span
223223
class=fudge>TBD</span>.
224224

225225
<p>Expected next revision to this document is another LCWD, due to the
@@ -357,13 +357,11 @@ <h2 class="no-num no-toc" id=contents>Table of Contents</h2>
357357
<li class=no-num><a href="#properties-list">Appendix A: Applicable CSS2.1
358358
Properties</a>
359359
<ul class=toc>
360-
<li class=no-num><a
361-
href="#properties-that-apply-within-the-page-co">Properties that apply
362-
within the page context</a>
360+
<li class=no-num><a href="#page-property-list"> CSS 2.1 Properties that
361+
apply within the page context</a>
363362

364-
<li class=no-num><a
365-
href="#properties-that-apply-within-the-margin-">Properties that apply
366-
within the margin contexts</a>
363+
<li class=no-num><a href="#margin-property-list"> CSS 2.1 properties
364+
that apply within the margin contexts</a>
367365
</ul>
368366

369367
<li class=no-num><a href="#transfer-possibilities">Appendix B: Transfer
@@ -1917,130 +1915,33 @@ <h3 id=margin-box-ex><span class=secno>6.4. </span>Page-margin box
19171915
<h2 id=page-properties><span class=secno>7. </span>Page Properties</h2>
19181916

19191917
<div>
1920-
<p>The following properties, when used in the <a
1921-
href="#page-context">page context</a>, apply to the page box:
1922-
1923-
<ul>
1924-
<li><a
1925-
href="http://www.w3.org/TR/CSS21/colors.html#background-properties">background
1926-
properties</a>
1927-
1928-
<li><a
1929-
href="http://www.w3.org/TR/CSS21/box.html#border-properties">border
1930-
properties</a>
1931-
1932-
<li><a
1933-
href="http://www.w3.org/TR/CSS21/colors.html#propdef-color">color</a>
1934-
1935-
<li><a href="http://www.w3.org/TR/CSS21/generate.html#counters">counter
1936-
properties</a>
1937-
1938-
<li><a
1939-
href="http://www.w3.org/TR/CSS21/visuren.html#direction">direction</a>
1940-
1941-
<li><a href="http://www.w3.org/TR/CSS21/fonts.html">font properties</a>
1942-
1943-
<li><a
1944-
href="http://www.w3.org/TR/CSS21/visudet.html#line-height">line-height</a>
1945-
1946-
<li><a
1947-
href="http://www.w3.org/TR/CSS21/box.html#margin-properties">margin
1948-
properties</a>
1949-
1950-
<li><a
1951-
href="http://www.w3.org/TR/CSS21/ui.html#dynamic-outlines">outline
1952-
properties</a>
1953-
1954-
<li><a
1955-
href="http://www.w3.org/TR/CSS21/box.html#padding-properties">padding
1956-
properties</a>
1957-
1958-
<li><a
1959-
href="http://www.w3.org/TR/CSS21/generate.html#quotes-specify">quotes</a>
1960-
1961-
<li><a href="#page-size">size</a>
1962-
1963-
<li><a href="http://www.w3.org/TR/CSS21/text.html">text properties</a>
1964-
1965-
<li><a
1966-
href="http://www.w3.org/TR/CSS21/visufx.html#visibility">visibility</a>
1967-
</ul>
1968-
1969-
<p>The following properties, when used in a <a
1970-
href="#margin-at-rule">margin context</a>, apply to page-margin boxes
1971-
and their content:
1972-
1973-
<ul>
1974-
<li><a
1975-
href="http://www.w3.org/TR/CSS21/colors.html#background-properties">background
1976-
properties</a>
1977-
1978-
<li><a
1979-
href="http://www.w3.org/TR/CSS21/box.html#border-properties">border
1980-
properties</a>
1981-
1982-
<li><a
1983-
href="http://www.w3.org/TR/CSS21/colors.html#propdef-color">color</a>
1984-
1985-
<li><a
1986-
href="http://www.w3.org/TR/CSS21/generate.html#content">content</a>
1987-
1988-
<li><a href="http://www.w3.org/TR/CSS21/generate.html#counters">counter
1989-
properties</a>
1990-
1991-
<li><a href="http://www.w3.org/TR/CSS21/fonts.html">font properties</a>
1992-
1993-
<li><a
1994-
href="http://www.w3.org/TR/CSS21/visudet.html#the-height-property">height</a>
1995-
<a
1996-
href="http://www.w3.org/TR/CSS21/visudet.html#min-max-heights">properties</a>
1997-
1998-
<li><a
1999-
href="http://www.w3.org/TR/CSS21/visudet.html#line-height">line-height</a>
2000-
2001-
<li><a
2002-
href="http://www.w3.org/TR/CSS21/box.html#margin-properties">margin
2003-
properties</a>
2004-
2005-
<li><a
2006-
href="http://www.w3.org/TR/CSS21/ui.html#dynamic-outlines">outline
2007-
properties</a>
2008-
2009-
<li><a
2010-
href="http://www.w3.org/TR/CSS21/visufx.html#overflow">overflow</a>
2011-
2012-
<li><a
2013-
href="http://www.w3.org/TR/CSS21/box.html#padding-properties">padding
2014-
properties</a>
2015-
2016-
<li><a
2017-
href="http://www.w3.org/TR/CSS21/generate.html#quotes-specify">quotes</a>
2018-
2019-
<li><a href="http://www.w3.org/TR/CSS21/text.html">text properties</a>
2020-
2021-
<li><a
2022-
href="http://www.w3.org/TR/CSS21/visudet.html#line-height">vertical-align</a>
2023-
2024-
<li><a
2025-
href="http://www.w3.org/TR/CSS21/visufx.html#visibility">visibility</a>
2026-
2027-
<li><a
2028-
href="http://www.w3.org/TR/CSS21/visudet.html#the-width-property">width</a>
2029-
<a
2030-
href="http://www.w3.org/TR/CSS21/visudet.html#min-max-widths">properties</a>
2031-
2032-
<li><a
2033-
href="http://www.w3.org/TR/CSS21/visuren.html#z-index">z-index</a>
2034-
</ul>
2035-
2036-
<p>A detailed list of properties that <em class=RFC2119>MUST</em> be
2037-
supported within page and margin contexts by a conforming implementation
2038-
can be found in <a href="#properties-list">Appendix A</a>.
2039-
2040-
<p>Other properties defined by <a href="#CSS21"
1918+
<p> <a href="#properties-list">Appendix A</a> defines the normative list
1919+
of CSS 2.1 <a href="#CSS21" rel=biblioentry>[CSS21]<!--{{!CSS21}}--></a>
1920+
<a href="#page-property-list">properties that apply to page boxes</a>.
1921+
If a conforming user agent supports any of these properties on block
1922+
boxes, then it <em class=RFC2119>MUST</em> also support that property in
1923+
the <a href="#page-context"><i>page context</i></a>. This specification
1924+
also defines the ‘<a href="#size"><code
1925+
class=property>size</code></a>’ property that only applies in the page
1926+
context.
1927+
1928+
<p> Properties that apply to the page-margin boxes can also be set within
1929+
the page context: if inheritable or explicitly inherited (with the
1930+
‘<code class=css>inherit</code>’ keyword in the margin context),
1931+
they will inherit to the page-margin boxes.
1932+
1933+
<p> The same appendix defines the normative list of CSS 2.1 <a
1934+
href="#CSS21" rel=biblioentry>[CSS21]<!--{{!CSS21}}--></a> <a
1935+
href="#page-property-list">properties that apply to page-margin
1936+
boxes</a>. If a conforming user agent supports any of these properties
1937+
on block boxes, then it <em class=RFC2119>MUST</em> also support that
1938+
property in the <a href="#margin-context"><i>margin context</i></a>
1939+
(except for <code>z-index</code>, which is optional for page-margin
1940+
boxes.)
1941+
1942+
<p> Other properties defined by <a href="#CSS21"
20411943
rel=biblioentry>[CSS21]<!--{{!CSS21}}--></a> do not apply in these
2042-
contexts. Behavior for properties not included in CSS 2.1 and not listed
2043-
here or in Appendix A is undefined.
1944+
contexts. Behavior for properties not included in CSS 2.1 is undefined.
20441945

20451946
<p class=note> Note: The intent of leaving other properties undefined is
20461947
to allow the gradual addition of appropriate CSS3 properties as they
@@ -2879,13 +2780,11 @@ <h2 id=image-properties><span class=secno>10. </span>Image Properties</h2>
28792780
<h2 class=no-num id=properties-list>Appendix A: Applicable CSS2.1
28802781
Properties</h2>
28812782

2882-
<h3 class=no-num id=properties-that-apply-within-the-page-co>Properties
2883-
that apply within the page context</h3>
2783+
<h3 class=no-num id=page-property-list> CSS 2.1 Properties that apply
2784+
within the page context</h3>
28842785

2885-
<p>The following CSS 2.1 <a href="#CSS21"
2886-
rel=biblioentry>[CSS21]<!--{{!CSS21}}--></a> properties apply to the
2887-
page box. If a conforming user agent supports any of these properties on
2888-
block boxes, then it must also support that property for the page box.
2786+
<p> This list is described in the <a href="#page-properties">Page
2787+
Properties</a> section.
28892788

28902789
<table class=property-list>
28912790
<tbody>
@@ -3150,20 +3049,11 @@ <h3 class=no-num id=properties-that-apply-within-the-page-co>Properties
31503049
<td>max-width
31513050
</table>
31523051

3153-
<p>Properties that apply to the page-margin boxes can also be set within
3154-
the page context: if inheritable or explicitly inherited (with the
3155-
<code>inherit</code> keyword in the margin context), they will inherit
3156-
to the page-margin boxes.
3157-
3158-
<h3 class=no-num id=properties-that-apply-within-the-margin->Properties
3159-
that apply within the margin contexts</h3>
3160-
3161-
<p>The following CSS 2.1 <a href="#CSS21"
3162-
rel=biblioentry>[CSS21]<!--{{!CSS21}}--></a> properties apply to
3163-
page-margin boxes. If a conforming user agents supports any of these
3164-
properties on block boxes, then it must also support that property for
3165-
page-margin boxes (except for <code>z-index</code>, which is optional
3166-
for page-margin boxes).
3052+
<h3 class=no-num id=margin-property-list> CSS 2.1 properties that apply
3053+
within the margin contexts</h3>
3054+
3055+
<p> This list is described in the <a href="#page-properties">Page
3056+
Properties</a> section.
31673057

31683058
<table class=property-list>
31693059
<tbody>

‎css3-page/Overview.src.html‎

Lines changed: 36 additions & 61 deletions
Original file line numberDiff line numberDiff line change
@@ -1489,57 +1489,35 @@ <h3 id="margin-box-ex">Page-margin box examples</h3>
14891489
<h2 id="page-properties">Page Properties</h2>
14901490
<div>
14911491

1492-
<p>The following properties, when used in the <a href="#page-context">page
1493-
context</a>, apply to the page box:</p>
1494-
1495-
<ul>
1496-
<li><a href="http://www.w3.org/TR/CSS21/colors.html#background-properties">background properties</a></li>
1497-
<li><a href="http://www.w3.org/TR/CSS21/box.html#border-properties">border properties</a></li>
1498-
<li><a href="http://www.w3.org/TR/CSS21/colors.html#propdef-color">color</a></li>
1499-
<li><a href="http://www.w3.org/TR/CSS21/generate.html#counters">counter properties</a></li>
1500-
<li><a href="http://www.w3.org/TR/CSS21/visuren.html#direction">direction</a>
1501-
<li><a href="http://www.w3.org/TR/CSS21/fonts.html">font properties</a></li>
1502-
<li><a href="http://www.w3.org/TR/CSS21/visudet.html#line-height">line-height</a></li>
1503-
<li><a href="http://www.w3.org/TR/CSS21/box.html#margin-properties">margin properties</a></li>
1504-
<li><a href="http://www.w3.org/TR/CSS21/ui.html#dynamic-outlines">outline properties</a>
1505-
<li><a href="http://www.w3.org/TR/CSS21/box.html#padding-properties">padding properties</a></li>
1506-
<li><a href="http://www.w3.org/TR/CSS21/generate.html#quotes-specify">quotes</a>
1507-
<li><a href="#page-size">size</a></li>
1508-
<li><a href="http://www.w3.org/TR/CSS21/text.html">text properties</a></li>
1509-
<li><a href="http://www.w3.org/TR/CSS21/visufx.html#visibility">visibility</a></li>
1510-
</ul>
1511-
1512-
<p>The following properties, when used in a <a href="#margin-at-rule">margin
1513-
context</a>, apply to page-margin boxes and their content:</p>
1492+
<p>
1493+
<a href="#properties-list">Appendix A</a> defines the normative list of
1494+
CSS 2.1 [[!CSS21]]
1495+
<a href="#page-property-list">properties that apply to page boxes</a>.
1496+
If a conforming user agent supports any of these properties on block boxes,
1497+
then it <em class="RFC2119">MUST</em> also support that property
1498+
in the <i>page context</i>.
1499+
This specification additionally defines the 'size' property
1500+
that only applies in the page context.
15141501

1515-
<ul>
1516-
<li><a href="http://www.w3.org/TR/CSS21/colors.html#background-properties">background properties</a>
1517-
<li><a href="http://www.w3.org/TR/CSS21/box.html#border-properties">border properties</a>
1518-
<li><a href="http://www.w3.org/TR/CSS21/colors.html#propdef-color">color</a>
1519-
<li><a href="http://www.w3.org/TR/CSS21/generate.html#content">content</a>
1520-
<li><a href="http://www.w3.org/TR/CSS21/generate.html#counters">counter properties</a></li>
1521-
<li><a href="http://www.w3.org/TR/CSS21/fonts.html">font properties</a>
1522-
<li><a href="http://www.w3.org/TR/CSS21/visudet.html#the-height-property">height</a> <a href="http://www.w3.org/TR/CSS21/visudet.html#min-max-heights">properties</a>
1523-
<li><a href="http://www.w3.org/TR/CSS21/visudet.html#line-height">line-height</a>
1524-
<li><a href="http://www.w3.org/TR/CSS21/box.html#margin-properties">margin properties</a>
1525-
<li><a href="http://www.w3.org/TR/CSS21/ui.html#dynamic-outlines">outline properties</a>
1526-
<li><a href="http://www.w3.org/TR/CSS21/visufx.html#overflow">overflow</a>
1527-
<li><a href="http://www.w3.org/TR/CSS21/box.html#padding-properties">padding properties</a>
1528-
<li><a href="http://www.w3.org/TR/CSS21/generate.html#quotes-specify">quotes</a>
1529-
<li><a href="http://www.w3.org/TR/CSS21/text.html">text properties</a>
1530-
<li><a href="http://www.w3.org/TR/CSS21/visudet.html#line-height">vertical-align</a>
1531-
<li><a href="http://www.w3.org/TR/CSS21/visufx.html#visibility">visibility</a>
1532-
<li><a href="http://www.w3.org/TR/CSS21/visudet.html#the-width-property">width</a> <a href="http://www.w3.org/TR/CSS21/visudet.html#min-max-widths">properties</a>
1533-
<li><a href="http://www.w3.org/TR/CSS21/visuren.html#z-index">z-index</a>
1534-
</ul>
1502+
<p>
1503+
Properties that apply to the page-margin boxes can also be set
1504+
within the page context:
1505+
if inheritable or explicitly inherited
1506+
(with the ''inherit'' keyword in the margin context),
1507+
they will inherit to the page-margin boxes.
15351508

1536-
<p>A detailed list of properties that <em class="RFC2119">MUST</em> be supported
1537-
within page and margin contexts by a conforming implementation can be found in
1538-
<a href="#properties-list">Appendix A</a>.</p>
1509+
<p>
1510+
The same appendix defines the normative list of
1511+
CSS 2.1 [[!CSS21]]
1512+
<a href="#page-property-list">properties that apply to page-margin boxes</a>.
1513+
If a conforming user agent supports any of these properties on block boxes,
1514+
then it <em class="RFC2119">MUST</em> also support that property
1515+
in the <i>margin context</i>
1516+
(except for <code>z-index</code>, which is optional for page-margin boxes.)
15391517

1540-
<p>Other properties defined by [[!CSS21]] do not apply in these contexts. Behavior
1541-
for properties not included in CSS 2.1 and not listed here or in Appendix A is
1542-
undefined.</p>
1518+
<p>
1519+
Other properties defined by [[!CSS21]] do not apply in these contexts.
1520+
Behavior for properties not included in CSS 2.1 is undefined.
15431521

15441522
<p class="note">
15451523
Note: The intent of leaving other properties undefined is to allow the gradual
@@ -2227,11 +2205,12 @@ <h2 id="image-properties">Image Properties</h2>
22272205

22282206
<h2 class="no-num" id="properties-list">Appendix A: Applicable CSS2.1 Properties</h2>
22292207

2230-
<h3 class="no-num">Properties that apply within the page context</h3>
2208+
<h3 class="no-num" id="page-property-list">
2209+
CSS 2.1 Properties that apply within the page context</h3>
22312210

2232-
<p>The following CSS 2.1 [[!CSS21]] properties apply to the page box.
2233-
If a conforming user agent supports any of these properties on block
2234-
boxes, then it must also support that property for the page box.</p>
2211+
<p>
2212+
This list is described in the
2213+
<a href="#page-properties">Page Properties</a> section.
22352214

22362215
<table class="property-list">
22372216
<tbody>
@@ -2328,17 +2307,13 @@ <h3 class="no-num">Properties that apply within the page context</h3>
23282307
<tr><td>max-width
23292308
</table>
23302309

2331-
<p>Properties that apply to the page-margin boxes can also be set within
2332-
the page context: if inheritable or explicitly inherited (with the
2333-
<code>inherit</code> keyword in the margin context), they will inherit
2334-
to the page-margin boxes.</p>
23352310

2336-
<h3 class="no-num">Properties that apply within the margin contexts</h3>
2311+
<h3 class="no-num" id="margin-property-list">
2312+
CSS 2.1 properties that apply within the margin contexts</h3>
23372313

2338-
<p>The following CSS 2.1 [[!CSS21]] properties apply to page-margin boxes.
2339-
If a conforming user agents supports any of these properties on block
2340-
boxes, then it must also support that property for page-margin boxes (except
2341-
for <code>z-index</code>, which is optional for page-margin boxes).</p>
2314+
<p>
2315+
This list is described in the
2316+
<a href="#page-properties">Page Properties</a> section.
23422317

23432318
<table class="property-list">
23442319
<tbody>

0 commit comments

Comments
 (0)