You are viewing a plain text version of this content. The canonical link for it is here.
Posted to fop-commits@xmlgraphics.apache.org by ac...@apache.org on 2008/04/15 12:57:51 UTC
svn commit: r648209 - in /xmlgraphics/fop/branches/Temp_AFPGOCAResources: ./
src/documentation/content/xdocs/trunk/embedding.xml
Author: acumiskey
Date: Tue Apr 15 03:57:39 2008
New Revision: 648209
URL: http://svn.apache.org/viewvc?rev=648209&view=rev
Log:
Merged revisions 648206 via svnmerge from
https://svn.apache.org/repos/asf/xmlgraphics/fop/trunk
........
r648206 | jeremias | 2008-04-15 11:19:44 +0100 (Tue, 15 Apr 2008) | 1 line
Adjust information on logging given the availability of the event package.
........
Modified:
xmlgraphics/fop/branches/Temp_AFPGOCAResources/ (props changed)
xmlgraphics/fop/branches/Temp_AFPGOCAResources/src/documentation/content/xdocs/trunk/embedding.xml
Propchange: xmlgraphics/fop/branches/Temp_AFPGOCAResources/
------------------------------------------------------------------------------
--- svnmerge-integrated (original)
+++ svnmerge-integrated Tue Apr 15 03:57:39 2008
@@ -1 +1 @@
-/xmlgraphics/fop/trunk:1-648185
+/xmlgraphics/fop/trunk:1-648207
Modified: xmlgraphics/fop/branches/Temp_AFPGOCAResources/src/documentation/content/xdocs/trunk/embedding.xml
URL: http://svn.apache.org/viewvc/xmlgraphics/fop/branches/Temp_AFPGOCAResources/src/documentation/content/xdocs/trunk/embedding.xml?rev=648209&r1=648208&r2=648209&view=diff
==============================================================================
--- xmlgraphics/fop/branches/Temp_AFPGOCAResources/src/documentation/content/xdocs/trunk/embedding.xml (original)
+++ xmlgraphics/fop/branches/Temp_AFPGOCAResources/src/documentation/content/xdocs/trunk/embedding.xml Tue Apr 15 03:57:39 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