[css3-page] Deduplicate and clarify Page Properties and related appendix.

Mon, 25 Feb 2013 01:11:04 +0100

author
Simon Sapin <simon.sapin@exyr.org>
date
Mon, 25 Feb 2013 01:11:04 +0100
changeset 7573
76b534d18604
parent 7572
16a0d63c8707
child 7574
2d7ea6fcd855

[css3-page] Deduplicate and clarify Page Properties and related appendix.

css3-page/Overview.html file | annotate | diff | comparison | revisions
css3-page/Overview.src.html file | annotate | diff | comparison | revisions
     1.1 --- a/css3-page/Overview.html	Mon Feb 25 00:12:06 2013 +0100
     1.2 +++ b/css3-page/Overview.html	Mon Feb 25 01:11:04 2013 +0100
     1.3 @@ -9,7 +9,7 @@
     1.4     rel=dcterms.rights>
     1.5    <meta content=" CSS Paged Media Module Level 3" name=dcterms.title>
     1.6    <meta content=text name=dcterms.type>
     1.7 -  <meta content=2013-02-24 name=dcterms.issued>
     1.8 +  <meta content=2013-02-25 name=dcterms.issued>
     1.9    <meta content="Melinda Grant" name=dcterms.creator>
    1.10    <meta content="Håkon Wium Lie" name=dcterms.creator>
    1.11    <meta content="Elika J. Etemad" name=dcterms.creator>
    1.12 @@ -100,7 +100,7 @@
    1.13      <h1 class=p-name>CSS Paged Media Module Level 3</h1>
    1.14  
    1.15      <h2 class="no-num no-toc" id=w3c-working>Editor's Draft <span
    1.16 -     class=dt-updated><span class=value-title title=20130224>24 February
    1.17 +     class=dt-updated><span class=value-title title=20130225>25 February
    1.18       2013</span></span></h2>
    1.19  
    1.20      <dl>
    1.21 @@ -108,7 +108,7 @@
    1.22  
    1.23       <dd><a class=u-url
    1.24        href="http://dev.w3.org/csswg/css3-page/">http://dev.w3.org/csswg/css3-page/</a></dd>
    1.25 -     <!-- <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> -->
    1.26 +     <!-- <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> -->
    1.27  
    1.28       <dt>Latest version:
    1.29  
    1.30 @@ -219,7 +219,7 @@
    1.31     <p>This document contains the <abbr
    1.32      title="Cascading Style Sheets">CSS3</abbr> Paged Media Module W3C Last
    1.33      Call <a href="/2005/10/Process-20051014/tr.html#RecsWD">Working Draft</a>
    1.34 -    of 24 February 2013. The Last Call period ends on <span
    1.35 +    of 25 February 2013. The Last Call period ends on <span
    1.36      class=fudge>TBD</span>.
    1.37  
    1.38     <p>Expected next revision to this document is another LCWD, due to the
    1.39 @@ -357,13 +357,11 @@
    1.40      <li class=no-num><a href="#properties-list">Appendix A: Applicable CSS2.1
    1.41       Properties</a>
    1.42       <ul class=toc>
    1.43 -      <li class=no-num><a
    1.44 -       href="#properties-that-apply-within-the-page-co">Properties that apply
    1.45 -       within the page context</a>
    1.46 -
    1.47 -      <li class=no-num><a
    1.48 -       href="#properties-that-apply-within-the-margin-">Properties that apply
    1.49 -       within the margin contexts</a>
    1.50 +      <li class=no-num><a href="#page-property-list"> CSS 2.1 Properties that
    1.51 +       apply within the page context</a>
    1.52 +
    1.53 +      <li class=no-num><a href="#margin-property-list"> CSS 2.1 properties
    1.54 +       that apply within the margin contexts</a>
    1.55       </ul>
    1.56  
    1.57      <li class=no-num><a href="#transfer-possibilities">Appendix B: Transfer
    1.58 @@ -1917,130 +1915,33 @@
    1.59     <h2 id=page-properties><span class=secno>7. </span>Page Properties</h2>
    1.60  
    1.61     <div>
    1.62 -    <p>The following properties, when used in the <a
    1.63 -     href="#page-context">page context</a>, apply to the page box:
    1.64 -
    1.65 -    <ul>
    1.66 -     <li><a
    1.67 -      href="http://www.w3.org/TR/CSS21/colors.html#background-properties">background
    1.68 -      properties</a>
    1.69 -
    1.70 -     <li><a
    1.71 -      href="http://www.w3.org/TR/CSS21/box.html#border-properties">border
    1.72 -      properties</a>
    1.73 -
    1.74 -     <li><a
    1.75 -      href="http://www.w3.org/TR/CSS21/colors.html#propdef-color">color</a>
    1.76 -
    1.77 -     <li><a href="http://www.w3.org/TR/CSS21/generate.html#counters">counter
    1.78 -      properties</a>
    1.79 -
    1.80 -     <li><a
    1.81 -      href="http://www.w3.org/TR/CSS21/visuren.html#direction">direction</a>
    1.82 -
    1.83 -     <li><a href="http://www.w3.org/TR/CSS21/fonts.html">font properties</a>
    1.84 -
    1.85 -     <li><a
    1.86 -      href="http://www.w3.org/TR/CSS21/visudet.html#line-height">line-height</a>
    1.87 -
    1.88 -     <li><a
    1.89 -      href="http://www.w3.org/TR/CSS21/box.html#margin-properties">margin
    1.90 -      properties</a>
    1.91 -
    1.92 -     <li><a
    1.93 -      href="http://www.w3.org/TR/CSS21/ui.html#dynamic-outlines">outline
    1.94 -      properties</a>
    1.95 -
    1.96 -     <li><a
    1.97 -      href="http://www.w3.org/TR/CSS21/box.html#padding-properties">padding
    1.98 -      properties</a>
    1.99 -
   1.100 -     <li><a
   1.101 -      href="http://www.w3.org/TR/CSS21/generate.html#quotes-specify">quotes</a>
   1.102 -
   1.103 -     <li><a href="#page-size">size</a>
   1.104 -
   1.105 -     <li><a href="http://www.w3.org/TR/CSS21/text.html">text properties</a>
   1.106 -
   1.107 -     <li><a
   1.108 -      href="http://www.w3.org/TR/CSS21/visufx.html#visibility">visibility</a>
   1.109 -    </ul>
   1.110 -
   1.111 -    <p>The following properties, when used in a <a
   1.112 -     href="#margin-at-rule">margin context</a>, apply to page-margin boxes
   1.113 -     and their content:
   1.114 -
   1.115 -    <ul>
   1.116 -     <li><a
   1.117 -      href="http://www.w3.org/TR/CSS21/colors.html#background-properties">background
   1.118 -      properties</a>
   1.119 -
   1.120 -     <li><a
   1.121 -      href="http://www.w3.org/TR/CSS21/box.html#border-properties">border
   1.122 -      properties</a>
   1.123 -
   1.124 -     <li><a
   1.125 -      href="http://www.w3.org/TR/CSS21/colors.html#propdef-color">color</a>
   1.126 -
   1.127 -     <li><a
   1.128 -      href="http://www.w3.org/TR/CSS21/generate.html#content">content</a>
   1.129 -
   1.130 -     <li><a href="http://www.w3.org/TR/CSS21/generate.html#counters">counter
   1.131 -      properties</a>
   1.132 -
   1.133 -     <li><a href="http://www.w3.org/TR/CSS21/fonts.html">font properties</a>
   1.134 -
   1.135 -     <li><a
   1.136 -      href="http://www.w3.org/TR/CSS21/visudet.html#the-height-property">height</a>
   1.137 -      <a
   1.138 -      href="http://www.w3.org/TR/CSS21/visudet.html#min-max-heights">properties</a>
   1.139 -
   1.140 -     <li><a
   1.141 -      href="http://www.w3.org/TR/CSS21/visudet.html#line-height">line-height</a>
   1.142 -
   1.143 -     <li><a
   1.144 -      href="http://www.w3.org/TR/CSS21/box.html#margin-properties">margin
   1.145 -      properties</a>
   1.146 -
   1.147 -     <li><a
   1.148 -      href="http://www.w3.org/TR/CSS21/ui.html#dynamic-outlines">outline
   1.149 -      properties</a>
   1.150 -
   1.151 -     <li><a
   1.152 -      href="http://www.w3.org/TR/CSS21/visufx.html#overflow">overflow</a>
   1.153 -
   1.154 -     <li><a
   1.155 -      href="http://www.w3.org/TR/CSS21/box.html#padding-properties">padding
   1.156 -      properties</a>
   1.157 -
   1.158 -     <li><a
   1.159 -      href="http://www.w3.org/TR/CSS21/generate.html#quotes-specify">quotes</a>
   1.160 -
   1.161 -     <li><a href="http://www.w3.org/TR/CSS21/text.html">text properties</a>
   1.162 -
   1.163 -     <li><a
   1.164 -      href="http://www.w3.org/TR/CSS21/visudet.html#line-height">vertical-align</a>
   1.165 -
   1.166 -     <li><a
   1.167 -      href="http://www.w3.org/TR/CSS21/visufx.html#visibility">visibility</a>
   1.168 -
   1.169 -     <li><a
   1.170 -      href="http://www.w3.org/TR/CSS21/visudet.html#the-width-property">width</a>
   1.171 -      <a
   1.172 -      href="http://www.w3.org/TR/CSS21/visudet.html#min-max-widths">properties</a>
   1.173 -
   1.174 -     <li><a
   1.175 -      href="http://www.w3.org/TR/CSS21/visuren.html#z-index">z-index</a>
   1.176 -    </ul>
   1.177 -
   1.178 -    <p>A detailed list of properties that <em class=RFC2119>MUST</em> be
   1.179 -     supported within page and margin contexts by a conforming implementation
   1.180 -     can be found in <a href="#properties-list">Appendix A</a>.
   1.181 -
   1.182 -    <p>Other properties defined by <a href="#CSS21"
   1.183 +    <p> <a href="#properties-list">Appendix A</a> defines the normative list
   1.184 +     of CSS 2.1 <a href="#CSS21" rel=biblioentry>[CSS21]<!--{{!CSS21}}--></a>
   1.185 +     <a href="#page-property-list">properties that apply to page boxes</a>.
   1.186 +     If a conforming user agent supports any of these properties on block
   1.187 +     boxes, then it <em class=RFC2119>MUST</em> also support that property in
   1.188 +     the <a href="#page-context"><i>page context</i></a>. This specification
   1.189 +     also defines the ‘<a href="#size"><code
   1.190 +     class=property>size</code></a>’ property that only applies in the page
   1.191 +     context.
   1.192 +
   1.193 +    <p> Properties that apply to the page-margin boxes can also be set within
   1.194 +     the page context: if inheritable or explicitly inherited (with the
   1.195 +     ‘<code class=css>inherit</code>’ keyword in the margin context),
   1.196 +     they will inherit to the page-margin boxes.
   1.197 +
   1.198 +    <p> The same appendix defines the normative list of CSS 2.1 <a
   1.199 +     href="#CSS21" rel=biblioentry>[CSS21]<!--{{!CSS21}}--></a> <a
   1.200 +     href="#page-property-list">properties that apply to page-margin
   1.201 +     boxes</a>. If a conforming user agent supports any of these properties
   1.202 +     on block boxes, then it <em class=RFC2119>MUST</em> also support that
   1.203 +     property in the <a href="#margin-context"><i>margin context</i></a>
   1.204 +     (except for <code>z-index</code>, which is optional for page-margin
   1.205 +     boxes.)
   1.206 +
   1.207 +    <p> Other properties defined by <a href="#CSS21"
   1.208       rel=biblioentry>[CSS21]<!--{{!CSS21}}--></a> do not apply in these
   1.209 -     contexts. Behavior for properties not included in CSS 2.1 and not listed
   1.210 -     here or in Appendix A is undefined.
   1.211 +     contexts. Behavior for properties not included in CSS 2.1 is undefined.
   1.212  
   1.213      <p class=note> Note: The intent of leaving other properties undefined is
   1.214       to allow the gradual addition of appropriate CSS3 properties as they
   1.215 @@ -2879,13 +2780,11 @@
   1.216      <h2 class=no-num id=properties-list>Appendix A: Applicable CSS2.1
   1.217       Properties</h2>
   1.218  
   1.219 -    <h3 class=no-num id=properties-that-apply-within-the-page-co>Properties
   1.220 -     that apply within the page context</h3>
   1.221 -
   1.222 -    <p>The following CSS 2.1 <a href="#CSS21"
   1.223 -     rel=biblioentry>[CSS21]<!--{{!CSS21}}--></a> properties apply to the
   1.224 -     page box. If a conforming user agent supports any of these properties on
   1.225 -     block boxes, then it must also support that property for the page box.
   1.226 +    <h3 class=no-num id=page-property-list> CSS 2.1 Properties that apply
   1.227 +     within the page context</h3>
   1.228 +
   1.229 +    <p> This list is described in the <a href="#page-properties">Page
   1.230 +     Properties</a> section.
   1.231  
   1.232      <table class=property-list>
   1.233       <tbody>
   1.234 @@ -3150,20 +3049,11 @@
   1.235         <td>max-width
   1.236      </table>
   1.237  
   1.238 -    <p>Properties that apply to the page-margin boxes can also be set within
   1.239 -     the page context: if inheritable or explicitly inherited (with the
   1.240 -     <code>inherit</code> keyword in the margin context), they will inherit
   1.241 -     to the page-margin boxes.
   1.242 -
   1.243 -    <h3 class=no-num id=properties-that-apply-within-the-margin->Properties
   1.244 -     that apply within the margin contexts</h3>
   1.245 -
   1.246 -    <p>The following CSS 2.1 <a href="#CSS21"
   1.247 -     rel=biblioentry>[CSS21]<!--{{!CSS21}}--></a> properties apply to
   1.248 -     page-margin boxes. If a conforming user agents supports any of these
   1.249 -     properties on block boxes, then it must also support that property for
   1.250 -     page-margin boxes (except for <code>z-index</code>, which is optional
   1.251 -     for page-margin boxes).
   1.252 +    <h3 class=no-num id=margin-property-list> CSS 2.1 properties that apply
   1.253 +     within the margin contexts</h3>
   1.254 +
   1.255 +    <p> This list is described in the <a href="#page-properties">Page
   1.256 +     Properties</a> section.
   1.257  
   1.258      <table class=property-list>
   1.259       <tbody>
     2.1 --- a/css3-page/Overview.src.html	Mon Feb 25 00:12:06 2013 +0100
     2.2 +++ b/css3-page/Overview.src.html	Mon Feb 25 01:11:04 2013 +0100
     2.3 @@ -1489,57 +1489,35 @@
     2.4  <h2 id="page-properties">Page Properties</h2>
     2.5  <div>
     2.6  
     2.7 -<p>The following properties, when used in the <a href="#page-context">page
     2.8 -context</a>, apply to the page box:</p>
     2.9 +<p>
    2.10 +  <a href="#properties-list">Appendix A</a> defines the normative list of
    2.11 +  CSS 2.1 [[!CSS21]]
    2.12 +  <a href="#page-property-list">properties that apply to page boxes</a>.
    2.13 +  If a conforming user agent supports any of these properties on block boxes,
    2.14 +  then it <em class="RFC2119">MUST</em> also support that property
    2.15 +  in the <i>page context</i>.
    2.16 +  This specification additionally defines the 'size' property
    2.17 +  that only applies in the page context.
    2.18  
    2.19 -<ul>
    2.20 -  <li><a href="http://www.w3.org/TR/CSS21/colors.html#background-properties">background properties</a></li>
    2.21 -  <li><a href="http://www.w3.org/TR/CSS21/box.html#border-properties">border properties</a></li>
    2.22 -  <li><a href="http://www.w3.org/TR/CSS21/colors.html#propdef-color">color</a></li>
    2.23 -  <li><a href="http://www.w3.org/TR/CSS21/generate.html#counters">counter properties</a></li>
    2.24 -  <li><a href="http://www.w3.org/TR/CSS21/visuren.html#direction">direction</a>
    2.25 -  <li><a href="http://www.w3.org/TR/CSS21/fonts.html">font properties</a></li>
    2.26 -  <li><a href="http://www.w3.org/TR/CSS21/visudet.html#line-height">line-height</a></li>
    2.27 -  <li><a href="http://www.w3.org/TR/CSS21/box.html#margin-properties">margin properties</a></li>
    2.28 -  <li><a href="http://www.w3.org/TR/CSS21/ui.html#dynamic-outlines">outline properties</a>
    2.29 -  <li><a href="http://www.w3.org/TR/CSS21/box.html#padding-properties">padding properties</a></li>
    2.30 -  <li><a href="http://www.w3.org/TR/CSS21/generate.html#quotes-specify">quotes</a>
    2.31 -  <li><a href="#page-size">size</a></li>
    2.32 -  <li><a href="http://www.w3.org/TR/CSS21/text.html">text properties</a></li>
    2.33 -  <li><a href="http://www.w3.org/TR/CSS21/visufx.html#visibility">visibility</a></li>
    2.34 -</ul>
    2.35 +<p>
    2.36 +  Properties that apply to the page-margin boxes can also be set
    2.37 +  within the page context:
    2.38 +  if inheritable or explicitly inherited
    2.39 +  (with the ''inherit'' keyword in the margin context),
    2.40 +  they will inherit to the page-margin boxes.
    2.41  
    2.42 -<p>The following properties, when used in a <a href="#margin-at-rule">margin
    2.43 -context</a>, apply to page-margin boxes and their content:</p>
    2.44 +<p>
    2.45 +  The same appendix defines the normative list of
    2.46 +  CSS 2.1 [[!CSS21]]
    2.47 +  <a href="#page-property-list">properties that apply to page-margin boxes</a>.
    2.48 +  If a conforming user agent supports any of these properties on block boxes,
    2.49 +  then it <em class="RFC2119">MUST</em> also support that property
    2.50 +  in the <i>margin context</i>
    2.51 +  (except for <code>z-index</code>, which is optional for page-margin boxes.)
    2.52  
    2.53 -<ul>
    2.54 -  <li><a href="http://www.w3.org/TR/CSS21/colors.html#background-properties">background properties</a>
    2.55 -  <li><a href="http://www.w3.org/TR/CSS21/box.html#border-properties">border properties</a>
    2.56 -  <li><a href="http://www.w3.org/TR/CSS21/colors.html#propdef-color">color</a>
    2.57 -  <li><a href="http://www.w3.org/TR/CSS21/generate.html#content">content</a>
    2.58 -  <li><a href="http://www.w3.org/TR/CSS21/generate.html#counters">counter properties</a></li>
    2.59 -  <li><a href="http://www.w3.org/TR/CSS21/fonts.html">font properties</a>
    2.60 -  <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>
    2.61 -  <li><a href="http://www.w3.org/TR/CSS21/visudet.html#line-height">line-height</a>
    2.62 -  <li><a href="http://www.w3.org/TR/CSS21/box.html#margin-properties">margin properties</a>
    2.63 -  <li><a href="http://www.w3.org/TR/CSS21/ui.html#dynamic-outlines">outline properties</a>
    2.64 -  <li><a href="http://www.w3.org/TR/CSS21/visufx.html#overflow">overflow</a>
    2.65 -  <li><a href="http://www.w3.org/TR/CSS21/box.html#padding-properties">padding properties</a>
    2.66 -  <li><a href="http://www.w3.org/TR/CSS21/generate.html#quotes-specify">quotes</a>
    2.67 -  <li><a href="http://www.w3.org/TR/CSS21/text.html">text properties</a>
    2.68 -  <li><a href="http://www.w3.org/TR/CSS21/visudet.html#line-height">vertical-align</a>
    2.69 -  <li><a href="http://www.w3.org/TR/CSS21/visufx.html#visibility">visibility</a>
    2.70 -  <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>
    2.71 -  <li><a href="http://www.w3.org/TR/CSS21/visuren.html#z-index">z-index</a>
    2.72 -</ul>
    2.73 -
    2.74 -<p>A detailed list of properties that <em class="RFC2119">MUST</em> be supported
    2.75 -within page and margin contexts by a conforming implementation can be found in
    2.76 -<a href="#properties-list">Appendix A</a>.</p>
    2.77 -
    2.78 -<p>Other properties defined by [[!CSS21]] do not apply in these contexts. Behavior
    2.79 -for properties not included in CSS 2.1 and not listed here or in Appendix A is
    2.80 -undefined.</p>
    2.81 +<p>
    2.82 +  Other properties defined by [[!CSS21]] do not apply in these contexts.
    2.83 +  Behavior for properties not included in CSS 2.1 is undefined.
    2.84  
    2.85  <p class="note">
    2.86  Note: The intent of leaving other properties undefined is to allow the gradual
    2.87 @@ -2227,11 +2205,12 @@
    2.88  
    2.89  <h2 class="no-num" id="properties-list">Appendix A: Applicable CSS2.1 Properties</h2>
    2.90  
    2.91 -<h3 class="no-num">Properties that apply within the page context</h3>
    2.92 +<h3 class="no-num" id="page-property-list">
    2.93 +  CSS 2.1 Properties that apply within the page context</h3>
    2.94  
    2.95 -<p>The following CSS 2.1 [[!CSS21]] properties apply to the page box.
    2.96 -If a conforming user agent supports any of these properties on block
    2.97 -boxes, then it must also support that property for the page box.</p>
    2.98 +<p>
    2.99 +  This list is described in the
   2.100 +  <a href="#page-properties">Page Properties</a> section.
   2.101  
   2.102  <table class="property-list">
   2.103    <tbody>
   2.104 @@ -2328,17 +2307,13 @@
   2.105      <tr><td>max-width
   2.106  </table>
   2.107  
   2.108 -<p>Properties that apply to the page-margin boxes can also be set within
   2.109 -the page context: if inheritable or explicitly inherited (with the
   2.110 -<code>inherit</code> keyword in the margin context), they will inherit
   2.111 -to the page-margin boxes.</p>
   2.112  
   2.113 -<h3 class="no-num">Properties that apply within the margin contexts</h3>
   2.114 +<h3 class="no-num" id="margin-property-list">
   2.115 +  CSS 2.1 properties that apply within the margin contexts</h3>
   2.116  
   2.117 -<p>The following CSS 2.1 [[!CSS21]] properties apply to page-margin boxes.
   2.118 -If a conforming user agents supports any of these properties on block
   2.119 -boxes, then it must also support that property for page-margin boxes (except
   2.120 -for <code>z-index</code>, which is optional for page-margin boxes).</p>
   2.121 +<p>
   2.122 +  This list is described in the
   2.123 +  <a href="#page-properties">Page Properties</a> section.
   2.124  
   2.125  <table class="property-list">
   2.126    <tbody>

mercurial