diff options
| -rw-r--r-- | src/documentation/content/xdocs/embedding.xml | 29 |
1 files changed, 27 insertions, 2 deletions
diff --git a/src/documentation/content/xdocs/embedding.xml b/src/documentation/content/xdocs/embedding.xml index 9345d2a90..ac707fa73 100644 --- a/src/documentation/content/xdocs/embedding.xml +++ b/src/documentation/content/xdocs/embedding.xml @@ -65,12 +65,37 @@ 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 + is handled by Driver. You want to set both using an implementation of org.apache.commons.logging.Log. See <jump href="#logging">below</jump> for more information. </p> @@ -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> |