Skip to content

Commit

Permalink
- in index.html added links to the migrator tool and the page on
Browse files Browse the repository at this point in the history
brinding legacy apis

- minor editing in legacy.html
  • Loading branch information
ceki committed Oct 31, 2009
1 parent 0195ace commit 8c91c8f
Show file tree
Hide file tree
Showing 2 changed files with 20 additions and 10 deletions.
11 changes: 11 additions & 0 deletions slf4j-site/src/site/pages/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -36,6 +36,17 @@ <h1>Simple Logging Facade for Java (SLF4J)</h1>
the two-page <a href="manual.html">SLF4J user manual</a>.
</p>

<p>In case you wish to migrate your Java source files to SLF4J,
consider our <a href="migrator.html">migrator tool</a> which can
migrate your project into SLF4J in minutes.</p>

<p>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 <a
href="legacy.html">legacy APIs</a>.
</p>


<script src="templates/footer.js" type="text/javascript"></script>
</div>
</body>
Expand Down
19 changes: 9 additions & 10 deletions slf4j-site/src/site/pages/legacy.html
Original file line number Diff line number Diff line change
Expand Up @@ -186,7 +186,7 @@ <h4>log4j-over-slf4j.jar and slf4j-logj12.jar cannot be present
log4j. The presence of <em>log4j-over-slf4j.jar</em> 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.
</p>

<h3><a name="jul-to-slf4j" href="jul-to-slf4j">JUL to SLF4J</a></h3>
Expand All @@ -202,16 +202,15 @@ <h3><a name="jul-to-slf4j" href="jul-to-slf4j">JUL to SLF4J</a></h3>
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 <a
namespace cannot be replaced. Instead, translates <a
href="http://java.sun.com/j2se/1.5.0/docs/api/java/util/logging/LogRecord.html?is-external=true">LogRecord</a>
instance regardless of whether the SLF4J logger is disabled for
the given level or nor. <b>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).</b>
object into its SLF4J equivalent on each logging event. Please
note this traslation process incurs the cost of constructing a
<code>LogRecord</code> instance regardless of whether the SLF4J
logger is disabled for the given level or nor. <b>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).</b>
</p>

<p>If application performance is a concern, then use of
Expand Down

0 comments on commit 8c91c8f

Please sign in to comment.