change available-flow to available-content

Author: astearns

css3-page-template/Overview.html

@@ -239,11 +239,11 @@
 
    <h1>CSS Pagination Templates Module Level 3</h1>
 
-   <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 3 March 2012</h2>
+   <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 17 March 2012</h2>
 
    <dl>
     <dt>This version:
-     <!--<dd><a href="http://www.w3.org/TR/2012/ED-css3-page-template-20120303/">http://www.w3.org/TR/2012/ED-css3-page-template-20120303/</a>-->
+     <!--<dd><a href="http://www.w3.org/TR/2012/ED-css3-page-template-20120317/">http://www.w3.org/TR/2012/ED-css3-page-template-20120317/</a>-->
 
 
     <dd><a
@@ -344,32 +344,31 @@ <h2 class="no-num no-toc" id=contents>Table of contents</h2>
   <!--begin-toc-->
 
   <ul class=toc>
-   <li><a href="#intro"><span class=secno>1. </span> Introduction</a>
+   <li><a href="#intro"><span class=secno>1. </span>Introduction</a>
     <ul class=toc>
-     <li><a href="#placement"><span class=secno>1.1. </span> Module
+     <li><a href="#placement"><span class=secno>1.1. </span>Module
       Interactions</a>
     </ul>
 
-   <li><a href="#templates-and-slots"><span class=secno>2. </span> Pagination
+   <li><a href="#templates-and-slots"><span class=secno>2. </span>Pagination
     Templates and Slots</a>
 
-   <li><a href="#conditional-templates"><span class=secno>3. </span> Template
+   <li><a href="#conditional-templates"><span class=secno>3. </span>Template
     Selection</a>
     <ul class=toc>
-     <li><a href="#ordered-templates"><span class=secno>3.1. </span>
-      Selecting Templates by Page Order</a>
+     <li><a href="#ordered-templates"><span class=secno>3.1. </span>Selecting
+      Templates by Page Order</a>
 
      <li><a href="#selection-from-required-flows"><span class=secno>3.2.
-      </span> Selecting Templates from Required Flows</a>
+      </span>Selecting Templates from Required Flows</a>
 
      <li><a href="#selection-from-available-content"><span class=secno>3.3.
-      </span> Selecting Templates from Available Content</a>
+      </span>Selecting Templates from Available Content</a>
     </ul>
 
-   <li><a href="#cssom"><span class=secno>4. </span> CSS Object Model
-    Modifications</a>
+   <li><a href="#cssom"><span class=secno>4. </span>CSS Object Model</a>
 
-   <li><a href="#conformance"><span class=secno>5. </span> Conformance</a>
+   <li><a href="#conformance"><span class=secno>5. </span>Conformance</a>
 
    <li class=no-num><a href="#acknowledgments">Acknowledgments</a>
 
@@ -385,7 +384,7 @@ <h2 class="no-num no-toc" id=contents>Table of contents</h2>
   </ul>
   <!--end-toc-->
 
-  <h2 id=intro><span class=secno>1. </span> Introduction</h2>
+  <h2 id=intro><span class=secno>1. </span>Introduction</h2>
 
   <p><em>This section is not normative.</em>
 
@@ -430,7 +429,7 @@ <h2 id=intro><span class=secno>1. </span> Introduction</h2>
     are more helpful than onelook.com (which suggested "Captain Submarine").</div>
   </div>
 
-  <h3 id=placement><span class=secno>1.1. </span> Module Interactions</h3>
+  <h3 id=placement><span class=secno>1.1. </span>Module Interactions</h3>
 
   <p>This module uses named flows and region chains defined in <a
    href="#CSS3-REGIONS"
@@ -442,8 +441,8 @@ <h3 id=placement><span class=secno>1.1. </span> Module Interactions</h3>
   <p>Some examples use positioning from <a href="#CSS3GRID"
    rel=biblioentry>[CSS3GRID]<!--{{CSS3GRID}}--></a>.
 
-  <h2 id=templates-and-slots><span class=secno>2. </span> Pagination
-   Templates and Slots</h2>
+  <h2 id=templates-and-slots><span class=secno>2. </span>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
@@ -631,18 +630,17 @@ <h2 id=templates-and-slots><span class=secno>2. </span> Pagination
     </pre>
   </div>
 
-  <h2 id=conditional-templates><span class=secno>3. </span> Template
-   Selection</h2>
+  <h2 id=conditional-templates><span class=secno>3. </span>Template Selection</h2>
 
   <p>Multiple templates can be defined for a single document. An element that
    uses pagination templates either selects a template from the entire
    document set or a subset defined by the &lsquo;<code
    class=property>template-set</code>&rsquo; property. Each page view created
    uses a single template. This template can be chosen from the applicable
    set using a selector, by matching content to display using the
-   &lsquo;<code class=property>required-flow</code>&rsquo; and &lsquo;<code
-   class=property>available-flow</code>&rsquo; declarations, or just taking
-   the first template found.
+   &lsquo;<code class=property>required-flow</code>&rsquo; or &lsquo;<code
+   class=property>available-content</code>&rsquo; declarations, or just
+   taking the first template found.
 
   <div class=example>
    <p>In this example the divs are paginated using the first template found
@@ -682,7 +680,7 @@ <h2 id=conditional-templates><span class=secno>3. </span> Template
    </div>
   </div>
 
-  <h3 id=ordered-templates><span class=secno>3.1. </span> Selecting Templates
+  <h3 id=ordered-templates><span class=secno>3.1. </span>Selecting Templates
    by Page Order</h3>
 
   <p>Selectors such as :first can be used on a pagination template to define
