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 17 August 2012</h2>
+   <h2 class="no-num no-toc" id=w3c-working>Editor's Draft 22 August 2012</h2>
 
    <dl>
     <dt>This version:
 
     <dd><a
-     href="http://www.w3.org/TR/2012/ED-css3-gcpm-20120817/">http://www.w3.org/TR/2012/ED-css3-gcpm-20120817/</a>
+     href="http://www.w3.org/TR/2012/ED-css3-gcpm-20120822/">http://www.w3.org/TR/2012/ED-css3-gcpm-20120822/</a>
 
     <dt>Latest version:
 
@@ -193,7 +193,8 @@ <h2 class="no-num no-toc" id=table-of-contents><a name=contents>Table of
    <li><a href="#page-marks-and-bleed-area"><span class=secno>6. </span>Page
     marks and bleed area</a>
 
-   <li><a href="#bookmarks"><span class=secno>7. </span>Bookmarks</a>
+   <li><a href="#bookmarks-bookmark-level-"><span class=secno>7.
+    </span>Bookmarks: ‘<code class=property>bookmark-level</code>’, </a>
 
    <li><a href="#cmyk-colors"><span class=secno>8. </span>CMYK colors</a>
 
@@ -486,9 +487,8 @@ <h4 id=setting-named-strings-the-string-set-pro><span class=secno>2.1.1.
   <p>The name space of named strings is different from other sets of names in
    CSS.
 
-  <p>The ‘<a href="#string-set"><code
-   class=property>string-set</code></a>’ property copies text as well as
-   white-space into the named string.
+  <p>The textual content is processed as if ‘<code class=css>white-space:
+   normal</code>’ had been set.
 
   <div class=example>
    <pre>
@@ -2402,13 +2402,18 @@ <h2 id=page-marks-and-bleed-area><span class=secno>6. </span>Page marks and
   <p>This property specifies the extent of the page bleed area outside the
    page box. This property only has effect if crop marks are enabled.
 
-  <h2 id=bookmarks><span class=secno>7. </span>Bookmarks</h2>
+  <h2 id=bookmarks-bookmark-level-><span class=secno>7. </span>Bookmarks:
+   ‘<a href="#bookmark-level"><code
+   class=property>bookmark-level</code></a>’,</h2>
 
   <p>Some document formats have the capability of holding bookmarks.
-   Bookmarks are typically shown outside the document itself, often a
-   tree-structured and clickable table of contents to help navigate in the
-   electronic version of the document. To generate bookmarks, these
-   properties are defined:
+   Bookmarks are typically shown outside the document itself, often in a
+   tree-structured and clickable table of contents. To generate bookmarks,
+   these properties are defined: ‘<a href="#bookmark-level"><code
+   class=property>bookmark-level</code></a>’, ‘<a
+   href="#bookmark-label"><code class=property>bookmark-label</code></a>’,
+   and ‘<a href="#bookmark-state"><code
+   class=property>bookmark-state</code></a>’.
 
   <table class=propdef>
    <tbody>
@@ -2454,9 +2459,21 @@ <h2 id=bookmarks><span class=secno>7. </span>Bookmarks</h2>
   </table>
 
   <p>This property describes what level a certain bookmark has in a
-   hierarchical bookmark structure. The highest level is ‘<code
-   class=css>1</code>’, then ‘<code class=css>2</code>’, ‘<code
-   class=css>3</code>’ etc.
+   hierarchical bookmark structure. The values are:
+
+  <dl>
+   <dt>none
+
+   <dd>no bookmark is generated
+
+   <dt>&lt;integer>
+
+   <dd>Indicates the level of the bookmark; the highest level is ‘<code
+    class=css>1</code>’, then ‘<code class=css>2</code>’, ‘<code
+    class=css>3</code>’ etc. A bookmark will be generated only if ‘<a
+    href="#bookmark-label"><code class=property>bookmark-label</code></a>’
+    also has a value different from ‘<code class=property>none</code>’.
+  </dl>
 
   <div class=example>
    <pre>
@@ -2476,7 +2493,7 @@ <h2 id=bookmarks><span class=secno>7. </span>Bookmarks</h2>
     <tr>
      <td><em>Value:</em>
 
-     <td>[ &lt;content-list> ]+ | none
+     <td>&lt;content-list> | none
 
     <tr>
      <td><em>Initial:</em>
@@ -2510,9 +2527,19 @@ <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. &lt;content-list>
-   is defined on the ‘<a href="#string-set"><code
-   class=property>string-set</code></a>’ property.
+   will represent the bookmark in the bookmark structure. The values are:
+
+  <dl>
+   <dt>&lt;content-list>, as defined on the ‘<a href="#string-set"><code
+    class=property>string-set</code></a>’ property. A bookmark will be
+    generated only if ‘<a href="#bookmark-level"><code
+    class=property>bookmark-level</code></a>’ also has a value different
+    from ‘<code class=property>none</code>’.
+
+   <dt>none
+
+   <dd>no bookmark is generated
+  </dl>
 
   <div class=example>
    <pre>
@@ -2523,66 +2550,53 @@ <h2 id=bookmarks><span class=secno>7. </span>Bookmarks</h2>
 #frog { bookmark-label: "The green frog" }
 </pre>
   </div>
+  <!--
 
-  <table class=propdef>
-   <tbody>
+<table class=propdef>
     <tr>
-     <td><em>Name:</em>
-
-     <td><dfn id=bookmark-target>bookmark-target</dfn>
-
+      <td><em>Name:</em>
+      <td><dfn>bookmark-target</dfn>
     <tr>
