From c28dd01b0cf3b8fdeeb01ec343fc1d41fe9fef26 Mon Sep 17 00:00:00 2001
From: Jeremias Maerki <jeremias@apache.org>
Date: Sun, 11 Dec 2005 09:59:24 +0000
Subject: [PATCH] XSL 1.1 Bookmarks added to the compliance page. Some more
 details on the upgrading page.

git-svn-id: https://svn.apache.org/repos/asf/xmlgraphics/fop/trunk@355950 13f79535-47bb-0310-9956-ffa450edef68
---
 .../content/xdocs/compliance.ihtml            | 74 +++++++++++++++++++
 .../content/xdocs/trunk/upgrading.xml         | 12 ++-
 2 files changed, 82 insertions(+), 4 deletions(-)

diff --git a/src/documentation/content/xdocs/compliance.ihtml b/src/documentation/content/xdocs/compliance.ihtml
index 8eab058e3..045082c45 100644
--- a/src/documentation/content/xdocs/compliance.ihtml
+++ b/src/documentation/content/xdocs/compliance.ihtml
@@ -58,6 +58,9 @@
     <li>
       <strong><a href="#fo-object-link-section">Link and Multi Formatting Objects</a>: </strong><a href="#fo-object-basic-link">basic-link</a>, <a href="#fo-object-multi-switch">multi-switch</a>, <a href="#fo-object-multi-case">multi-case</a>, <a href="#fo-object-multi-toggle">multi-toggle</a>, <a href="#fo-object-multi-properties">multi-properties</a>, <a href="#fo-object-multi-property-set">multi-property-set</a>
     </li>
+    <li>
+      <strong><a href="#fo-object-bookmarks-section">Formatting Objects for Bookmarks</a>: </strong><a href="#fo-object-bookmark-tree">bookmark-tree</a>, <a href="#fo-object-bookmark">bookmark</a>, <a href="#fo-object-bookmark-title">bookmark-title</a>
+    </li>
     <li>
       <strong><a href="#fo-object-outofline-section">Out-of-line Formatting Objects</a>: </strong><a href="#fo-object-float">float</a>, <a href="#fo-object-footnote">footnote</a>, <a href="#fo-object-footnote-body">footnote-body</a>
     </li>
@@ -1241,6 +1244,77 @@
         &nbsp;
       </td>
     </tr>
+    <tr>
+      <td class="category" colspan="6">
+        <a name="fo-object-bookmarks-section">Formatting Objects for Bookmarks</a> (<a href="http://www.w3.org/TR/xsl11/#d0e14085">&sect;6.11 in XSL 1.1 WD</a>)
+      </td>
+    </tr>
+    <tr>
+      <td>
+        <a name="fo-object-bookmark-tree">bookmark-tree</a> (since XSL 1.1)
+      </td>
+      <td class="extended">
+        Extended
+      </td>
+      <td align="center">
+        <a href="http://www.w3.org/TR/xsl11/#fo_bookmark-tree">&sect;6.11.1 in XSL 1.1 WD</a>
+      </td>
+      <td class="no">
+        no
+      </td>
+      <td class="yes">
+        yes
+      </td>
+      <td align="left">
+        <ul>
+          <li>[0.20.5] Uses the proprietary fox:outline extension.</li>
+        </ul>
+      </td>
+    </tr>
+    <tr>
+      <td>
+        <a name="fo-object-bookmark">bookmark</a> (since XSL 1.1)
+      </td>
+      <td class="extended">
+        Extended
+      </td>
+      <td align="center">
+        <a href="http://www.w3.org/TR/xsl11/#fo_bookmark">&sect;6.11.2 in XSL 1.1 WD</a>
+      </td>
+      <td class="no">
+        no
+      </td>
+      <td class="yes">
+        yes
+      </td>
+      <td align="left">
+        <ul>
+          <li>[0.20.5] Uses the proprietary fox:outline extension.</li>
+        </ul>
+      </td>
+    </tr>
+    <tr>
+      <td>
+        <a name="fo-object-bookmark-title">bookmark-title</a> (since XSL 1.1)
+      </td>
+      <td class="extended">
+        Extended
+      </td>
+      <td align="center">
+        <a href="http://www.w3.org/TR/xsl11/#fo_bookmark-title">&sect;6.11.3 in XSL 1.1 WD</a>
+      </td>
+      <td class="no">
+        no
+      </td>
+      <td class="yes">
+        yes
+      </td>
+      <td align="left">
+        <ul>
+          <li>[0.20.5] Uses the proprietary fox:outline extension.</li>
+        </ul>
+      </td>
+    </tr>
     <tr>
       <td class="category" colspan="6">
         <a name="fo-object-outofline-section">Out-of-line Formatting Objects</a> (<a href="http://www.w3.org/TR/xsl/slice6.html#section-N18509-Out-of-Line-Formatting-Objects">&sect;6.10</a>)
diff --git a/src/documentation/content/xdocs/trunk/upgrading.xml b/src/documentation/content/xdocs/trunk/upgrading.xml
index a41b82ba2..5b3496943 100644
--- a/src/documentation/content/xdocs/trunk/upgrading.xml
+++ b/src/documentation/content/xdocs/trunk/upgrading.xml
@@ -53,7 +53,7 @@
           </note>
         </li>
         <li>
-          Extensions written for version 0.20.5 will not work with the new code!
+          Extensions and Renderers written for version 0.20.5 will not work with the new code!
         </li>
         <li>
           The PCL Renderer and the MIF Handler have not been resurrected, yet! They are currently non-functional
@@ -88,13 +88,17 @@
         </li>
         <li>
           As stated above empty table cells <code>&lt;fo:table-cell&gt;&lt;/fo:table-cell&gt;</code>
-          are not allowed.
+          are not allowed by the specification.
         </li>
         <li>
-          0.20.5 is not XSL-FO compliant with respect to sizing images or <code>instream-foreign-object</code>
+          0.20.5 is not XSL-FO compliant with respect to sizing images (<code>external-graphic</code>) 
+          or <code>instream-foreign-object</code>
           objects. If images or SVGs are sized differently in your outputs with the new FOP version
           check <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=37136">Bug 37136</a>
-          as it contains some hints on what to.
+          as it contains some hints on what to. The file 
+          <a href="http://svn.apache.org/viewcvs.cgi/xmlgraphics/fop/trunk/examples/fo/basic/images.fo?view=markup">
+          <code>"examples/fo/basic/images.fo"</code></a> has
+          a number of good examples that shows the new, more correct behaviour.
         </li>
         <li>
           The <code>fox:outline</code> extension not implemented in this version anymore. 
-- 
2.39.5