aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorManuel Mall <manuel@apache.org>2005-10-26 08:25:38 +0000
committerManuel Mall <manuel@apache.org>2005-10-26 08:25:38 +0000
commite1747c51b3eb53898fa9d1b455d9608619588155 (patch)
tree47ac795bf061214092443bb738748db42cee220f
parented18821511f2a5be10434072250e69dcf7fde171 (diff)
downloadxmlgraphics-fop-e1747c51b3eb53898fa9d1b455d9608619588155.tar.gz
xmlgraphics-fop-e1747c51b3eb53898fa9d1b455d9608619588155.zip
Update to Upgrading page
git-svn-id: https://svn.apache.org/repos/asf/xmlgraphics/fop/trunk@328588 13f79535-47bb-0310-9956-ffa450edef68
-rw-r--r--src/documentation/content/xdocs/trunk/upgrading.xml40
1 files changed, 39 insertions, 1 deletions
diff --git a/src/documentation/content/xdocs/trunk/upgrading.xml b/src/documentation/content/xdocs/trunk/upgrading.xml
index 2b0415e0e..bd4a9c6c6 100644
--- a/src/documentation/content/xdocs/trunk/upgrading.xml
+++ b/src/documentation/content/xdocs/trunk/upgrading.xml
@@ -62,8 +62,46 @@
</li>
</ul>
<p>
- So, please evaluate carefully before messing up your productive environment!
+ So, please evaluate carefully before messing up your production environment! Actually we do
+ recommend against using the FOP development version in a production system.
</p>
</section>
+ <section id="issues">
+ <title>What you need to know when you upgrade!</title>
+ <p>
+ When you use your existing FO files or XML/XSL files which work fine with FOP version
+ 0.20.5 against this FOP version some things may not work as expected. The following
+ list will hopefully help you to identify and correct those problems.
+ </p>
+ <ul>
+ <li>
+ Check the <a href="../compliance.html">Compliance page</a> for the feature causing
+ trouble. It may contain the necessary information to understand and resolve the problem.
+ </li>
+ <li>
+ Not all 0.20.5 output formats are supported. PDF and Postscript should be fully supported.
+ See <a href="output.html">Output Targets</a> for a more complete description.
+ </li>
+ <li>
+ As stated above empty table cells <code>&lt;fo:table-cell&gt;&lt;/fo:table-cell&gt;</code>
+ are not allowed.
+ </li>
+ <li>
+ 0.20.5 is not XSL-FO compliant with respect to sizing images 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.
+ </li>
+ <li>
+ The <code>fox:outline</code> extension not implemented in this version anymore.
+ It has been superseded by the new bookmark elements from XSL-FO 1.1.
+ </li>
+ <li>
+ The <code>fox:destination</code> extension is also not implemented in this version
+ although it may be added in the future. See also
+ <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=37157">Bug 37157</a>.
+ </li>
+ </ul>
+ </section>
</body>
</document>