From 793e0575e1fb087fd5850e26861ef80f09a91e53 Mon Sep 17 00:00:00 2001
From: Simon Pepping
Date: Sun, 24 Dec 2006 13:29:58 +0000
Subject: [PATCH] Various updates, a.o. to news and status. Pointed links in
FAQ to the 0.93 directory. Ported changes in index and upgrading from the
0.93 to the trunk directory. Some updates to DTD SYSTEM IDs.
git-svn-id: https://svn.apache.org/repos/asf/xmlgraphics/fop/branches/fop-0_93@490012 13f79535-47bb-0310-9956-ffa450edef68
---
known-issues.xml | 5 --
src/documentation/content/doap.rdf | 2 +-
.../content/xdocs/0.20.5/anttask.xml | 2 +-
.../content/xdocs/0.20.5/compiling.xml | 2 +-
.../content/xdocs/0.20.5/configuration.xml | 2 +-
.../content/xdocs/0.20.5/embedding.xml | 2 +-
.../content/xdocs/0.20.5/extensions.xml | 2 +-
.../content/xdocs/0.20.5/fonts.xml | 2 +-
.../content/xdocs/0.20.5/graphics.xml | 2 +-
.../content/xdocs/0.20.5/hyphenation.xml | 2 +-
.../content/xdocs/0.20.5/output.xml | 2 +-
.../content/xdocs/0.20.5/pdfencryption.xml | 2 +-
.../content/xdocs/0.20.5/running.xml | 2 +-
.../content/xdocs/0.20.5/servlets.xml | 2 +-
src/documentation/content/xdocs/bugs.xml | 2 +-
src/documentation/content/xdocs/examples.xml | 2 +-
src/documentation/content/xdocs/faq.xml | 71 ++++++++++---------
src/documentation/content/xdocs/fo.xml | 4 +-
src/documentation/content/xdocs/license.xml | 2 +-
src/documentation/content/xdocs/news.xml | 11 ++-
src/documentation/content/xdocs/site.xml | 2 +-
src/documentation/content/xdocs/status.xml | 49 +++++--------
src/documentation/content/xdocs/tabs.xml | 2 +-
.../content/xdocs/trunk/index.xml | 13 ++--
.../content/xdocs/trunk/upgrading.xml | 32 ++++++---
status.xml | 8 +--
26 files changed, 115 insertions(+), 114 deletions(-)
diff --git a/known-issues.xml b/known-issues.xml
index 3a2ee4927..65265b6d5 100644
--- a/known-issues.xml
+++ b/known-issues.xml
@@ -95,11 +95,6 @@
Column balancing in multi-column documents may not work as expected
(Bugzilla #36356)
-
- 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 (Bugzilla #35656).
-
Internal basic-links don't point to the exact location on a page, yet, as they
did in 0.20.5. Currently you land in the upper left corner of the page.
diff --git a/src/documentation/content/doap.rdf b/src/documentation/content/doap.rdf
index a66a18be1..27259b5f2 100644
--- a/src/documentation/content/doap.rdf
+++ b/src/documentation/content/doap.rdf
@@ -91,7 +91,7 @@
-
+
diff --git a/src/documentation/content/xdocs/0.20.5/anttask.xml b/src/documentation/content/xdocs/0.20.5/anttask.xml
index c6da0cba0..9bc3c59ee 100644
--- a/src/documentation/content/xdocs/0.20.5/anttask.xml
+++ b/src/documentation/content/xdocs/0.20.5/anttask.xml
@@ -17,7 +17,7 @@
-->
+ "http://svn.apache.org/viewvc/forrest/trunk/main/webapp/resources/schema/dtd/document-v12.dtd?view=co">
diff --git a/src/documentation/content/xdocs/0.20.5/compiling.xml b/src/documentation/content/xdocs/0.20.5/compiling.xml
index 1c5d09e0f..e2e2ca8d5 100644
--- a/src/documentation/content/xdocs/0.20.5/compiling.xml
+++ b/src/documentation/content/xdocs/0.20.5/compiling.xml
@@ -17,7 +17,7 @@
-->
+ "http://svn.apache.org/viewvc/forrest/trunk/main/webapp/resources/schema/dtd/document-v12.dtd?view=co">
diff --git a/src/documentation/content/xdocs/0.20.5/configuration.xml b/src/documentation/content/xdocs/0.20.5/configuration.xml
index 95edd695e..88097059a 100644
--- a/src/documentation/content/xdocs/0.20.5/configuration.xml
+++ b/src/documentation/content/xdocs/0.20.5/configuration.xml
@@ -17,7 +17,7 @@
-->
+ "http://svn.apache.org/viewvc/forrest/trunk/main/webapp/resources/schema/dtd/document-v12.dtd?view=co">
diff --git a/src/documentation/content/xdocs/0.20.5/embedding.xml b/src/documentation/content/xdocs/0.20.5/embedding.xml
index db42a7423..e3cff158a 100644
--- a/src/documentation/content/xdocs/0.20.5/embedding.xml
+++ b/src/documentation/content/xdocs/0.20.5/embedding.xml
@@ -17,7 +17,7 @@
-->
+ "http://svn.apache.org/viewvc/forrest/trunk/main/webapp/resources/schema/dtd/document-v12.dtd?view=co">
diff --git a/src/documentation/content/xdocs/0.20.5/extensions.xml b/src/documentation/content/xdocs/0.20.5/extensions.xml
index 68a68b19d..07b98da89 100644
--- a/src/documentation/content/xdocs/0.20.5/extensions.xml
+++ b/src/documentation/content/xdocs/0.20.5/extensions.xml
@@ -17,7 +17,7 @@
-->
+ "http://svn.apache.org/viewvc/forrest/trunk/main/webapp/resources/schema/dtd/document-v12.dtd?view=co">
diff --git a/src/documentation/content/xdocs/0.20.5/fonts.xml b/src/documentation/content/xdocs/0.20.5/fonts.xml
index 79a5dc0ae..9b5991626 100644
--- a/src/documentation/content/xdocs/0.20.5/fonts.xml
+++ b/src/documentation/content/xdocs/0.20.5/fonts.xml
@@ -17,7 +17,7 @@
-->
+ "http://svn.apache.org/viewvc/forrest/trunk/main/webapp/resources/schema/dtd/document-v12.dtd?view=co">
FOP: Fonts
diff --git a/src/documentation/content/xdocs/0.20.5/graphics.xml b/src/documentation/content/xdocs/0.20.5/graphics.xml
index 8f40e52cd..fe0a63a8e 100644
--- a/src/documentation/content/xdocs/0.20.5/graphics.xml
+++ b/src/documentation/content/xdocs/0.20.5/graphics.xml
@@ -17,7 +17,7 @@
-->
+ "http://svn.apache.org/viewvc/forrest/trunk/main/webapp/resources/schema/dtd/document-v12.dtd?view=co">
FOP: Graphics Formats
diff --git a/src/documentation/content/xdocs/0.20.5/hyphenation.xml b/src/documentation/content/xdocs/0.20.5/hyphenation.xml
index aef17881a..d18f50961 100644
--- a/src/documentation/content/xdocs/0.20.5/hyphenation.xml
+++ b/src/documentation/content/xdocs/0.20.5/hyphenation.xml
@@ -17,7 +17,7 @@
-->
+ "http://svn.apache.org/viewvc/forrest/trunk/main/webapp/resources/schema/dtd/document-v12.dtd?view=co">
FOP: Hyphenation
diff --git a/src/documentation/content/xdocs/0.20.5/output.xml b/src/documentation/content/xdocs/0.20.5/output.xml
index a5b001685..577e51b04 100644
--- a/src/documentation/content/xdocs/0.20.5/output.xml
+++ b/src/documentation/content/xdocs/0.20.5/output.xml
@@ -17,7 +17,7 @@
-->
+ "http://svn.apache.org/viewvc/forrest/trunk/main/webapp/resources/schema/dtd/document-v12.dtd?view=co">
diff --git a/src/documentation/content/xdocs/0.20.5/pdfencryption.xml b/src/documentation/content/xdocs/0.20.5/pdfencryption.xml
index ef60fc0b5..030c022b1 100644
--- a/src/documentation/content/xdocs/0.20.5/pdfencryption.xml
+++ b/src/documentation/content/xdocs/0.20.5/pdfencryption.xml
@@ -17,7 +17,7 @@
-->
+ "http://svn.apache.org/viewvc/forrest/trunk/main/webapp/resources/schema/dtd/document-v12.dtd?view=co">
diff --git a/src/documentation/content/xdocs/0.20.5/running.xml b/src/documentation/content/xdocs/0.20.5/running.xml
index 6d491c2c2..0432735f6 100644
--- a/src/documentation/content/xdocs/0.20.5/running.xml
+++ b/src/documentation/content/xdocs/0.20.5/running.xml
@@ -17,7 +17,7 @@
-->
+ "http://svn.apache.org/viewvc/forrest/trunk/main/webapp/resources/schema/dtd/document-v12.dtd?view=co">
diff --git a/src/documentation/content/xdocs/0.20.5/servlets.xml b/src/documentation/content/xdocs/0.20.5/servlets.xml
index 6416c3a50..1a7514c1e 100644
--- a/src/documentation/content/xdocs/0.20.5/servlets.xml
+++ b/src/documentation/content/xdocs/0.20.5/servlets.xml
@@ -17,7 +17,7 @@
-->
+ "http://svn.apache.org/viewvc/forrest/trunk/main/webapp/resources/schema/dtd/document-v12.dtd?view=co">
Servlets
diff --git a/src/documentation/content/xdocs/bugs.xml b/src/documentation/content/xdocs/bugs.xml
index 233a69c5b..8f0f12531 100644
--- a/src/documentation/content/xdocs/bugs.xml
+++ b/src/documentation/content/xdocs/bugs.xml
@@ -17,7 +17,7 @@
-->
+ "http://svn.apache.org/viewvc/forrest/trunk/main/webapp/resources/schema/dtd/document-v12.dtd?view=co">
diff --git a/src/documentation/content/xdocs/examples.xml b/src/documentation/content/xdocs/examples.xml
index 8b40246d9..c8d4a5dde 100644
--- a/src/documentation/content/xdocs/examples.xml
+++ b/src/documentation/content/xdocs/examples.xml
@@ -17,7 +17,7 @@
-->
+ "http://svn.apache.org/viewvc/forrest/trunk/main/webapp/resources/schema/dtd/document-v12.dtd?view=co">
diff --git a/src/documentation/content/xdocs/faq.xml b/src/documentation/content/xdocs/faq.xml
index 02ed82542..1f567ad4f 100644
--- a/src/documentation/content/xdocs/faq.xml
+++ b/src/documentation/content/xdocs/faq.xml
@@ -137,8 +137,9 @@
When it's ready and the committers have enough time to go through
- the time-consuming process of creating a release. We'll try to do
- a new release every 3 or 4 months, but that's no promise. If you
+ the time-consuming process of creating a release. We
+ released version 0.93 on 2 January 2007, and intend to
+ release version 1.0 later in 2007. If you
want to speed up the process, consider to
contribute to FOP.
@@ -146,7 +147,7 @@
Why did you redesign FOP?
-
The core redesign of FOP was necessary in order to be able to adress following issues:
+
The code redesign of FOP was necessary in order to be able to adress following issues:
Keeps and Breaks
XSL-FO Compliance in general
@@ -209,8 +210,8 @@
If you run FOP embedded in your servlet, web application or
other Java application, check the classpath of the
- application. Check the also the information pertaining servlet engines
+ application. Check the also the information pertaining to servlet engines
for further hints.
@@ -240,7 +241,7 @@
I get an OutOfMemoryException.
- See FOP Memory.
+ See FOP Memory.
@@ -301,7 +302,7 @@
If you use XSLT, problems in your style sheet and in your
source XML also can produce a NullPointerException. Run the transformation
+ href="0.93/running.html#check-input">Run the transformation
separately to check for this, usually you'll get a
detailed error message from the XSLT processor.
@@ -314,7 +315,7 @@
FOP returns the message "[ERROR] object|property - 'x' is not implemented yet." When will it be implemented?
-
See the article "Review FOP's Standards Compliance".
+
See FOP's Standards Compliance page.
@@ -379,7 +380,7 @@
Try also setting the fontBaseDir
+ href="0.93/configuration.html#general-elements">font-base
configuration.
@@ -388,7 +389,7 @@
Problems with FOP output
- Leaders don't work anymore in 0.20.5. Instead of
+ Leaders don't work anymore in 0.93. Instead of
filling the line, only three dots or a short ruler is
output.
@@ -431,7 +432,7 @@
The force-page-count
+ href="http://www.w3.org/TR/2001/REC-xsl-20011015/slice7.html#force-page-count">force-page-count
property controls how a FO processor pads page sequences in
order to get certain page counts or last page numbers. The default is
"auto". With this setting, if the next page sequence
@@ -469,7 +470,7 @@ Check the following:
Other possibilities:
The image format is not supported or not supported completely.
- See FOP Graphics Formats for a
+ See FOP Graphics Formats for a
list of supported formats and related issues.
The graphic may be too large to fit into the intended space.
There may be something (static content) that is obscuring the
@@ -481,14 +482,14 @@ Check the following:
My graphical images do not work properly.
-
See FOP Graphics Formats for a
+
See FOP Graphics Formats for a
list of supported graphics formats and related issues.
Why is my graphic rendered at a different resolution than it was created?
-
See Graphics Resolution.
+
See Graphics Resolution.
@@ -595,9 +596,9 @@ Check the following:
Hyphenation does not work.
-
Make sure you have set the language and/or country attributes for an appropriate XSL-FO element (fo:page-sequence, fo:block or fo:character):
+
Make sure you have set the language and optionally the country attributes for an appropriate XSL-FO element (fo:page-sequence, fo:block or fo:character):
-
See Hyphenation Support for details and instructions on using hyphenation with FOP.
+
See Hyphenation Support for details and instructions on using hyphenation with FOP.
Explicitly enable hyphenation for an appropriate XSL-FO element (fo:block, fo:character):
@@ -628,7 +629,7 @@ Check the following:
How do I use FOP in a servlet?
- See Using FOP in a Servlet.
+ See Using FOP in a Servlet.
@@ -637,7 +638,7 @@ Check the following:
transformation?
- See Using FOP in a Servlet with XSLT Transformation.
+ See Using FOP in a Servlet with XSLT Transformation.
@@ -645,7 +646,7 @@ Check the following:
How do I pass parameters to the XSLT transformation?
- See Using FOP in a Servlet with XSLT Transformation.
+ See Using FOP in a Servlet with XSLT Transformation.
@@ -663,7 +664,7 @@ Check the following:
How do I set the baseDir property in a servlet environment?
- See Setting the Configuration Programmatically.
+ See Setting the Configuration Programmatically.
@@ -671,7 +672,7 @@ Check the following:
How do I use a user configuration file from a servlet?
- See Using a Configuration File in an Embedded App.
+ See Using a Configuration File in an Embedded App.
@@ -680,7 +681,7 @@ Check the following:
get FOP working for various servlet engines?
- See Servlet Engines.
+ See Servlet Engines.
@@ -688,7 +689,7 @@ Check the following:
Can FOP be used in multithreaded environments?
- See Multithreading FOP.
+ See Multithreading FOP.
@@ -699,13 +700,13 @@ Check the following:
The rendering of SVG text in my PDF is of poor quality.
Can I control this?
-
See Placing SVG Text into PDF.
+
See Placing SVG Text into PDF.
How do I use FOP with SVG on headless servers?
-
See FOP: Graphics (Batik).
+
See FOP: Graphics (Batik).
@@ -768,7 +769,7 @@ Can I control this?
Why is my SVG rendered at a size different from that specified in my fo:external-graphic element?
-
See SVG Scaling.
+
See SVG Scaling.
@@ -801,7 +802,7 @@ Can I control this?
How do I embed fonts in PDF?
- See the Fonts page for information
+ See the Fonts page for information
about embedding fonts.
@@ -820,7 +821,7 @@ Can I control this?
set. For a variety of reasons, even those are not completely
guaranteed to work, for example you can't use the fi
ligature from the standard serif font. Check the overview for the default
+ href="0.93/output.html#pdf-fonts">overview for the default
PDF fonts.
@@ -828,7 +829,7 @@ Can I control this?
the desired character. Furthermore the font must be
available on the machine where the PDF is viewed or it must
have been embedded in the PDF file. See embedding fonts.
+ href="0.93/fonts.html">embedding fonts.
For most symbols, it is better to select the symbol font
@@ -846,7 +847,7 @@ Can I control this?
What tools are available for post-processing my PDF document?
-
See PDF Post-processing.
+
See PDF Post-processing.
@@ -854,8 +855,8 @@ Can I control this?
to my PDF document?
- See PDF Encryption.
- See also PDF Post-processing.
+ See PDF Encryption.
+ See also PDF Post-processing.
@@ -863,13 +864,13 @@ Can I control this?
How do I add document properties (title, author, etc.) to my
PDF document?
-
See PDF Post-processing.
+
See PDF Post-processing.
How do I add watermarks to my PDF document?
-
See PDF Watermarks.
+
See PDF Watermarks.
@@ -902,7 +903,7 @@ Can I control this?
This is a problem of Internet Explorer requesting the content several
- times. Please see the notes on Internet Explorer
+ times. Please see the notes on Internet Explorer
for more information.
diff --git a/src/documentation/content/xdocs/fo.xml b/src/documentation/content/xdocs/fo.xml
index fa7a16ca2..f61629ec8 100644
--- a/src/documentation/content/xdocs/fo.xml
+++ b/src/documentation/content/xdocs/fo.xml
@@ -17,7 +17,7 @@
-->
+ "http://svn.apache.org/viewvc/forrest/trunk/main/webapp/resources/schema/dtd/document-v12.dtd?view=co">
XSL-FO Input
@@ -463,7 +463,7 @@ This applies similarly to the extent of the after region and the bottom margin o
RenderX has provided an Unofficial DTD for FO Documents, which may be helpful in validating general FO issues.
- FOP also maintains an Unofficial FOP Schema in the FOP CVS Repository.
+ FOP also maintains an Unofficial FOP Schema in the FOP CVS Repository.
This document can be used either to validate against the FO standard, or against the actual FOP implementation.
See the notes near the beginning of the document for instructions on how to use it.
+ The Apache FOP team is proud to present to you the first
+ production grade release of the new FOP codebase. This release
+ has the new API first introduced in release 0.92 beta. It
+ contains again many bug fixes and new features.
+
- This is the development status of Apache FOP. Development on the maintenance branch where
- FOP 0.20.5 came from has been halted as the focus was transferred entirely to the redesign effort.
+ This is the development status of Apache FOP. Development on
+ the maintenance branch where FOP 0.20.5 came from has been
+ halted. The code base has been largely redesigned. The new
+ code base has reached release 0.93.
Development Status
-
- Development for FOP Trunk (aka Redesign) is addressing the design issues for layout and
- performance. The new design is focusing on making it possible to be conformant
- to the spec and be able to handle large documents.
-
-
- The first preview release (0.90alpha1) had similar functionality
- to previous FOP releases (although not in every point), some new features
- (like keeps on all implemented FOs), a rough API and a suitable design for
- developers to work on more functionality. It turned out that the new code
- is more stable and useful than we thought. In the meantime many of the
- problems reported since the initial release have already been resolved.
-
-
- We now have a good overall design and have been able to add several new features
- besides recreating most of the features from 0.20.5. We are doing ongoing work
- to make it easier for newbies to jump in and help. Furthermore, an extensive
- test suite helps us maintain and improve the quality of the package.
-
-
- Of course, we also welcome any help on the layout managers. So if you
- want to push your brain to the limit, come and join us! But don't worry:
- there are also various other locations where you can find an easier start
- into the code. And we're glad to help you get jumpstarted. Just ask!
-
+
The FOP code base has been largely rewritten, to address
+ design issues for layout and performance. The new design makes
+ it better possible to be conformant to the spec and be able to
+ handle large documents.
+
The redesign of the code base has largely been completed. The
+ new code reached production quality with release 0.93. In the
+ course of 2007 we plan to release version 1.0.
If you're looking for a long-term road-map we have to disappoint you. This is Open
Source and we're mostly voluteers working in their free time. What we have
@@ -150,10 +134,11 @@
Maintenance Status
- The latest maintenance release is FOP 0.20.5, released on July 18th, 2003.
- See release notes for more details.
- The maintenance branch has been frozen in 2004 so the team can concentrate
- on the redesign efforts.
+ The latest release of the maintenance branch is FOP 0.20.5,
+ released on July 18th, 2003. See release notes for more details. The
+ maintenance branch has been frozen in 2004 so the team can
+ concentrate on the new code base.
- FOP Trunk is the name for the current development code as found in the
- Subversion repository. This section of the FOP provides
- the documentation for this version.
+ FOP Trunk is the name for the current
+ development code as found in the Subversion repository. This
+ section of the FOP web site provides the documentation for
+ this version.
The Apache FOP team is proud to present to you the largely rewritten codebase which is
finally in a state where you can start to use it. It has taken over three years to get this
- far and over two years without a new release from the FOP project. 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
+ far and over two years without a new release from the FOP project. We're still in the process of adding new
+ features. We welcome any feedback you might have and even more, any
other form of help to get the project forward.
- More than half of the codebase has been rewritten over the last three years. The code is
- relatively new and possibly not as stable as version 0.20.5 in every regard. But the code
- is quickly approaching production level, especially when you're happy
- with only PDF and PostScript output.
+ More than half of the codebase has been rewritten over the last three years. With version 0.93 the code has reached production level.
- The API of FOP has changed considerably and is not backwards-compatible with version 0.20.5.
+ The API of FOP has changed considerably and is not
+ backwards-compatible with versions 0.20.5 and
+ 0.91beta. Version 0.92 introduced the new stable
+ API.
- If you are using a configuration file, you have to rebuild it in the new format. The format
+ Since version 0.92 some deprecated methods which were part
+ of the old API have been removed. If you upgrade from 0.91
+ beta, you will need to adjust your Java code. Similarly if
+ you upgrade from 0.92 and use deprecated methods.
+
+
+ If you are using a configuration file for version 0.20.5, you have to rebuild it in the new format. The format
of the configuration files has changed since version 0.20.5. See conf/fop.xconf for
an example configuration file. A XML Schema file can be found under
src/foschema/fop-configuration.xsd.
-
- There have been changes to the end-user API between 0.91 beta and 0.92 beta. With version 0.92,
- the API is now considered stable. Some methods have been deprecated and will be removed with
- the next release. If you upgrade from 0.91 beta, you will need to adjust your Java code.
+
+ If you are using font metrics files for version 0.20.5 or
+ 0.92 or earlier, you have to regenerate them in the new
+ format. The new format is characterized by a version
+ attribute on the top-level font-metrics element, whose value
+ is 2.0. The absence of a version attribute will be
+ interpreted as version 1.0, and such metrics files will no
+ longer be parsed.
@@ -67,7 +77,7 @@
Extensions and Renderers written for version 0.20.5 will not work with the new code! The new FOP
extension for Barcode4J will be available in
- January 2006.
+ January 2007.
The PCL Renderer and the MIF Handler have not been resurrected, yet! They are currently non-functional
diff --git a/status.xml b/status.xml
index 2cac780ee..b36c886b8 100644
--- a/status.xml
+++ b/status.xml
@@ -31,11 +31,11 @@
-
This is the first stable release after the big redesign
- effort.
+
This is the first production grade release of the new FOP
+ codebase.
-
The API was first introduced in release 0.92 beta. The
- preceding API has been removed.
+
It contains the new API first introduced in release 0.92
+ beta. The preceding API has been removed.