<commit_before><?xml version="1.0" encoding="UTF-8"?>
<!--
    Licensed to the Apache Software Foundation (ASF) under one or more
    contributor license agreements.  See the NOTICE file distributed with
    this work for additional information regarding copyright ownership.
    The ASF licenses this file to You under the Apache License, Version 2.0
    (the "License"); you may not use this file except in compliance with
    the License.  You may obtain a copy of the License at

         http://www.apache.org/licenses/LICENSE-2.0

    Unless required by applicable law or agreed to in writing, software
    distributed under the License is distributed on an "AS IS" BASIS,
    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    See the License for the specific language governing permissions and
    limitations under the License.
-->

<document xmlns="http://maven.apache.org/XDOC/2.0"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/XDOC/2.0 http://maven.apache.org/xsd/xdoc-2.0.xsd">
  <properties>
    <title>Log4j JDK Logging Adaptor</title>
    <author email="<EMAIL>"><NAME></author>
  </properties>
  <body>
    <section name="JDK Logging Adaptor">
      <p>
        The JDK Logging Adaptor is a custom implementation of
        <a class="javadoc" href="http://docs.oracle.com/javase/6/docs/api/java/util/logging/LogManager.html">java.util.logging.LogManager</a>
        that uses <a href="../log4j-core/index.html">Log4j</a>.
      </p>
    </section>
    <section name="Requirements">
      <p>
        The JDK Logging Adaptor requires at least Java 6 and is dependent on the Log4j API and optionally Log4j Core.
      </p>
    </section>
    <section name="Usage">
      <p>
        To use the JDK Logging Adaptor, you must set the system property <code>java.util.logging.manager</code> to
        <a class="javadoc" href="apidocs/org/apache/logging/log4j/jul/LogManager.html">org.apache.logging.log4j.jul.LogManager</a>
      </p>
      <p>
        This must be done either through the command line (i.e., using the
        <code>-Djava.util.logging.manager=org.apache.logging.log4j.jul.LogManager</code> argument) or by using
        <code>System.setProperty()</code> before any calls are made to <code>LogManager</code> or <code>Logger</code>.
      </p>
    </section>
    <section name="Compatibility">
      <p>
        The use of a
        <a class="javadoc" href="http://docs.oracle.com/javase/6/docs/api/java/util/logging/Filter.html">java.util.logging.Filter</a>
        is supported on a per-<a class="javadoc" href="http://docs.oracle.com/javase/6/docs/api/java/util/logging/Logger.html">Logger</a>
        basis. However, it is recommended to use the standard <a href="../manual/filters.html">Filters</a> feature in
        Log4j instead.
      </p>
      <p>
        The use of
        <a class="javadoc" href="http://docs.oracle.com/javase/6/docs/api/java/util/logging/Handler.html">java.util.logging.Handler</a>
        classes is <em>NOT</em> supported. Custom Handlers should instead use an appropriate
        <a href="../manual/appenders.html">Appender</a> or code their own
        <a class="javadoc" href="../log4j-core/apidocs/org/apache/logging/log4j/core/Appender.html">Appender</a>
        plugin.
      </p>
      <p>
        Java logging levels are translated into Log4j logging levels dynamically. The following table lists the
        conversions between a Java logging level and its equivalent Log4j level. Custom levels should be implemented
        as an implementation of
        <a class="javadoc" href="apidocs/org/apache/logging/log4j/jul/LevelConverter.html">LevelConverter</a>, and the
        Log4j property <kbd>log4j.jul.levelConverter</kbd> must be set to your custom class name.
      </p>
      <table>
        <caption>Default Level conversions</caption>
        <thead>
          <tr>
            <th>Java Level</th>
            <th>Log4j Level</th>
          </tr>
        </thead>
        <tbody>
          <tr>
            <td><a class="javadoc" href="http://docs.oracle.com/javase/6/docs/api/java/util/logging/Level.html#OFF">OFF</a></td>
            <td>OFF</td>
          </tr>
          <tr>
            <td><a class="javadoc" href="http://docs.oracle.com/javase/6/docs/api/java/util/logging/Level.html#SEVERE">SEVERE</a></td>
            <td>ERROR</td>
          </tr>
          <tr>
            <td><a class="javadoc" href="http://docs.oracle.com/javase/6/docs/api/java/util/logging/Level.html#WARNING">WARNING</a></td>
            <td>WARN</td>
          </tr>
          <tr>
            <td><a class="javadoc" href="http://docs.oracle.com/javase/6/docs/api/java/util/logging/Level.html#INFO">INFO</a></td>
            <td>INFO</td>
          </tr>
          <tr>
            <td><a class="javadoc" href="http://docs.oracle.com/javase/6/docs/api/java/util/logging/Level.html#CONFIG">CONFIG</a></td>
            <td><a class="javadoc" href="apidocs/org/apache/logging/log4j/jul/LevelTranslator.html#CONFIG">CONFIG</a></td>
          </tr>
          <tr>
            <td><a class="javadoc" href="http://docs.oracle.com/javase/6/docs/api/java/util/logging/Level.html#FINE">FINE</a></td>
            <td>DEBUG</td>
          </tr>
          <tr>
            <td><a class="javadoc" href="http://docs.oracle.com/javase/6/docs/api/java/util/logging/Level.html#FINER">FINER</a></td>
            <td>TRACE</td>
          </tr>
          <tr>
            <td><a class="javadoc" href="http://docs.oracle.com/javase/6/docs/api/java/util/logging/Level.html#FINEST">FINEST</a></td>
            <td><a class="javadoc" href="apidocs/org/apache/logging/log4j/jul/LevelTranslator.html#FINEST">FINEST</a></td>
          </tr>
          <tr>
            <td>ALL</td>
            <td>ALL</td>
          </tr>
        </tbody>
      </table>
    </section>
  </body>
