From 8c91c8ff649bc3222753049d487b276a240ec182 Mon Sep 17 00:00:00 2001 From: Ceki Gulcu Date: Sat, 31 Oct 2009 05:43:00 +0100 Subject: [PATCH] - in index.html added links to the migrator tool and the page on brinding legacy apis - minor editing in legacy.html --- slf4j-site/src/site/pages/index.html | 11 +++++++++++ slf4j-site/src/site/pages/legacy.html | 19 +++++++++---------- 2 files changed, 20 insertions(+), 10 deletions(-) diff --git a/slf4j-site/src/site/pages/index.html b/slf4j-site/src/site/pages/index.html index 733297042..764e18f35 100644 --- a/slf4j-site/src/site/pages/index.html +++ b/slf4j-site/src/site/pages/index.html @@ -36,6 +36,17 @@

Simple Logging Facade for Java (SLF4J)

the two-page SLF4J user manual.

+

In case you wish to migrate your Java source files to SLF4J, + consider our migrator tool which can + migrate your project into SLF4J in minutes.

+ +

In case an externally-maintained component you depend on uses a + logging API other than SLF4J, such as commons logging, log4j or + j.u.l, have a look at SLF4J's binary-support for legacy APIs. +

+ + diff --git a/slf4j-site/src/site/pages/legacy.html b/slf4j-site/src/site/pages/legacy.html index e729d8287..598b4942a 100644 --- a/slf4j-site/src/site/pages/legacy.html +++ b/slf4j-site/src/site/pages/legacy.html @@ -186,7 +186,7 @@

log4j-over-slf4j.jar and slf4j-logj12.jar cannot be present log4j. The presence of log4j-over-slf4j.jar will in turn delegate all log4j API calls to their SLF4J equivalents. If both are present simultaneously, slf4j calls will be delegated to log4j, and - log4j calls redirected to SLF4j, resulting in an endless recursion. + log4j calls redirected to SLF4j, resulting in an endless loop.

JUL to SLF4J

@@ -202,16 +202,15 @@

JUL to SLF4J

log4j-over-slf4j, which re-implement JCL and respectively log4j, the jul-to-slf4j modules does not re-implement the java.util.logging package because packages under the java.* - namespace cannot be replaced. Instead, translates LogRecord into - their SLF4J equivalents. Please note that translating - java.util.logging events into SLF4J incurs the cost of - constructing LogRecord - instance regardless of whether the SLF4J logger is disabled for - the given level or nor. Consequently, j.u.l. to SLF4J translation - can seriously impact on the cost of disabled logging statements - (60 fold increase) and a measurable impact on enabled log - statements (20% overall increase). + object into its SLF4J equivalent on each logging event. Please + note this traslation process incurs the cost of constructing a + LogRecord instance regardless of whether the SLF4J + logger is disabled for the given level or nor. Consequently, + j.u.l. to SLF4J translation can seriously impact on the cost of + disabled logging statements (60 fold increase) and a measurable + impact on enabled log statements (20% overall increase).

If application performance is a concern, then use of