Returned documentation on how to do Avalon logging; documentation now in two sections.

git-svn-id: https://svn.apache.org/repos/asf/xmlgraphics/fop/trunk@197497 13f79535-47bb-0310-9956-ffa450edef68

diff --git a/src/documentation/content/xdocs/embedding.xml b/src/documentation/content/xdocs/embedding.xml
index 9345d2a904fb37104245a56138caba53a442bb66..ac707fa732d0623dd388eb7d17f9005d3e32f3c6 100644 (file)
--- a/src/documentation/content/xdocs/embedding.xml
+++ b/src/documentation/content/xdocs/embedding.xml
@@ -65,8 +65,33 @@ driver.run();]]></source>
 In the example above, args[0] contains the path to an XSL-FO file, while 
 args[1] contains a path for the target PDF file.
   </p>
-  <section id="basic-logging">
+ <section id="basic-logging">
     <title>Logging</title>
+    <p>
+      You also need to set up logging. Global logging for all FOP
+      processes is managed by MessageHandler. Per-instance logging
+      is handled by Driver. You want to set both using an implementation
+      of org.apache.avalon.framework.logger.Logger. See 
+      <jump href="#logging">below</jump> for more information.
+    </p>
+    <p>
+      Call <code>setLogger(Logger)</code> always immediately after 
+      instantiating the Driver object. See here:
+    </p>
+    <source><![CDATA[
+import org.apache.avalon.framework.logger.Logger; 
+import org.apache.avalon.framework.logger.ConsoleLogger; 
+
+/*..*/
+
+Driver driver = new Driver();
+Logger logger = new ConsoleLogger(ConsoleLogger.LEVEL_INFO);
+MessageHandler.setScreenLogger(logger);
+driver.setLogger(logger);]]></source>
+  </section>
+  
+  <section id="basic-logging-new-version">
+    <title>Logging (Upcoming FOP 1.0 Version only)</title>
     <p>
       You also need to set up logging. Global logging for all FOP
       processes is managed by MessageHandler. Per-instance logging
@@ -160,7 +185,7 @@ transformer.transform(src, res);]]></source>
   <section id="logging">
     <title>Controlling logging</title>
     <p>
-      FOP uses the
+      Current FOP 0.20.x production uses the
       <fork href="http://avalon.apache.org/framework/api/org/apache/avalon/framework/logger/package-summary.html">Logger package</fork>
       from Apache Avalon Framework to do logging. See the 
       <fork href="http://avalon.apache.org/framework/">Apache Avalon Framework</fork>