fixed typos and added www-style para

astearns · astearns · commit d742aa539bb3 · 2012-03-03T16:59:47.000Z
diff --git a/css3-page-template/Overview.html b/css3-page-template/Overview.html
@@ -223,8 +223,7 @@
               margin-right:0.8em;
               text-transform:uppercase;      
           }
-              .separate-pre {
-      --margin: 5%;
+    .separate-pre {
       background-color: rgba(0, 0, 0, 0.08);
     }
   </style>
@@ -305,10 +304,39 @@ <h2 class="no-num no-toc" id=abstract>Abstract</h2>
    until all of the content is displayed.
 
   <h2 class="no-num no-toc" id=status>Status of this document</h2>
-
-  <p><strong>This document is only an Editor's Draft. It has not yet been
-   adopted by the Working Group, and should not be considered to be part of
-   CSS.</strong>
+  <!--begin-status-->
+
+  <p>This is a public copy of the editors' draft. It is provided for
+   discussion only and may change at any moment. Its publication here does
+   not imply endorsement of its contents by W3C. Don't cite this document
+   other than as work in progress.
+
+  <p>The (<a
+   href="http://lists.w3.org/Archives/Public/www-style/">archived</a>) public
+   mailing list <a
+   href="mailto:www-style@w3.org?Subject=%5Bcss3-page-template%5D%20PUT%20SUBJECT%20HERE">
+   www-style@w3.org</a> (see <a
+   href="http://www.w3.org/Mail/Request">instructions</a>) is preferred for
+   discussion of this specification. When sending e-mail, please put the text
+   &#8220;css3-page-template&#8221; in the subject, preferably like this:
+   &#8220;[<!---->css3-page-template<!---->] <em>&hellip;summary of
+   comment&hellip;</em>&#8221;
+
+  <p>This document was produced by the <a href="/Style/CSS/members">CSS
+   Working Group</a> (part of the <a href="/Style/">Style Activity</a>).
+
+  <p>This document was produced by a group operating under the <a
+   href="/Consortium/Patent-Policy-20040205/">5 February 2004 W3C Patent
+   Policy</a>. W3C maintains a <a href="/2004/01/pp-impl/32061/status"
+   rel=disclosure>public list of any patent disclosures</a> made in
+   connection with the deliverables of the group; that page also includes
+   instructions for disclosing a patent. An individual who has actual
+   knowledge of a patent which the individual believes contains <a
+   href="/Consortium/Patent-Policy-20040205/#def-essential">Essential
+   Claim(s)</a> must disclose the information in accordance with <a
+   href="/Consortium/Patent-Policy-20040205/#sec-Disclosure">section 6 of the
+   W3C Patent Policy</a>.</p>
+  <!--end-status-->
 
   <p>The following features are at risk: none
 
@@ -408,7 +436,8 @@ <h3 id=placement><span class=secno>1.1. </span> Module Interactions</h3>
    href="#CSS3-REGIONS"
    rel=biblioentry>[CSS3-REGIONS]<!--{{CSS3-REGIONS}}--></a>.
 
-  <p>This module uses the overflow-style property from [[CSS3-GCPM]].
+  <p>This module uses the overflow-style property from <a href="#CSS3GCPM"
+   rel=biblioentry>[CSS3GCPM]<!--{{CSS3GCPM}}--></a>.
 
   <p>Some examples use positioning from <a href="#CSS3GRID"
    rel=biblioentry>[CSS3GRID]<!--{{CSS3GRID}}--></a>.
@@ -421,8 +450,8 @@ <h2 id=templates-and-slots><span class=secno>2. </span> Pagination
    pagination templates if its &lsquo;<code
    class=property>overflow-style</code>&rsquo; property is set to any of the
    paged-* values defined in css3-gcpm. If a document defines no pagination
-   templates, then there is an implicit paginated template with a single slot
-   containing the paginated element's contents.
+   templates, then there is an implicit pagination template with a single
+   slot containing the paginated element's contents.
 
   <div class=issue-marker>
    <div class=issue-details>Do pagination templates get their size (and other
@@ -431,13 +460,13 @@ <h2 id=templates-and-slots><span class=secno>2. </span> Pagination
     100%/100% size based on the element's box?</div>
   </div>
 
-  <p>A slot is an anonymous box in a paginated template where content can be
+  <p>A slot is an anonymous box in a pagination template where content can be
    placed. In an @template rule @slot rules create slots. The order of @slot
-   rules determines the order of the boxes in the paginated template. Each
+   rules determines the order of the boxes in the pagination template. Each
    @slot rule can take an optional name.
 
   <p>Slots default to displaying the content of the paginated element. Slots
-   can instead contain generated content assigned from the content property.
+   can instead contain generated content assigned with the content property.
    Slots can also be assigned content from named flows.
 
   <div class=example>
@@ -472,12 +501,12 @@ <h2 id=templates-and-slots><span class=secno>2. </span> Pagination
 
   <div class=example>
    <p>The simplest example takes all of the content in the document and flows
-    it into a single paginated template with a single slot. This template
+    it into a single pagination template with a single slot. This template
     will display a viewport's worth of content at a time, and will create a
     new slot on a new page each time content overflows.
 
    <p>The three examples below are equivalent, but merely illustrate how
-    content from the element can be assigned to paginated template slots.
+    content from the element can be assigned to pagination template slots.
     Actual use of templates would either define more slots or assign content
     differently than the default.
 
@@ -520,14 +549,14 @@ <h2 id=templates-and-slots><span class=secno>2. </span> Pagination
   </div>
 
   <div class=example>
-   <p>A paginated template could contain two side-by-side slots that paginate
-    two separate articles. Side-by-side translations are often laid out this
-    way. This example fills the left side of the paged view with content from
-    an English article and the right side with content from a French article.
-    New pages and slots are created until the content from both articles is
-    exhausted. If one article is longer than the other then in this simple
-    example template the longer article will continue taking up just its half
-    of the page.
+   <p>A pagination template could contain two side-by-side slots that
+    paginate two separate articles. Side-by-side translations are often laid
+    out this way. This example fills the left side of the paged view with
+    content from an English article and the right side with content from a
+    French article. New pages and slots are created until the content from
+    both articles is exhausted. If one article is longer than the other then
+    in this simple example template the longer article will continue taking
+    up just its half of the page.
 
    <p> <img alt="side-by-side flows on a page"
     src="images/side-by-side-1.png" width=120> <span
@@ -645,7 +674,7 @@ <h2 id=conditional-templates><span class=secno>3. </span> Template
    </div>
 
    <div class=issue-marker>
-    <div class=issue-details>One way of promoting re-use of paginated
+    <div class=issue-details>One way of promoting re-use of pagination
      templates would be to parameterize the named flow idents. Instead of
      using named flow idents directly, @slot rules could use a parameter and
      a paginated element using the template would pass in the particular
@@ -660,9 +689,9 @@ <h3 id=ordered-templates><span class=secno>3.1. </span> Selecting Templates
    a separate template for pages that match the selector.
 
   <div class=issue-marker>
-   <div class=issue-details>Should we use :left and :right and allow viewing
-    more than one page at a time in a viewport? Should we have :nth(x)
-    selectors?</div>
+   <div class=issue-details>Should :left and :right be allowed with a way of
+    displaying more than one page at a time in a viewport? Should :nth(x)
+    selectors be allowed?</div>
   </div>
 
   <div class=issue-marker>
@@ -922,6 +951,16 @@ <h3 class=no-num id=other-references>Other references</h3>
     </dd>
    <!---->
 
+   <dt id=CSS3GCPM>[CSS3GCPM]
+
+   <dd>H&#229;kon Wium Lie. <a
+    href="http://www.w3.org/TR/2010/WD-css3-gcpm-20100608"><cite>CSS
+    Generated Content for Paged Media Module.</cite></a> 8 June 2010. W3C
+    Working Draft. (Work in progress.) URL: <a
+    href="http://www.w3.org/TR/2010/WD-css3-gcpm-20100608">http://www.w3.org/TR/2010/WD-css3-gcpm-20100608</a>
+    </dd>
+   <!---->
+
    <dt id=CSS3GRID>[CSS3GRID]
 
    <dd>Alex Mogilevsky; Markus Mielke. <a
diff --git a/css3-page-template/Overview.src.html b/css3-page-template/Overview.src.html
@@ -223,8 +223,7 @@
               margin-right:0.8em;
               text-transform:uppercase;      
           }
-              .separate-pre {
-      --margin: 5%;
+    .separate-pre {
       background-color: rgba(0, 0, 0, 0.08);
     }
   </style>
@@ -275,9 +274,12 @@ <h2 class="no-num no-toc" id="abstract">Abstract</h2>
 
 <h2 class="no-num no-toc" id="status">Status of this document</h2>
 
-<p><strong>This document is only an Editor's Draft. It has not yet been adopted by the Working Group, and should not be considered to be part of CSS.</strong></p>
+<!--begin-status-->       
+  <p><strong>This document is only an Editor's Draft. It is provided for discussion only and may change at any moment. It has not yet been adopted by the Working Group, and should not be considered to be part of CSS.</strong>
 
-<p>The following features are at risk: none
+  <p>The archived public mailing list www-style@w3.org is preferred for discussion of this specification. When sending e-mail, please put the text "css3-page-template" in the subject, preferably like this: "[css3-page-template] …summary of comment…"
+<!--end-status-->
+  <p>The following features are at risk: none
 
 <h2 class="no-num no-toc" id="contents">Table of contents</h2>
 
@@ -302,19 +304,19 @@ <h3 id="placement">
 Module Interactions</h3>
 
   <p>This module uses named flows and region chains defined in [[CSS3-REGIONS]].
-  <p>This module uses the overflow-style property from [[CSS3-GCPM]].
+  <p>This module uses the overflow-style property from [[CSS3GCPM]].
   <p>Some examples use positioning from [[CSS3GRID]].
 
 <h2 id="templates-and-slots">
 Pagination Templates and Slots</h2>
 
-  <p>An @template rule defines a pagination template. Pagination templates contain one or more slots to display content. An element can use pagination templates if its 'overflow-style' property is set to any of the paged-* values defined in css3-gcpm. If a document defines no pagination templates, then there is an implicit paginated template with a single slot containing the paginated element's contents.
+  <p>An @template rule defines a pagination template. Pagination templates contain one or more slots to display content. An element can use pagination templates if its 'overflow-style' property is set to any of the paged-* values defined in css3-gcpm. If a document defines no pagination templates, then there is an implicit pagination template with a single slot containing the paginated element's contents.
 
   <div class="issue-marker"><div class="issue-details">Do pagination templates get their size (and other characteristics) from the element with the overflow-style property, or does this have be set in the @template rule? Can templates use a default 100%/100% size based on the element's box?</div></div>
 
-  <p>A slot is an anonymous box in a paginated template where content can be placed. In an @template rule @slot rules create slots. The order of @slot rules determines the order of the boxes in the paginated template. Each @slot rule can take an optional name.
+  <p>A slot is an anonymous box in a pagination template where content can be placed. In an @template rule @slot rules create slots. The order of @slot rules determines the order of the boxes in the pagination template. Each @slot rule can take an optional name.
 
-  <p>Slots default to displaying the content of the paginated element. Slots can instead contain generated content assigned from the content property. Slots can also be assigned content from named flows.
+  <p>Slots default to displaying the content of the paginated element. Slots can instead contain generated content assigned with the content property. Slots can also be assigned content from named flows.
 
   <div class='example'>
     <p>An @template rule that creates header and footer slots around the paginated element's content
@@ -332,9 +334,9 @@ <h2 id="templates-and-slots">
   <div class="issue-marker"><div class="issue-details">If there is more than one slot with no 'content' or 'flow-from' assignment, does the element's content use all of these slots like a region chain, or is only the last unassigned slot used for content?</div></div>
 
   <div class='example'>
-    <p>The simplest example takes all of the content in the document and flows it into a single paginated template with a single slot. This template will display a viewport's worth of content at a time, and will create a new slot on a new page each time content overflows.
+    <p>The simplest example takes all of the content in the document and flows it into a single pagination template with a single slot. This template will display a viewport's worth of content at a time, and will create a new slot on a new page each time content overflows.
 
-    <p>The three examples below are equivalent, but merely illustrate how content from the element can be assigned to paginated template slots. Actual use of templates would either define more slots or assign content differently than the default.
+    <p>The three examples below are equivalent, but merely illustrate how content from the element can be assigned to pagination template slots. Actual use of templates would either define more slots or assign content differently than the default.
 
     <pre class='separate-pre'>
     body { overflow-style: paged-x; }</pre>
@@ -358,7 +360,7 @@ <h2 id="templates-and-slots">
   <div class="issue-marker"><div class="issue-details">Is there a need to create more structure, nesting slots within slots? If so, then slots can also have layout method declarations?</div></div>
 
   <div class='example'>
-    <p>A paginated template could contain two side-by-side slots that paginate two separate articles. Side-by-side translations are often laid out this way. This example fills the left side of the paged view with content from an English article and the right side with content from a French article. New pages and slots are created until the content from both articles is exhausted. If one article is longer than the other then in this simple example template the longer article will continue taking up just its half of the page.
+    <p>A pagination template could contain two side-by-side slots that paginate two separate articles. Side-by-side translations are often laid out this way. This example fills the left side of the paged view with content from an English article and the right side with content from a French article. New pages and slots are created until the content from both articles is exhausted. If one article is longer than the other then in this simple example template the longer article will continue taking up just its half of the page.
     <p>
     <img src="images/side-by-side-1.png" width="120" alt="side-by-side flows on a page">
     <span style="font-size:50px">…</span>
@@ -450,15 +452,15 @@ <h2 id="conditional-templates">
 
   <div class="issue-marker wrapper">
   <div class="issue-marker"><div class="issue-details">Instead of specifying a template-set, should there be a way of scoping @template rules to an element? The reason to put them on the document is to re-use pagination templates with multiple elements.</div></div>
-  <div class="issue-marker"><div class="issue-details">One way of promoting re-use of paginated templates would be to parameterize the named flow idents. Instead of using named flow idents directly, @slot rules could use a parameter and a paginated element using the template would pass in the particular named flow ident meant for that parameter.</div></div>
+  <div class="issue-marker"><div class="issue-details">One way of promoting re-use of pagination templates would be to parameterize the named flow idents. Instead of using named flow idents directly, @slot rules could use a parameter and a paginated element using the template would pass in the particular named flow ident meant for that parameter.</div></div>
   </div>
   
 <h3 id='ordered-templates'>
 Selecting Templates by Page Order</h3>
 
   <p>Selectors such as :first can be used on a pagination template to define a separate template for pages that match the selector.
 
-  <div class="issue-marker"><div class="issue-details">Should we use :left and :right and allow viewing more than one page at a time in a viewport? Should we have :nth(x) selectors?</div></div>
+  <div class="issue-marker"><div class="issue-details">Should :left and :right be allowed with a way of displaying more than one page at a time in a viewport? Should :nth(x) selectors be allowed?</div></div>
 
   <div class="issue-marker"><div class="issue-details">Describe how @template rules with selectors cascade.</div></div>
 
