From d7bdf03a367ee814650aaf30b82d0728cbd546d4 Mon Sep 17 00:00:00 2001
From: Glen Mazza
Date: Mon, 4 Aug 2003 01:20:03 +0000
Subject: 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
---
src/documentation/content/xdocs/embedding.xml | 28 ++++++++++++++++++++-------
1 file changed, 21 insertions(+), 7 deletions(-)
(limited to 'src/documentation/content/xdocs/embedding.xml')
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
--
cgit v1.2.3