-     <td><em>Value:</em>
-
-     <td>none | &lt;uri>
-
+      <td><em>Value:</em>
+      <td>none | &lt;uri> 
     <tr>
-     <td><em>Initial:</em>
-
-     <td>none
-
+      <td><em>Initial:</em>
+      <td>none
     <tr>
-     <td><em>Applies to:</em>
-
-     <td>all elements
-
+      <td><em>Applies to:</em>
+      <td>all elements
     <tr>
-     <td><em>Inherited:</em>
-
-     <td>no
-
+      <td><em>Inherited:</em>
+      <td>no
     <tr>
-     <td><em>Percentages:</em>
-
-     <td>N/A
-
+      <td><em>Percentages:</em>
+      <td>N/A
     <tr>
-     <td><em>Media:</em>
-
-     <td>all
-
+      <td><em>Media:</em>
+      <td>all
     <tr>
-     <td><em>Computed value:</em>
-
-     <td>For URI values, the absolute URI; for ‘<code
-      class=property>none</code>’, as specified.
-  </table>
+      <td><em>Computed value:</em>
+      <td>For URI values, the absolute URI; for 'none', as specified.
+</table>
 
-  <p>This property specifies the target of the bookmark link.
+<p>This property specifies the target of the bookmark link. 
 
-  <div class=example>
-   <pre>
+<div class=example>
+<pre>
 .bookmark {
    bookmark-label: attr(title);
    bookmark-target: attr(href url);
 }
 ...
 &lt;a class="bookmark" title="The green pear" href="#pears"/>
 </pre>
-  </div>
+</div>
 
-  <div class=example> .example { bookmark-target: url(http://www.example.com)
-   }</div>
+<div class=example>
+.example { bookmark-target: url(http://www.example.com) }
+</div>
+
+-->
 
   <table class=propdef>
    <tbody>
@@ -2960,44 +2974,57 @@ <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(&lt;length>)
+   <dt>snap(&lt;length>, [top | bottom])
 
    <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. 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.
+    page/column. The first optionaloptional length value specifies how far
+    from the top/bottom the element can be influenced, The second
 
-     <pre>
-table { float: snap(3em) }
-</pre>
-    </div>
+   <dt>snap(&lt;length> &lt;length>? [, top | bottom | near ]?)
 
-    <p>If the functional notation is not used, an implementation-dependent
-     value is used.
+   <dd>Makes the element float to the top or bottom if it naturally appears
+    within a certain distance from the top or bottom. The length value(s)
+    specifies the maxium distance from the top/bottom that an element must be
+    within in order to be floated; one length value specifies the distance
+    from both the top and the bottom, two length values specify the distance
+    from the top and bottom, respectively. If an element is within the
+    specified distance from both the top and the bottom, bottom wins.
+    <p>The optional keyword value specifies where the element is floated:
+     top, bottom, or the nearest of the two. The initial value is ‘<code
+     class=property>near</code>’.
 
-    <div class=example>
-     <pre>
+   <dt>snap
+
+   <dd>same as <tt>snap(2em, near)</tt>
+  </dl>
+
+  <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 }
+table { float: snap(3em) }
+table { float: snap(3em, bottom) }
+table { float: snap(3em 2em, bottom) }
 </pre>
-    </div>
+  </div>
 
-    <p class=issue>Should we define a reasonable default (say, 3em) instead
-     of relying on implementation-specific values?
+  <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>Do numberic values (in addition to length values) make
+   sense, like for orphans/widows
 
-    <p class=issue>Does the "snap" solution address all use cases for
-     "unless-room"/"unless-fit"?
-  </dl>
-  <!--
+  <p class=issue>is an element with a snap() value considered to be a float?
+   only when it really floats, or always? <!--
 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.
@@ -4027,7 +4054,8 @@ <h2 class=no-num id=acknowledgments>Acknowledgments</h2>
    Duga, Del Merritt, Ladd Van Tol, Tab Atkins Jr., Jacob Grundtvig Refstrup,
    James Elmore, Ian Tindale, Murakami Shinyu, Paul E. Merrell, Philip
    Taylor, Brad Kemper, Peter Linss, Daniel Glazman, Tantek Çelik, Florian
-   Rivoal, Alex Mogilevsky.
+   Rivoal, Alex Mogilevsky, Simon Sapin, Cameron McCormack, Liam R E Quin,
+   Werner Donné, Peter Moulder.
 
   <h2 class=no-num id=references>References</h2>
 
@@ -4096,9 +4124,6 @@ <h2 class=no-num id=index>Index</h2>
    <li>bookmark-state, <a href="#bookmark-state"
     title=bookmark-state><strong>7.</strong></a>
 
-   <li>bookmark-target, <a href="#bookmark-target"
-    title=bookmark-target><strong>7.</strong></a>
-
    <li>clear-side, <a href="#clear-side"
     title=clear-side><strong>14.3.</strong></a>
 
@@ -4157,7 +4182,7 @@ <h2 class=no-num id=property-index>Property index</h2>
     <tr>
      <th><a class=property href="#bookmark-label">bookmark-label</a>
 
-     <td>[ &lt;content-list> ]+ | none
+     <td>&lt;content-list> | none
 
      <td>none
 
@@ -4199,21 +4224,6 @@ <h2 class=no-num id=property-index>Property index</h2>
 
      <td>all
 
-    <tr>
-     <th><a class=property href="#bookmark-target">bookmark-target</a>
-
-     <td>none | &lt;uri>
-
-     <td>none
-
-     <td>all elements
-
-     <td>no
-
-     <td>N/A
-
-     <td>all
-
     <tr>
      <th><a class=property href="#clear-side">clear-side</a>