From: Vincent Hennebert
Date: Wed, 12 Mar 2008 12:19:15 +0000 (+0000)
Subject: Update of the documentation before the release.
X-Git-Tag: fop-0_95beta~6
X-Git-Url: https://source.dussan.org/?a=commitdiff_plain;h=2c051186afbd874cc4f4629ba05267a5f21f9358;p=xmlgraphics-fop.git
Update of the documentation before the release.
Added notes about improved checks and conformance in tables.
git-svn-id: https://svn.apache.org/repos/asf/xmlgraphics/fop/trunk@636295 13f79535-47bb-0310-9956-ffa450edef68
---
diff --git a/README b/README
index 67a3b0fe1..133232276 100644
--- a/README
+++ b/README
@@ -90,6 +90,46 @@ http://xmlgraphics.apache.org/fop/stable/running.html
RELEASE NOTES
==============================================================================
+Version 0.95beta
+================
+
+This is a pre-version of the third production grade release of the new FOP
+codebase. It contains many bug fixes and new features. See below for details.
+
+Compliance
+----------
+
+This release implements the XSL 1.0 and 1.1 recommendations to a high
+degree of compliance. See the compliance page
+http://xmlgraphics.apache.org/fop/compliance.html for a detailed
+overview.
+
+Known issues
+------------
+
+The known issues of this release are listed at
+http://xmlgraphics.apache.org/fop/0.95/knownissues_overview.html.
+
+Major Changes in Version 0.95
+-----------------------------
+
+* Add new fox:external-document extension element that allows to insert whole
+ documents into a page-sequence (JM)
+* Add support for background on fo:table-column and fo:table-header/footer/body
+ elements (VH)
+* Add support for conditional borders in tables (VH)
+* Add support for scale-down-to-fit and scale-up-to-fit (JM)
+* Fix various bugs and performance problems with external graphics by
+ introducing a new image loading framework (JM)
+
+The long list of changes in this release is available at
+http://xmlgraphics.apache.org/fop/0.95/changes_0.95.html.
+
+The long list of changes in this and earlier releases is available at
+http://xmlgraphics.apache.org/fop/changes.html.
+
+
+
Version 0.94
============
diff --git a/src/documentation/content/.htaccess b/src/documentation/content/.htaccess
index db766b7c4..561900fde 100644
--- a/src/documentation/content/.htaccess
+++ b/src/documentation/content/.htaccess
@@ -18,8 +18,8 @@ RedirectMatch Permanent ^/fop/upgrading(.*) http://xmlgraphics.apache.org/fop/0.
# redirect to versioned documentation
Redirect Temp /fop/stable http://xmlgraphics.apache.org/fop/0.94
-Redirect Temp /fop/current http://xmlgraphics.apache.org/fop/0.94
-Redirect Temp /fop/unstable http://xmlgraphics.apache.org/fop/trunk
+Redirect Temp /fop/current http://xmlgraphics.apache.org/fop/0.95
+Redirect Temp /fop/unstable http://xmlgraphics.apache.org/fop/0.95
Redirect Temp /fop/latest http://xmlgraphics.apache.org/fop/trunk
Redirect Temp /fop/maintenance http://xmlgraphics.apache.org/fop/0.93
Redirect Temp /fop/previous http://xmlgraphics.apache.org/fop/0.93
diff --git a/src/documentation/content/xdocs/0.95/known-issues.xml b/src/documentation/content/xdocs/0.95/known-issues.xml
index 568fec8d9..6e28e3fb7 100644
--- a/src/documentation/content/xdocs/0.95/known-issues.xml
+++ b/src/documentation/content/xdocs/0.95/known-issues.xml
@@ -63,10 +63,6 @@
Not all FO elements can be referenced by their "id", most notably:
table-body, table-header, table-footer and table-row.
-
- The backgrounds of table-body, table-header, table-footer and
- table-column are not painted, yet.
-
Column balancing in multi-column documents may not work as expected
(Bugzilla #36356)
diff --git a/src/documentation/content/xdocs/0.95/layoutengine/disabled-testcases.xml b/src/documentation/content/xdocs/0.95/layoutengine/disabled-testcases.xml
index 15ac8aa48..b4de16ef4 100644
--- a/src/documentation/content/xdocs/0.95/layoutengine/disabled-testcases.xml
+++ b/src/documentation/content/xdocs/0.95/layoutengine/disabled-testcases.xml
@@ -232,54 +232,6 @@
region-body_column-count_bug36356.xmlColumn balancing doesn't work as expected.
-
- No background-images on table-body
- table-body_background-image.xml
- The backgrounds of table-body, table-header,
- table-footer and table-column are not painted, yet.
-
-
- Collapsing Border Model NYI
- table_border-collapse_collapse_1.xml
- Border-collapse="collapse" is not yet
- implemented.
-
-
- Collapsing Border Model NYI
- table_border-collapse_collapse_2.xml
- Border-collapse="collapse" is not yet
- implemented.
-
-
- Problems with border and padding on tables
- table_border_padding.xml
- The element list seems to not be fully correct, yet, causing
- the layout to look odd.
-
-
- keep-with-previous doesn't work inside tables
- table-cell_block_keep-with-previous.xml
- Keep-with-previous doesn't work inside tables and
- lists, yet.
-
-
- Border and padding conditionality is NYI on table-cells
- table-cell_border_padding_conditionality.xml
- Border and padding conditionality are not supported
- on table-cells, yet.
-
-
- No background-images on table-header
- table-header_background-image.xml
- The backgrounds of table-body, table-header,
- table-footer and table-column are not painted, yet.
-
-
- keep-with-previous doesn't work on table-rows
- table-row_keep-with-previous.xml
- Keep-with-previous doesn't work inside tables and
- lists, yet.
- table-cell empty area with marker.xmltable-cell_empty_area_with_marker.xml
diff --git a/src/documentation/content/xdocs/download.xml b/src/documentation/content/xdocs/download.xml
index 6607f2ddb..f0a2a0a61 100644
--- a/src/documentation/content/xdocs/download.xml
+++ b/src/documentation/content/xdocs/download.xml
@@ -108,16 +108,16 @@
Apache FOP (Formatting Objects Processor) is a print formatter driven by XSL
formatting objects (XSL-FO) and an output independent formatter. It is a Java
application that reads a formatting object (FO) tree and renders the resulting
- pages to a specified output. Output formats
+ pages to a specified output. Output formats
currently supported include PDF, PS, PCL, AFP, XML (area tree representation),
Print, AWT and PNG, and to a lesser extent, RTF and TXT. The primary output target is PDF.
- The latest stable version of FOP (0.94) is the second
- stable release after a large redesign effort and implements a large subset of the
+ A beta release of the latest version of FOP (0.95) is now
+ available. After a short testing period it will become the third
+ stable release after the large redesign effort and will implement a large subset of the
XSL-FO Version 1.1 W3C
Recommendation.
- Improvements and bugfixes for tables (keep and break support, border
- conditionality etc.)
+ Many bugfixes in tables, plus some new features (full support for keeps and
+ breaks, border conditionality, background on columns and header/footer/body)
Improvements and bugfixes for font handling and font
@@ -85,6 +85,28 @@
Please note that with this release, we've dropped support for Java 1.3.
FOP will, from now on, require at least Java 1.4.
+
+ There have been a few changes in tables that make FOP both more strict and more
+ compliant to the Recommendation:
+
+
XSL-FO 1.1 explicitly states that a row-spanning fo:table-cell element is not
+ allowed to span further than its enclosing fo:table-header/footer/body element
+ (see bottom of section
+ 6.7.3). From now on FOP will give a validation error if a document
+ contains such an erroneous cell.
+
+
+
If an fo:table element contains explicit fo:table-column children, then those
+ elements set the total number of columns in the table. This means that a
+ validation error will now occur if a row contains more cells than available
+ columns. This change allows to improve performance, since the rendering of the
+ table may start as soon as the table-column elements have been parsed.
+
If more flexibility is needed, then the fo:table-column elements may be just
+ omitted. The final number of columns will then be set by the row that has the
+ most cells.
+
+
+
The image libraries Jimi and JAI are no longer needed (and used). Instead we rely
completely on the Image I/O API that has been introduced with Java 1.4. If you still