@@ -734,8 +732,8 @@ <h3 id=ordered-templates><span class=secno>3.1. </span> Selecting Templates
    </div>
   </div>
 
-  <h3 id=selection-from-required-flows><span class=secno>3.2. </span>
-   Selecting Templates from Required Flows</h3>
+  <h3 id=selection-from-required-flows><span class=secno>3.2.
+   </span>Selecting Templates from Required Flows</h3>
 
   <p>The &lsquo;<code class=property>required-flow</code>&rsquo; property can
    be used in a pagination template to list named flows that must still have
@@ -807,37 +805,42 @@ <h3 id=selection-from-required-flows><span class=secno>3.2. </span>
     </pre>
   </div>
 
-  <h3 id=selection-from-available-content><span class=secno>3.3. </span>
-   Selecting Templates from Available Content</h3>
+  <h3 id=selection-from-available-content><span class=secno>3.3.
+   </span>Selecting Templates from Available Content</h3>
 
   <p>Pagination templates can be selected based on the order of content in
    the original markup. Content may be split out into one or more named
    flows, but the original order can be discovered in the markup.
 
   <p>Pagination templates have a &lsquo;<code
-   class=property>primary</code>&rsquo; content flow. The primary content for
-   a pagination template is usually the content of the paginated element. If
-   no slot displays the element contents, then the primary content of the
-   pagination template is the first named flow in its required-flow
+   class=property>primary</code>&rsquo; content flow. The primary flow for a
+   pagination template is usually the content of the paginated element. If no
+   slot in the template displays the element contents, then the primary flow
+   of the pagination template is the first named flow in its required-flow
    declaration.
 
   <p>When selecting the pagination template for the next page, the primary
-   content flow in the original markup can be scanned to determine whether
-   any out-of-flow content in named flows was originally related to the next
-   page of primary flow. If this is the case, then those named flows have
+   flow in the original markup can be scanned to determine whether any
+   out-of-flow content in named flows was originally related to the next page
+   of primary flow. If this is the case, then those named flows have
    &lsquo;<code class=property>available</code>&rsquo; content for the
    purpose of selecting an appropriate template that can display this
    content.
 
   <p>Pagination templates can have an &lsquo;<code
-   class=property>available-flow</code>&rsquo; declaration listing the named
-   flows that must have available content for the template to be selected. If
-   a template with an &lsquo;<code
-   class=property>available-flow</code>&rsquo; declaration is chosen, only
-   the available content in those flows is displayed in the slots associated
-   with those flows.
+   class=property>available-content</code>&rsquo; declaration listing the
+   named flows that must have available content for the template to be
+   selected. Templates with more &lsquo;<code
+   class=property>available-content</code>&rsquo; flow matches take
+   precedence over fewer or no &lsquo;<code
+   class=property>available-content</code>&rsquo; flow matches. If a template
+   with an &lsquo;<code class=property>available-content</code>&rsquo;
+   declaration is chosen, only the available content in those flows is
+   displayed in the slots associated with those flows.
 
   <div class=example>
+   <p>Clarification example
+
    <p>Consider an article element that contains images scattered throughout.
     Assign the images to a flow named &lsquo;<code
     class=property>images</code>&rsquo; and the rest of the article to a flow
@@ -849,20 +852,22 @@ <h3 id=selection-from-available-content><span class=secno>3.3. </span>
     &lsquo;<code class=property>text</code>&rsquo; flow, but the second
     template also requires the &lsquo;<code
     class=property>images</code>&rsquo; flow and has an &lsquo;<code
-    class=property>available-flow</code>&rsquo; declaration listing the
+    class=property>available-content</code>&rsquo; declaration listing the
     &lsquo;<code class=property>images</code>&rsquo; flow. Each time a page
     is laid out, the original article element is scanned to see whether an
     image element is in the next page's worth of content (determined by some
-    heuristic, not layout). If so, then that content from the &lsquo;<code
-    class=property>images</code>&rsquo; flow is available for the purpose of
-    selecting a template.
+    markup-scanning heuristic – not layout). If so, then that content from
+    the &lsquo;<code class=property>images</code>&rsquo; flow is available
+    for the purpose of selecting a template.
   </div>
 
   <div class=issue-marker>
    <div class=issue-details>Expand this.</div>
   </div>
 
   <div class=example>
+   <p>Motivational example
+
    <p>Assume you have an article that contains both pull quotes and images.
     If only images <em>or</em> pull quotes would occur on a page, position
     those elements in the center right of the template. But if both images
@@ -874,7 +879,7 @@ <h3 id=selection-from-available-content><span class=secno>3.3. </span>
    </div>
   </div>
 
-  <h2 id=cssom><span class=secno>4. </span> CSS Object Model Modifications</h2>
+  <h2 id=cssom><span class=secno>4. </span>CSS Object Model</h2>
 
   <div class=issue-marker>
    <div class=issue-details>There should be extensive OM defined to access
@@ -884,7 +889,7 @@ <h2 id=cssom><span class=secno>4. </span> CSS Object Model Modifications</h2>
     page should be determinable. Lots to fill out here.</div>
   </div>
 
-  <h2 id=conformance><span class=secno>5. </span> Conformance</h2>
+  <h2 id=conformance><span class=secno>5. </span>Conformance</h2>
 
   <h2 class=no-num id=acknowledgments>Acknowledgments</h2>