From: Glen Mazza Date: Mon, 4 Aug 2003 01:20:03 +0000 (+0000) Subject: Updated embedded.xml to give ViewCVS links to HEAD of the JAXP examples at the bottom. X-Git-Tag: Root_Temp_KnuthStylePageBreaking~1229 X-Git-Url: https://source.dussan.org/?a=commitdiff_plain;h=d7bdf03a367ee814650aaf30b82d0728cbd546d4;p=xmlgraphics-fop.git Updated embedded.xml to give ViewCVS links to HEAD of the JAXP examples at the bottom. git-svn-id: https://svn.apache.org/repos/asf/xmlgraphics/fop/trunk@196772 13f79535-47bb-0310-9956-ffa450edef68 --- diff --git a/src/documentation/content/xdocs/embedding.xml b/src/documentation/content/xdocs/embedding.xml index 1a0da1313..7aeb226e1 100644 --- a/src/documentation/content/xdocs/embedding.xml +++ b/src/documentation/content/xdocs/embedding.xml @@ -351,14 +351,17 @@ In general, you cannot safely run multiple threads through the AWT renderer.

Examples

-The directory "{fop-fir}/examples/embedding" contains several working examples. -In contrast of the examples above the examples here primarily use JAXP for +The directory "{fop-dir}/examples/embedding" contains several working examples. +In contrast to the examples above the examples here primarily use JAXP for XML access. This may be easier to understand for people familiar with JAXP.

ExampleFO2PDF.java

-This example demonstrates the basic usage pattern to transform an XSL-FO + + This example + +demonstrates the basic usage pattern to transform an XSL-FO file to PDF using FOP.

@@ -366,7 +369,10 @@ file to PDF using FOP.
ExampleXML2FO.java

-This example has nothing to do with FOP. It is there to show you how an XML + + This example + +has nothing to do with FOP. It is there to show you how an XML file can be converted to XSL-FO using XSLT. The JAXP API is used to do the transformation. Make sure you've got a JAXP-compliant XSLT processor in your classpath (ex. Xalan). @@ -376,7 +382,10 @@ classpath (ex. Xalan).

ExampleXML2PDF.java

-This example demonstrates how you can convert an arbitrary XML file to PDF + + This example + +demonstrates how you can convert an arbitrary XML file to PDF using XSLT and XSL-FO/FOP. It is a combination of the first two examples above. The example uses JAXP to transform the XML file to XSL-FO and FOP to transform the XSL-FO to PDF. @@ -394,7 +403,9 @@ performance is significantly higher with SAX.

ExampleObj2XML.java

-This example is a preparatory example for the next one. It's an example that + + This example +is a preparatory example for the next one. It's an example that shows how an arbitrary Java object can be converted to XML. It's an often needed task to do this. Often people create a DOM tree from a Java object and use that. This is pretty straightforward. The example here however shows how @@ -425,7 +436,10 @@ used. For more detailed information see other resources on JAXP (ex.

ExampleObj2PDF.java

-The last example here combines the previous and the third to demonstrate + + The last example + +here combines the previous and the third to demonstrate how you can transform a Java object to a PDF directly in one smooth run by generating SAX events from the Java object that get fed to an XSL transformation. The result of the transformation is then converted to PDF