diff options
Diffstat (limited to 'src/documentation')
| -rw-r--r-- | src/documentation/content/.htaccess | 7 | ||||
| -rw-r--r-- | src/documentation/content/latest/.htaccess | 2 | ||||
| -rw-r--r-- | src/documentation/content/xdocs/0.90/upgrading.xml | 3 | ||||
| -rw-r--r-- | src/documentation/content/xdocs/compliance.ihtml | 58 | ||||
| -rw-r--r-- | src/documentation/content/xdocs/download.xml | 21 | ||||
| -rw-r--r-- | src/documentation/content/xdocs/index.xml | 2 | ||||
| -rw-r--r-- | src/documentation/content/xdocs/relnotes.xml | 171 |
7 files changed, 211 insertions, 53 deletions
diff --git a/src/documentation/content/.htaccess b/src/documentation/content/.htaccess index 04e7d2e36..5a01cf134 100644 --- a/src/documentation/content/.htaccess +++ b/src/documentation/content/.htaccess @@ -11,3 +11,10 @@ RedirectMatch Permanent ^/fop/output(.*) http://xmlgraphics.apache.org/fop/0.20. RedirectMatch Permanent ^/fop/pdfencryption(.*) http://xmlgraphics.apache.org/fop/0.20.5/pdfencryption$1 RedirectMatch Permanent ^/fop/running(.*) http://xmlgraphics.apache.org/fop/0.20.5/running$1 RedirectMatch Permanent ^/fop/servlets(.*) http://xmlgraphics.apache.org/fop/0.20.5/servlets$1 + +# redirect to versioned documentation +Redirect Temp /fop/stable http://xmlgraphics.apache.org/fop/0.20.5 +Redirect Temp /fop/current http://xmlgraphics.apache.org/fop/0.20.5 +Redirect Temp /fop/0.90alpha1 http://xmlgraphics.apache.org/fop/0.90 +Redirect Temp /fop/unstable http://xmlgraphics.apache.org/fop/0.90 +Redirect Temp /fop/latest http://xmlgraphics.apache.org/fop/0.90 diff --git a/src/documentation/content/latest/.htaccess b/src/documentation/content/latest/.htaccess deleted file mode 100644 index 3b0df5f5f..000000000 --- a/src/documentation/content/latest/.htaccess +++ /dev/null @@ -1,2 +0,0 @@ -# redirect to latest release documentation -Redirect Temp /fop/latest http://xmlgraphics.apache.org/fop/0.20.5 diff --git a/src/documentation/content/xdocs/0.90/upgrading.xml b/src/documentation/content/xdocs/0.90/upgrading.xml index a41b82ba2..60ba5413c 100644 --- a/src/documentation/content/xdocs/0.90/upgrading.xml +++ b/src/documentation/content/xdocs/0.90/upgrading.xml @@ -40,6 +40,9 @@ The new API is not stable, yet. Please be aware that further changes might still occur! </li> <li> + The configuration file format has changed (see the <a href="configuration.html">Configuration page</a> for details). + </li> + <li> <p> The new code is much more strict about the interpretation of the XSL-FO 1.0 specification. Things that worked fine in version 0.20.5 might start to produce warnings or even errors diff --git a/src/documentation/content/xdocs/compliance.ihtml b/src/documentation/content/xdocs/compliance.ihtml index f67fee203..7dfd47709 100644 --- a/src/documentation/content/xdocs/compliance.ihtml +++ b/src/documentation/content/xdocs/compliance.ihtml @@ -170,10 +170,10 @@ </tr> <tr> <th align="center"> - 0.20.5 + 0.20.5 (current stable) </th> <th align="center"> - Latest Release + 0.90alpha1 (unstable) </th> </tr> <tr> @@ -611,7 +611,7 @@ [0.20.5] For absolute positioning, use 'position="absolute"' (as 'absolute-position="absolute"' is not implemented), and specify all four of "left", "top", "width" and "height" </li> <li> - [Latest] No known restrictions. + [0.90alpha1] No known restrictions. </li> </ul> </td> @@ -825,7 +825,7 @@ [0.20.5] Only works for table of contents without any problems. The case where the page number doesn't fit on a line isn't handled, and any text on the same line and after the page-number might not appear exactly where you want it to. </li> <li> - [Latest] After the page number is known, no relayout is performed. The appearance may be suboptimal depending on the use case. + [0.90alpha1] After the page number is known, no relayout is performed. The appearance may be suboptimal depending on the use case. </li> </ul> </td> @@ -874,7 +874,7 @@ <td align="left"> <ul> <li> - [Latest] Only border-collapse="separate" is supported and there's no support for automatic column widths. + [0.90alpha1] Only border-collapse="separate" is supported and there's no support for automatic column widths. </li> </ul> </td> @@ -1284,7 +1284,7 @@ </td> <td align="left"> <ul> - <li>[Latest] Restrictions with multi-column documents.</li> + <li>[0.90alpha1] Restrictions with multi-column documents.</li> </ul> </td> </tr> @@ -1398,10 +1398,10 @@ </tr> <tr> <th align="center"> - 0.20.5 + 0.20.5 (current stable) </th> <th align="center"> - Latest Release + 0.90alpha1 (unstable) </th> </tr> <tr> @@ -1476,7 +1476,7 @@ [0.20.5] Use shorthand position="absolute" as a workaround. </li> <li> - [Latest] No restrictions. The 0.20.5 work-around is not supported. + [0.90alpha1] No restrictions. The 0.20.5 work-around is not supported. </li> </ul> </td> @@ -1970,7 +1970,7 @@ <td align="left"> <ul> <li> - [Latest] not yet implemented on table-body, table-header and table-footer. + [0.90alpha1] not yet implemented on table-body, table-header and table-footer. </li> </ul> </td> @@ -1994,7 +1994,7 @@ <td align="partial"> <ul> <li> - [Latest] not yet implemented on table-body, table-header and table-footer. + [0.90alpha1] not yet implemented on table-body, table-header and table-footer. </li> </ul> </td> @@ -2951,7 +2951,7 @@ [0.20.5] "normal", "bolder" and "lighter" are not supported </li> <li> - [Latest] TODO <relative> font weights + [0.90alpha1] TODO <relative> font weights </li> </ul> </td> @@ -3224,7 +3224,7 @@ [0.20.5] space-before.optimum supported </li> <li> - [Latest] Space adjustment may not fully work everywhere, yet. + [0.90alpha1] Space adjustment may not fully work everywhere, yet. </li> </ul> </td> @@ -3251,7 +3251,7 @@ [0.20.5] space-after.optimum supported </li> <li> - [Latest] Space adjustment may not fully work everywhere, yet. + [0.90alpha1] Space adjustment may not fully work everywhere, yet. </li> </ul> </td> @@ -3460,7 +3460,7 @@ [0.20.5] For table-cell, the "height" attribute must be set for the parent table-row; setting the height of the table or the table-cell results in vertical centering having no effect. </li> <li> - [Latest] TODO Check e-g, i-f-o. + [0.90alpha1] TODO Check e-g, i-f-o. </li> </ul> </td> @@ -3874,7 +3874,7 @@ <td align="left"> <ul> <li> - [Latest] value "line-height" not supported + [0.90alpha1] value "line-height" not supported </li> </ul> </td> @@ -3898,7 +3898,7 @@ <td align="left"> <ul> <li> - [Latest] Value "treat-as-zero-width-space" not supported + [0.90alpha1] Value "treat-as-zero-width-space" not supported </li> </ul> </td> @@ -3922,7 +3922,7 @@ <td align="left"> <ul> <li> - [Latest] Only the values "ignore" and "ignore-if-surrounding-linefeed" work reliably + [0.90alpha1] Only the values "ignore" and "ignore-if-surrounding-linefeed" work reliably </li> </ul> </td> @@ -4034,7 +4034,7 @@ <td align="left"> <ul> <li> - [Latest] Only supported on fo:block. + [0.90alpha1] Only supported on fo:block. </li> </ul> </td> @@ -4401,10 +4401,10 @@ [0.20.5] works only in table rows </li> <li> - [Latest] works on all implemented FOs. + [0.90alpha1] works on all implemented FOs. </li> <li> - [Latest] <integer> values are not supported. + [0.90alpha1] <integer> values are not supported. </li> </ul> </td> @@ -4431,10 +4431,10 @@ [0.20.5] works only in table rows </li> <li> - [Latest] works on all implemented FOs. + [0.90alpha1] works on all implemented FOs. </li> <li> - [Latest] <integer> values are not supported. + [0.90alpha1] <integer> values are not supported. </li> </ul> </td> @@ -4461,10 +4461,10 @@ [0.20.5] works only in table rows </li> <li> - [Latest] works on all implemented FOs, except list- and table-related FOs. + [0.90alpha1] works on all implemented FOs, except list- and table-related FOs. </li> <li> - [Latest] <integer> values are not supported. + [0.90alpha1] <integer> values are not supported. </li> </ul> </td> @@ -4552,7 +4552,7 @@ </td> <td align="center"> <ul> - <li>[Latest] TODO TBD</li> + <li>[0.90alpha1] TODO TBD</li> </ul> </td> </tr> @@ -4630,7 +4630,7 @@ [0.20.5] not value "page" </li> <li> - [Latest] Not uspported + [0.90alpha1] Not uspported </li> </ul> </td> @@ -4657,7 +4657,7 @@ [0.20.5] not value "use-content" </li> <li> - [Latest] Value "use-content" does not work in all circumstances. + [0.90alpha1] Value "use-content" does not work in all circumstances. </li> </ul> </td> @@ -6111,7 +6111,7 @@ </td> <td align="left"> <ul> - <li>[Latest] IDs on table-header, table-footer, table-body, table-row, table-and-caption, table-caption, inline-container and bidi-override are not available, yet.</li> + <li>[0.90alpha1] IDs on table-header, table-footer, table-body, table-row, table-and-caption, table-caption, inline-container and bidi-override are not available, yet.</li> </ul> </td> </tr> diff --git a/src/documentation/content/xdocs/download.xml b/src/documentation/content/xdocs/download.xml index d7784b639..9f27e7d51 100644 --- a/src/documentation/content/xdocs/download.xml +++ b/src/documentation/content/xdocs/download.xml @@ -91,7 +91,7 @@ <p/> <table> <tr> - <th colspan="2">Maintenance Branch</th> + <th colspan="2">Old Maintenance Branch (for 0.20.5)</th> </tr> <tr> <td>Repository URL</td> @@ -110,6 +110,25 @@ </td> </tr> <tr> + <th colspan="2">Latest Release Branch</th> + </tr> + <tr> + <td>Repository URL</td> + <td> + <link href="http://svn.apache.org/repos/asf/xmlgraphics/fop/branches/fop-0_90/"> + <code>http://svn.apache.org/repos/asf/xmlgraphics/fop/branches/fop-0_90/</code> + </link> + </td> + </tr> + <tr> + <td>Web view</td> + <td> + <link href="http://svn.apache.org/viewcvs.cgi/xmlgraphics/fop/branches/fop-0_90/"> + <code>http://svn.apache.org/viewcvs.cgi/xmlgraphics/fop/branches/fop-0_90/</code> + </link> + </td> + </tr> + <tr> <th colspan="2">Trunk</th> </tr> <tr> diff --git a/src/documentation/content/xdocs/index.xml b/src/documentation/content/xdocs/index.xml index cf71f7d57..3981729ae 100644 --- a/src/documentation/content/xdocs/index.xml +++ b/src/documentation/content/xdocs/index.xml @@ -41,7 +41,7 @@ W3C Recommendation</link>. </p> <p> - The latest release of FOP (<link href="0.90/">0.90 alpha 1</link>) is the first preview release + The latest unstable version of FOP (<link href="0.90/">0.90 alpha 1</link>) is the first preview release after a large redesign effort and implements a larger subset than 0.20.5 of the <link href="http://www.w3.org/TR/2001/REC-xsl-20011015/">XSL-FO Version 1.0 W3C Recommendation</link> as well as some parts of the <link href="http://www.w3.org/TR/xsl11">XSL-FO Version 1.1 Working Draft</link>. diff --git a/src/documentation/content/xdocs/relnotes.xml b/src/documentation/content/xdocs/relnotes.xml index 5c4387486..e7aafdd76 100644 --- a/src/documentation/content/xdocs/relnotes.xml +++ b/src/documentation/content/xdocs/relnotes.xml @@ -1,6 +1,6 @@ <?xml version="1.0" standalone="no"?> <!-- - Copyright 1999-2004 The Apache Software Foundation + Copyright 1999-2005 The Apache Software Foundation Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. @@ -15,9 +15,7 @@ limitations under the License. --> <!-- $Id$ --> -<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.1//EN" - "http://cvs.apache.org/viewcvs.cgi/*checkout*/xml-forrest/src/core/context/resources/schema/dtd/document-v12.dtd"> - +<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V2.0//EN" "http://forrest.apache.org/dtd/document-v20.dtd"> <document> <header> <title>Release Notes</title> @@ -26,6 +24,139 @@ <body> <section> + <title>FOP 0.90 alpha 1</title> + <p> + This is the first preview release after the big redesign effort. + </p> + <p> + We would like to encourage you to download the code and to play with it. + We're still in the process of adding new major features and stabilizing + the code. We welcome any feedback you might have and even more, any + other form of help to get the project forward. + </p> + <p>Caveats:</p> + <ul> + <li> + This release is a (unstable) preview release and not intended for use in a + production environment. Use at your own risk! + </li> + <li> + The API is not to be considered stable, yet. Please be prepared + for the API to be changed in a backwards-incompatible way. + </li> + <li> + You may experience different behaviour compared to version 0.20.5. + Please consult the <a href="0.90/upgrading.html">"Upgrading"</a> page indicated above for details. + </li> + </ul> + <p>Known Issues:</p> + <ul> + <li> + PCL, MIF and SVG support have not been restored, yet. + </li> + <li> + Java2D/AWT support contains some problems, for example with + block-containers. + </li> + <li> + Support for kerning has not been restored, yet. + </li> + <li> + Auto table layout is not implemented, yet. + </li> + <li> + The collapsing border model on tables is not implemented, yet. Please + use border-collapse="separate" for now. + </li> + <li> + Footnotes may overlap with text of the region-body in multi-column + documents. + </li> + <li> + Space resolution does not work between footnote regions. + </li> + <li> + There's a problem involving nested block-containers and + reference-orientation 180/-180 (<a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=36391">Bugzilla #36391</a>) + </li> + <li> + block-containers with no height currently don't create a fence for + spaces as they should (they behave like a normal block). + </li> + <li> + Preserved linefeeds in fo:character are not handled correctly. + </li> + <li> + Zero-width spaces are not handled correctly. + </li> + <li> + An empty block currently produces a fence for stacking constraints + which it shouldn't. + </li> + <li> + There are several small problems around white space handling. + </li> + <li> + Images currently don't shrink so they fit on a page when they are + too big and shrinking is allowed to happen. + </li> + <li> + Block-level content in fo:inlines may produce unwelcome results. + </li> + <li> + inline-container may not work as expected. + </li> + <li> + letter-spacing and word-spacing properties may not work as expected. + </li> + <li> + leaders with leader-pattern="use-content" may not work as expected. + </li> + <li> + keep-with-previous doesn't work inside tables and lists, yet. + </li> + <li> + White space on direct inline-level children of a marker is not + handled correctly. + </li> + <li> + If two consecutive pages don't have the same available width, the + content currently isn't properly fit into the available space on + the new page. + </li> + <li> + background-images on page-number-citations are not placed correctly. + </li> + <li> + Not all FO elements can be referenced by their "id", most notably: + table-body, table-header, table-footer and table-row. + </li> + <li> + The backgrounds of table-body, table-header, table-footer and + table-column are not painted, yet. + </li> + <li> + Border and padding conditionality are not supported on table-cells, yet. + </li> + <li> + Copy/Paste from PDF content in Acrobat Reader is not supported for + text using embedded TrueType fonts. + </li> + <li> + Column balancing in multi-column documents may not work as expected + (<a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=36356">Bugzilla #36356</a>) + </li> + <li> + Omitting fo:table-column or having fo:table-column without a column-width + and attempting to create columns implicitly from the first + table row is not implemented, yet (<a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=35656">Bugzilla #35656</a>). + </li> + <li> + Leaders with the "rule" pattern don't work for PostScript output. + </li> + </ul> +</section> +<section> <title>FOP 0.20.5</title> <p>This is the last planned release in the 0.20.x series (aka maintenance branch).</p> <p>Important changes since the last release (0.20.4):</p> @@ -34,36 +165,36 @@ no, sk, tr) have been removed due to licensing reasons (en_GB hyphenation has been renamed to en). We're still working on this issue - (see <link href="http://wiki.apache.org/xmlgraphics-fop/FOPAudits/March2003"> - Wiki</link> for details). + (see <a href="http://wiki.apache.org/xmlgraphics-fop/FOPAudits/March2003"> + Wiki</a> for details). </li> - <li>Documentation is now built with <link href="http://xml.apache.org/forrest/"> - Forrest</link> (version 0.4). You need to install Forrest if you want build the docs + <li>Documentation is now built with <a href="http://xml.apache.org/forrest/"> + Forrest</a> (version 0.4). You need to install Forrest if you want build the docs yourself. (See - <link href="http://xml.apache.org/forrest/your-project.html">Using Forrest</link>) + <a href="http://xml.apache.org/forrest/your-project.html">Using Forrest</a>) </li> <li>The following JARs have been updated: Xerces to version 2.2.1, Xalan to version 2.4.1 and Batik to version 1.5beta4. </li> <li>FOP has been compiled with Jimi support, but Jimi is not included in the FOP distribution. To use it, first download - <link href="http://java.sun.com/products/jimi/">Jimi</link>, then extract + <a href="http://java.sun.com/products/jimi/">Jimi</a>, then extract the archive, then copy JimiProClasses.zip to FOP's lib dir and rename it to jimi-1.0.jar. </li> <li>FOP has been compiled with JAI support, but JAI is not included in the FOP distribution. To use it, simply install - <link href="http://java.sun.com/products/java-media/jai">JAI</link>. + <a href="http://java.sun.com/products/java-media/jai">JAI</a>. </li> <li>Links in PDF won't generate multiple link rectangles anymore. If this causes a problem you can set the system property "links.merge" to "no". </li> - <li>FOP has been compiled with cryptography support. See <link href="0.20.5/pdfencryption.html"> - PDF encryption</link> for details about installation and usage. + <li>FOP has been compiled with cryptography support. See <a href="0.20.5/pdfencryption.html"> + PDF encryption</a> for details about installation and usage. </li> <li>The behaviour of leader has changed. See - <link href="http://issues.apache.org/bugzilla/show_bug.cgi?id=19341">bug #19341</link>, - <link href="http://issues.apache.org/bugzilla/show_bug.cgi?id=19465">bug #19465</link> + <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=19341">bug #19341</a>, + <a href="http://issues.apache.org/bugzilla/show_bug.cgi?id=19465">bug #19465</a> and <code>leader.fo</code> (examples). </li> <li> @@ -86,14 +217,14 @@ </li> <li>FOP has been compiled with Jimi support this time but you still have to download - <link href="http://java.sun.com/products/jimi/">Jimi</link> + <a href="http://java.sun.com/products/jimi/">Jimi</a> and copy it to lib/ to get PNG support (no need to build FOP yourself though). </li> <li>Building FOP with JDK1.2 does not work. Running is ok except support for additional truetype fonts in AWT Viewer. </li> <li>Logging has been changed from LogKit to Avalon's Logger Interface. - (see <link href="0.20.5/embedding.html">Embedding</link> for details). + (see <a href="0.20.5/embedding.html">Embedding</a> for details). </li> <li>Building under JDK 1.4: You need to add a method in @@ -119,8 +250,8 @@ <p>Important Information:</p> <ul> <li>This version supports the - <link href="http://www.w3.org/TR/2001/REC-xsl-20011015/">XSL-FO Version 1.0 - W3C Recommendation</link> syntax. So don't forget to update your + <a href="http://www.w3.org/TR/2001/REC-xsl-20011015/">XSL-FO Version 1.0 + W3C Recommendation</a> syntax. So don't forget to update your Stylesheets: <br/>Just rename the <code>master-name</code> property to <code>master-reference</code> on <code>fo:page-sequence</code>, <code>fo:single-page-master-reference</code>, @@ -129,7 +260,7 @@ <li>JDK 1.2 (or later) is required</li> <li>Jimi has been removed for licensing reasons <br/>If you need PNG support you have to download - <link href="http://java.sun.com/products/jimi/">Jimi</link>, + <a href="http://java.sun.com/products/jimi/">Jimi</a>, copy it to lib/ and build FOP yourself</li> <li>Building under JDK 1.4: <br/>You need to add a method in |