xmlgraphics-fop-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From jerem...@apache.org
Subject svn commit: r648206 - /xmlgraphics/fop/trunk/src/documentation/content/xdocs/trunk/embedding.xml
Date Tue, 15 Apr 2008 10:20:18 GMT
Author: jeremias
Date: Tue Apr 15 03:19:44 2008
New Revision: 648206

URL: http://svn.apache.org/viewvc?rev=648206&view=rev
Log:
Adjust information on logging given the availability of the event package.

Modified:
    xmlgraphics/fop/trunk/src/documentation/content/xdocs/trunk/embedding.xml

Modified: xmlgraphics/fop/trunk/src/documentation/content/xdocs/trunk/embedding.xml
URL: http://svn.apache.org/viewvc/xmlgraphics/fop/trunk/src/documentation/content/xdocs/trunk/embedding.xml?rev=648206&r1=648205&r2=648206&view=diff
==============================================================================
--- xmlgraphics/fop/trunk/src/documentation/content/xdocs/trunk/embedding.xml (original)
+++ xmlgraphics/fop/trunk/src/documentation/content/xdocs/trunk/embedding.xml Tue Apr 15 03:19:44
2008
@@ -175,23 +175,33 @@
         processing run anymore. The log output of multiple, simultaneously running FOP instances
         is sent to the same logger.
       </p>
-      <note>
-        We know this may be an issue in multi-threaded server environments if you'd like
to 
-        know what's going on in every single FOP processing run. We're planning to add an
-        additional feedback facility to FOP which can be used to obtain all sorts of specific
-        feedback (validation messages, layout problems etc.). "Static logging" is mainly

-        interesting for a developer working on FOP and for advanced users who are debugging

-        FOP. We don't consider the logging output to be useful to normal FOP users. Please
-        have some patience until we can add this feature or jump in and help us build it.
We've
-        set up a <a href="http://wiki.apache.org/xmlgraphics-fop/ProcessingFeedback">Wiki
page</a>
-        which documents what we're going to build.
-      </note>
       <p>
         By default, <a href="ext:commons-logging">Jakarta Commons Logging</a>
uses
         JDK logging (available in JDKs 1.4 or higher) as its backend. You can configure Commons
         Logging to use an alternative backend, for example Log4J. Please consult the
         <a href="ext:commons-logging">documentation for Jakarta Commons Logging</a>
on
         how to configure alternative backends.
+      </p>
+      <p>
+        As a result of the above we differentiate between to kinds of "logging":
+      </p>
+      <ul>
+        <li>(FOP-)Developer-oriented logging</li>
+        <li><a href="events.html">User/Integrator-oriented feedback</a>
(NEW!)</li>
+      </ul>
+      <p>
+        The use of "feedback" instead of "logging" is intentional. Most people were using
+        log output as a means to get feedback from events within FOP. Therefore, FOP now
+        includes an <code>event</code> package which can be used to receive feedback
from
+        the layout engine and other components within FOP <strong>per rendering run</strong>.
+        This feedback is not just some
+        text but event objects with parameters so these events can be interpreted by code.
+        Of course, there is a facility to turn these events into normal human-readable
+        messages. For details, please read on on the <a href="events.html">Events page</a>.
+        This leaves normal logging to be mostly a thing used by the FOP developers
+        although anyone can surely activate certain logging categories but the feedback
+        from the loggers won't be separated by processing runs. If this is required,
+        the <a href="events.html">Events subsystem</a> is the right approach.
       </p>
     </section>
   



---------------------------------------------------------------------
To unsubscribe, e-mail: fop-commits-unsubscribe@xmlgraphics.apache.org
For additional commands, e-mail: fop-commits-help@xmlgraphics.apache.org


Mime
View raw message