The branch, master has been updated via f8de3ee60aa6480630b97496b00d01fe49d958ae (commit) from 87ab8377b3e25ac0accf5784f78a393bde865405 (commit) Those revisions listed above that are new to this repository have not appeared on any other notification email; so we list those revisions in full, below. - Log ----------------------------------------------------------------- http://git.qos.ch/gitweb/?p=logback.git;a=commit;h=f8de3ee60aa6480630b97496b... http://github.com/ceki/logback/commit/f8de3ee60aa6480630b97496b00d01fe49d958... commit f8de3ee60aa6480630b97496b00d01fe49d958ae Author: Ceki Gulcu <ceki@qos.ch> Date: Tue Nov 10 00:17:50 2009 +0100 - ongoing editing diff --git a/logback-site/src/site/pages/manual/filters.html b/logback-site/src/site/pages/manual/filters.html index 957ba15..fcedf77 100644 --- a/logback-site/src/site/pages/manual/filters.html +++ b/logback-site/src/site/pages/manual/filters.html @@ -252,34 +252,29 @@ public class SampleFilter extends Filter>ILoggingEvent> { <p>The <code>EventEvaluator</code> class is abstract and you can implement your own even evaluation logic. Logback-classic ships with a concrete evaluator implementation called <a - href="../xref/ch/qos/logback/classic/boolex/JaninoEvaluator.html">JaninoEvaluator</a> - which take artibtrary java expressions as the evaluation criteria, - enabling unprecedented flexibility for filtering logging events. + href="../xref/ch/qos/logback/classic/boolex/JaninoEventEvaluator.html">JaninoEventEvaluator</a> + which takes artibtrary boolean expressions (in the Java language) + as the evaluation criispteria. We refer to such artbitrary boolean + expressions in the Java language as "<em>evaulation + expressions</em>". Evaluation expressions enable hereto + unprecedented flexibility in event filtering. </p> - - <p>A special category of filters is implemented by the <a - href="../xref/ch/qos/logback/core/filter/EvaluatorFilter.html"> - <code>EvaluatorFilter</code></a> class. These filters use an <a - href="../xref/ch/qos/logback/core/boolex/EventEvaluator.html"> - <code>EventEvaluator</code></a> object to decide whether to accept - or deny a request. This allows unprecedented flexibility in the - way that you can affect filtering of logging events. + + <p>Evaluation expressions are compiled on-the-fly during the + interpretation of the configuration file. As a user, you do not + need to worry about the actual plumbing. However, it is your + reponsibility to ensure that the expression is boolean, that it + evaluates to true or false. </p> + + + <p>Given that an evaluation expression is acts on the current + logging event, logback implicitly exposes various fields of a + logging event as variables accessible from the evaluation + expression. The list of these implicit variables is given + below. The scope of evaluation expressions is limited to the + logging event. </p> - <p>As a user, you do not need to worry about the actual - plumbing. All you need to do is to give a name to the evaluator - and to specify an <em>evaluation expression</em>, that is a - boolean expression in regular Java syntax. These evaluation - expressions are compiled on-the-fly during the interpretation of - the configuration file. It is the users reponsibility to ensure - that the expression is boolean, that it evaluates to true or - false. In evaluation expressions, logback implicitly exposes - various fields of a logging event as variables. The list of these - implicit variables is given below. The scope of evaluation - expressions is limited to the logging event. - </p> - - <table class="bodyTable"> <tr> <th>Name</th> ----------------------------------------------------------------------- Summary of changes: logback-site/src/site/pages/manual/filters.html | 45 ++++++++++------------- 1 files changed, 20 insertions(+), 25 deletions(-) hooks/post-receive -- Logback: the generic, reliable, fast and flexible logging framework.