</document>
<commit_msg>Add note regarding custom JUL levels.<commit_after><?xml version="1.0" encoding="UTF-8"?>
<!--
    Licensed to the Apache Software Foundation (ASF) under one or more
    contributor license agreements.  See the NOTICE file distributed with
    this work for additional information regarding copyright ownership.
    The ASF licenses this file to You under the Apache License, Version 2.0
    (the "License"); you may not use this file except in compliance with
    the License.  You may obtain a copy of the License at

         http://www.apache.org/licenses/LICENSE-2.0

    Unless required by applicable law or agreed to in writing, software
    distributed under the License is distributed on an "AS IS" BASIS,
    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    See the License for the specific language governing permissions and
    limitations under the License.
-->

<document xmlns="http://maven.apache.org/XDOC/2.0"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/XDOC/2.0 http://maven.apache.org/xsd/xdoc-2.0.xsd">
  <properties>
    <title>Log4j JDK Logging Adaptor</title>
    <author email="<EMAIL>"><NAME></author>
  </properties>
  <body>
    <section name="JDK Logging Adaptor">
      <p>
        The JDK Logging Adaptor is a custom implementation of
        <a class="javadoc" href="http://docs.oracle.com/javase/6/docs/api/java/util/logging/LogManager.html">java.util.logging.LogManager</a>
        that uses <a href="../log4j-core/index.html">Log4j</a>.
      </p>
    </section>
    <section name="Requirements">
      <p>
        The JDK Logging Adaptor requires at least Java 6 and is dependent on the Log4j API and optionally Log4j Core.
      </p>
    </section>
    <section name="Usage">
      <p>
        To use the JDK Logging Adaptor, you must set the system property <code>java.util.logging.manager</code> to
        <a class="javadoc" href="apidocs/org/apache/logging/log4j/jul/LogManager.html">org.apache.logging.log4j.jul.LogManager</a>
      </p>
      <p>
        This must be done either through the command line (i.e., using the
        <code>-Djava.util.logging.manager=org.apache.logging.log4j.jul.LogManager</code> argument) or by using
        <code>System.setProperty()</code> before any calls are made to <code>LogManager</code> or <code>Logger</code>.
      </p>
    </section>
    <section name="Compatibility">
      <p>
        The use of a
        <a class="javadoc" href="http://docs.oracle.com/javase/6/docs/api/java/util/logging/Filter.html">java.util.logging.Filter</a>
        is supported on a per-<a class="javadoc" href="http://docs.oracle.com/javase/6/docs/api/java/util/logging/Logger.html">Logger</a>
        basis. However, it is recommended to use the standard <a href="../manual/filters.html">Filters</a> feature in
        Log4j instead.
      </p>
      <p>
        The use of
        <a class="javadoc" href="http://docs.oracle.com/javase/6/docs/api/java/util/logging/Handler.html">java.util.logging.Handler</a>
        classes is <em>NOT</em> supported. Custom Handlers should instead use an appropriate
        <a href="../manual/appenders.html">Appender</a> or code their own
        <a class="javadoc" href="../log4j-core/apidocs/org/apache/logging/log4j/core/Appender.html">Appender</a>
        plugin.
      </p>
      <p>
        Java logging levels are translated into Log4j logging levels dynamically. The following table lists the
        conversions between a Java logging level and its equivalent Log4j level. Custom levels should be implemented
        as an implementation of
        <a class="javadoc" href="apidocs/org/apache/logging/log4j/jul/LevelConverter.html">LevelConverter</a>, and the
        Log4j property <kbd>log4j.jul.levelConverter</kbd> must be set to your custom class name. Using the default
        <code>LevelConverter</code> implementation, custom logging levels are mapped to whatever the current level of
        the <code>Logger</code> being logged to is using.
      </p>
      <table>
        <caption>Default Level conversions</caption>
        <thead>
          <tr>
            <th>Java Level</th>
            <th>Log4j Level</th>
          </tr>
        </thead>
        <tbody>
          <tr>
            <td><a class="javadoc" href="http://docs.oracle.com/javase/6/docs/api/java/util/logging/Level.html#OFF">OFF</a></td>
            <td>OFF</td>
          </tr>
          <tr>
            <td><a class="javadoc" href="http://docs.oracle.com/javase/6/docs/api/java/util/logging/Level.html#SEVERE">SEVERE</a></td>
            <td>ERROR</td>
          </tr>
          <tr>
            <td><a class="javadoc" href="http://docs.oracle.com/javase/6/docs/api/java/util/logging/Level.html#WARNING">WARNING</a></td>
            <td>WARN</td>
          </tr>
          <tr>
            <td><a class="javadoc" href="http://docs.oracle.com/javase/6/docs/api/java/util/logging/Level.html#INFO">INFO</a></td>
            <td>INFO</td>
          </tr>
          <tr>
            <td><a class="javadoc" href="http://docs.oracle.com/javase/6/docs/api/java/util/logging/Level.html#CONFIG">CONFIG</a></td>
            <td><a class="javadoc" href="apidocs/org/apache/logging/log4j/jul/LevelTranslator.html#CONFIG">CONFIG</a></td>
          </tr>
          <tr>
            <td><a class="javadoc" href="http://docs.oracle.com/javase/6/docs/api/java/util/logging/Level.html#FINE">FINE</a></td>
            <td>DEBUG</td>
          </tr>
          <tr>
            <td><a class="javadoc" href="http://docs.oracle.com/javase/6/docs/api/java/util/logging/Level.html#FINER">FINER</a></td>
            <td>TRACE</td>
          </tr>
          <tr>
            <td><a class="javadoc" href="http://docs.oracle.com/javase/6/docs/api/java/util/logging/Level.html#FINEST">FINEST</a></td>
            <td><a class="javadoc" href="apidocs/org/apache/logging/log4j/jul/LevelTranslator.html#FINEST">FINEST</a></td>
          </tr>
          <tr>
            <td>ALL</td>
            <td>ALL</td>
          </tr>
        </tbody>
      </table>
    </section>
  </body>
</document>

{'fraction_non_alphanumeric': 0.14905753968253968, 'fraction_numerical': 0.008267195767195767, 'mean_word_length': 2.5033304373008978, 'pattern_counts': {'":': 0, '<': 323, '<?xml version=': 2, '>': 323, 'https://': 0, 'lorem ipsum': 0, 'www.': 4, 'xml': 6}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '952099', 'n_tokens_mistral': 3957, 'n_tokens_neox': 3796, 'n_words': 862}