From b14cfce3f812f97852d88db7b837b55b0c55c625 Mon Sep 17 00:00:00 2001 From: Glenn Adams Date: Fri, 25 May 2012 19:10:28 +0000 Subject: [PATCH] Update FAQ and New Bug documentation. git-svn-id: https://svn.apache.org/repos/asf/xmlgraphics/fop/trunk@1342781 13f79535-47bb-0310-9956-ffa450edef68 --- src/documentation/content/xdocs/bugs.xml | 73 +++++++++++++++---- src/documentation/content/xdocs/faq.xml | 90 ++++++++++-------------- status.xml | 3 + 3 files changed, 99 insertions(+), 67 deletions(-) diff --git a/src/documentation/content/xdocs/bugs.xml b/src/documentation/content/xdocs/bugs.xml index e2f36d50d..caeb728b2 100644 --- a/src/documentation/content/xdocs/bugs.xml +++ b/src/documentation/content/xdocs/bugs.xml @@ -45,21 +45,66 @@ an email as changes are made to the issue.
Unreported Issues (Reporting New Issues) -

User reports of bugs and requests for enhancements are extremely -important parts of FOP development, and we appreciate the time you take to help -us track these issues down.

+

+ User reports of bugs and requests for enhancements are extremely + important parts of FOP development, and we appreciate the time you take to help + us track these issues down. +

diff --git a/src/documentation/content/xdocs/faq.xml b/src/documentation/content/xdocs/faq.xml index c4ddc6054..845c24045 100644 --- a/src/documentation/content/xdocs/faq.xml +++ b/src/documentation/content/xdocs/faq.xml @@ -25,7 +25,7 @@ What is Apache™ FOP?

- FOP is a print formatter for XSL formatting + FOP is a print formatter for XSL formatting objects.

@@ -65,16 +65,23 @@ How does FOP interact with other Apache Projects?

- FOP is distributed with Cocoon as a PDF serializer - for XSL (FO) documents. + XML Graphics Commons is used with + FOP to provide graphics functions that are common to a number of Apache projects.

- Batik can be used with + Batik is used with FOP to transcode an SVG image into a PDF document.

+

FOP also makes use of the following Apache projects:

+ @@ -83,7 +90,7 @@

XSL is a W3C standard concerned with publishing XML documents. It consists of two parts: XSLT and XSL-FO. The acronym expands to + href="#xslfo">XSL-FO. The acronym expands to eXtensible Stylesheet Language.

@@ -93,7 +100,9 @@ What is XSL-FO?

- XSLFO (aka XSL-FO) is an XML vocabulary that is used to specify a pagination and + XSLFO (aka XSL-FO) is an XML vocabulary, defined by W3C Recommendation + Extensible Stylesheet Language (XSL) + Version 1.1, that is used to specify a pagination and other styling for page layout output. The acronym “FO” stands for Formatting Objects. XSLFO can be @@ -226,8 +235,7 @@

This is usually caused by an older version of one of the FOP jars or - old XML tools in the classpath. Check in particular for parser.jar, - jaxp.jar, xml4j.jar or lotusxsl.jar. + old XML tools in the classpath.

Incompatible versions of Batik may also cause this problem. Use the @@ -269,8 +277,9 @@ the file: prefix, for example file.ext, path/file.ext or ../file.ext. The string file:path/file.ext is not a relative URL, - in fact, it isn't a valid URL at all. A relative URL is subject to a - resolving process, which transforms it into an absolute + in fact, it isn't a valid URL at all since the file + scheme does not (officially) support relative paths. A relative URL + is subject to a resolving process, which transforms it into an absolute URL.

Release Notes, the FOP Standards Compliance document, and the remaining FAQ in this document. If not found there, look at the @@ -1348,13 +1337,8 @@ Can I control this? Problems specific to a certain XSLT processor, like Xalan, Saxon or MSXML, should be handled by processor specific lists. This includes problems with deployment, processor specific extensions, suspected - bugs and processor specific APIs. Note that JDK 1.4 comes with an - XML parser and an XSLT processor which are older versions of - Xerces and Xalan, respectively, and both have a number of annoying - bugs. See http://java.sun.com/developer/EJTechTips/2003/tt0311.html - and http://java.sun.com/j2se/1.4.2/docs/guide/standards/ (or similar - pages for later Java releases) for some hints on how to use more - recent versions or other packages instead. + bugs and processor specific APIs. Note that JDK 1.4 and later come with an + XML parser and an XSLT processor which may be the source of the problem.
  • Problems with servlet containers should be asked on the vendor diff --git a/status.xml b/status.xml index fc5b5c630..a41223e6c 100644 --- a/status.xml +++ b/status.xml @@ -63,6 +63,9 @@ documents. Example: the fix of marks layering will be such a case when it's done. --> + + Update FAQ and New Bug documentation. + Added support for the role property on fo:page-sequence, fo:flow and fo:static-content. This allows to change the mapping of those FOs to PDF structure types when enabling -- 2.39.5