machine-generated version

Author: howcom

css3-gcpm/Overview.html

@@ -21,13 +21,13 @@
 
    <h1>CSS Generated Content for Paged Media Module</h1>
 
-   <h2 class="no-num no-toc" id=w3c-working>Editor's Draft 16 August 2012</h2>
+   <h2 class="no-num no-toc" id=w3c-working>Editor's Draft 17 August 2012</h2>
 
    <dl>
     <dt>This version:
 
     <dd><a
-     href="http://www.w3.org/TR/2012/ED-css3-gcpm-20120816/">http://www.w3.org/TR/2012/ED-css3-gcpm-20120816/</a>
+     href="http://www.w3.org/TR/2012/ED-css3-gcpm-20120817/">http://www.w3.org/TR/2012/ED-css3-gcpm-20120817/</a>
 
     <dt>Latest version:
 
@@ -2478,8 +2478,7 @@ <h2 id=bookmarks><span class=secno>7. </span>Bookmarks</h2>
     <tr>
      <td><em>Value:</em>
 
-     <td>[ contents | content-before | content-element | content-after |
-      &lt;string> ]+ | none
+     <td>[ &lt;content-list> ]+ | none
 
     <tr>
      <td><em>Initial:</em>
@@ -2513,8 +2512,8 @@ <h2 id=bookmarks><span class=secno>7. </span>Bookmarks</h2>
   </table>
 
   <p>This property specifies the label of the bookmark, i.e., the text that
-   will represent the bookmark in the bookmark structure. The keyword values
-   are defined on the ‘<a href="#string-set"><code
+   will represent the bookmark in the bookmark structure. &lt;content-list>
+   is defined on the ‘<a href="#string-set"><code
    class=property>string-set</code></a>’ property.
 
   <div class=example>
@@ -2963,16 +2962,44 @@ <h2 id=page-and-column-floats><span class=secno>12. </span>Page and column
    <dd>similar to ‘<code class=property>top-corner</code>’, exept the box
     is floated to the bottom
 
-   <dt>snap
+   <dt>snap(&lt;length>)
 
    <dd>same as ‘<code class=property>top</code>’ if the box is naturally
     near the top; same as ‘<code class=property>bottom</code>’ if the box
-    is naturally near the bottom. The ‘<code
-    class=property>widows</code>’/‘<code class=property>orphans</code>’
-    properties may be consulted to determine if the box is near the
-    top/bottom. If the box naturally leads to a (page/column) break, the box
-    is floated to the top of the next page/column.
+    is naturally near the bottom. If the box naturally leads to a
+    (page/column) break, the box is floated to the top of the next
+    page/column. The length value specifies how far from the top/bottom the
+    element can be influenced.
+    <div class=example>
+     <p>In this example, tables will snap to the top/bottom if the top/bottom
+      of the border box is closer than ‘<code class=css>3em</code>’ from
+      the top/bottom of the page/column.
+
+     <pre>
+table { float: snap(3em) }
+</pre>
+    </div>
+
+    <p>If the functional notation is not used, an implementation-dependent
+     value is used.
+
+    <div class=example>
+     <pre>
+table { float: snap }
+</pre>
+    </div>
+
+    <p class=issue>Should we define a reasonable default (say, 3em) instead
+     of relying on implementation-specific values?
+
+    <p class=issue>Do numberic values make sense, like for orphans/widows
+
+    <p class=issue>Does the "snap" solution address all use cases for
+     "unless-room"/"unless-fit"?
   </dl>
+  <!--
+The 'widows'/'orphans' properties may be consulted to determine if the box is near the top/bottom. 
+-->
 
   <p>These new keywords only apply in paged media; in continous media
    declarations with these keywords are ignored.
@@ -4132,8 +4159,7 @@ <h2 class=no-num id=property-index>Property index</h2>
     <tr>
      <th><a class=property href="#bookmark-label">bookmark-label</a>
 
-     <td>[ contents | content-before | content-element | content-after |
-      &lt;string> ]+ | none
+     <td>[ &lt;content-list> ]+ | none
 
      <td>none