<section id="examples">
<title>Examples</title>
<p>
-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.
</p>
<section id="ExampleFO2PDF">
<title>ExampleFO2PDF.java</title>
<p>
-This example demonstrates the basic usage pattern to transform an XSL-FO
+ <fork href="http://cvs.apache.org/viewcvs.cgi/xml-fop/examples/embedding/java/embedding/ExampleFO2PDF.java?rev=HEAD">
+ This example
+ </fork>
+demonstrates the basic usage pattern to transform an XSL-FO
file to PDF using FOP.
</p>
<figure src="images/EmbeddingExampleFO2PDF.png" alt="Example XSL-FO to PDF"/>
<section id="ExampleXML2FO">
<title>ExampleXML2FO.java</title>
<p>
-This example has nothing to do with FOP. It is there to show you how an XML
+ <fork href="http://cvs.apache.org/viewcvs.cgi/xml-fop/examples/embedding/java/embedding/ExampleXML2FO.java?rev=HEAD">
+ This example
+ </fork>
+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. <fork href="http://xml.apache.org/xalan-j">Xalan</fork>).
<section id="ExampleXML2PDF">
<title>ExampleXML2PDF.java</title>
<p>
-This example demonstrates how you can convert an arbitrary XML file to PDF
+ <fork href="http://cvs.apache.org/viewcvs.cgi/xml-fop/examples/embedding/java/embedding/ExampleXML2PDF.java?rev=HEAD">
+ This example
+ </fork>
+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.
<section id="ExampleObj2XML">
<title>ExampleObj2XML.java</title>
<p>
-This example is a preparatory example for the next one. It's an example that
+ <fork href="http://cvs.apache.org/viewcvs.cgi/xml-fop/examples/embedding/java/embedding/ExampleObj2XML.java?rev=HEAD">
+ This example</fork>
+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
<section id="ExampleObj2PDF">
<title>ExampleObj2PDF.java</title>
<p>
-The last example here combines the previous and the third to demonstrate
+ <fork href="http://cvs.apache.org/viewcvs.cgi/xml-fop/examples/embedding/java/embedding/ExampleObj2PDF.java?rev=HEAD">
+ The last example
+ </fork>
+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