Author: psmith Date: Wed Jun 20 15:11:04 2007 New Revision: 549274 URL: http://svn.apache.org/viewvc?view=rev&rev=549274 Log: Tidied up site and documentation.
Added: logging/sandbox/jul-to-log4j-bridge/src/site/apt/ logging/sandbox/jul-to-log4j-bridge/src/site/apt/examples.apt logging/sandbox/jul-to-log4j-bridge/src/site/apt/intro.apt logging/sandbox/jul-to-log4j-bridge/src/site/apt/keyclasses.apt Modified: logging/sandbox/jul-to-log4j-bridge/README.txt logging/sandbox/jul-to-log4j-bridge/pom.xml logging/sandbox/jul-to-log4j-bridge/src/changes/changes.xml logging/sandbox/jul-to-log4j-bridge/src/site/site.xml Modified: logging/sandbox/jul-to-log4j-bridge/README.txt URL: http://svn.apache.org/viewvc/logging/sandbox/jul-to-log4j-bridge/README.txt?view=diff&rev=549274&r1=549273&r2=549274 ============================================================================== --- logging/sandbox/jul-to-log4j-bridge/README.txt (original) +++ logging/sandbox/jul-to-log4j-bridge/README.txt Wed Jun 20 15:11:04 2007 @@ -1,35 +1,9 @@ +Apache Logging Services - java.util.logging->log4j Bridge + Bridging support between the java.util.logging (JUL) framework and log4j. Requirements: JDK 1.4+, and log4j 1.2.15 This library will not work with log4j 1.2.14 or earlier. -Key classes: - - * org.apache.logging.julbridge.JULLog4jBridge - main entry point to configure a bridge - * org.apache.logging.julbridge.JULLevelConverter - Because the JUL Level classes are quite different - this converter interface performs the mapping into the log4j Level space. In - many cases you can use a default converter. - -Example 1 - Completely take over JUL and route all LogRecords into log4j -======================================================================== - - JULLog4jBridge.assimilate(); - -Example 2 - As (1), but using log4j XML configuration -======================================================================== - - <log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/" debug="true"> - <plugin name="julreceiver" class="org.apache.log4j.jul.JULReceiver" /> - ...... - </log4j:configuration> - -Example 2 - Bridge a single JUL Logger -======================================= - - JULLog4jBridge.bridgeJULLogger("foo"); - - This bridges all events posted to the 'foo' logger into log4j's Logger called 'foo'. - - NOTE: this does NOT automatically bridge child Loggers. - +Please read the documentation found in src/site/apt/. \ No newline at end of file Modified: logging/sandbox/jul-to-log4j-bridge/pom.xml URL: http://svn.apache.org/viewvc/logging/sandbox/jul-to-log4j-bridge/pom.xml?view=diff&rev=549274&r1=549273&r2=549274 ============================================================================== --- logging/sandbox/jul-to-log4j-bridge/pom.xml (original) +++ logging/sandbox/jul-to-log4j-bridge/pom.xml Wed Jun 20 15:11:04 2007 @@ -2,8 +2,9 @@ <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>org.apache.logging</groupId> - <artifactId>apache-juli-log4j-bridge</artifactId> - <version>0.1.0</version> + <name>java.util.logging to log4j Bridge</name> + <artifactId>apache-jul-log4j-bridge</artifactId> + <version>1.0.0-SNAPSHOT</version> <description>Bridge JDK 1.4+ java.util.Logging to Apache log4j</description> <url>http://logging.apache.org/log4j</url> <issueManagement> @@ -69,9 +70,9 @@ </license> </licenses> <scm> - <connection>scm:svn:http://svn.apache.org/repos/asf/logging/sandbox/juli-log4j-bridge</connection> - <developerConnection>scm:svn:https://svn.apache.org/repos/asf/logging/sandbox/juli-log4j-bridge</developerConnection> - <url>http://svn.apache.org/viewcvs.cgi/logging/sandbox/juli-logging-bridge</url> + <connection>scm:svn:http://svn.apache.org/repos/asf/logging/sandbox/jul-to-log4j-bridge</connection> + <developerConnection>scm:svn:https://svn.apache.org/repos/asf/logging/sandbox/jul-to-log4j-bridge</developerConnection> + <url>http://svn.apache.org/viewcvs.cgi/logging/sandbox/jul-to-log4j-bridge</url> </scm> <organization> <name>Apache Software Foundation</name> @@ -85,7 +86,7 @@ <dependency> <groupId>log4j</groupId> <artifactId>log4j</artifactId> - <version>1.2.15</version> + <version>1.2.14</version> </dependency> </dependencies> </plugin> Modified: logging/sandbox/jul-to-log4j-bridge/src/changes/changes.xml URL: http://svn.apache.org/viewvc/logging/sandbox/jul-to-log4j-bridge/src/changes/changes.xml?view=diff&rev=549274&r1=549273&r2=549274 ============================================================================== --- logging/sandbox/jul-to-log4j-bridge/src/changes/changes.xml (original) +++ logging/sandbox/jul-to-log4j-bridge/src/changes/changes.xml Wed Jun 20 15:11:04 2007 @@ -1 +1 @@ -<!-- 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> <properties> <title>Component</title> </properties> <body> <release version="0.1" date="2099-01-01" description="First release"> <action dev="carnold" issue="42094" type="add"> Initial release of Component framework backported from log4j 1.3. </action> </release> </body> </document> \ No newline at end of file +<!-- 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> <properties> <title>Component</title> </properties> <body> <!-- <release version="0.1" date="2099-01-01" description="First release"> <action dev="carnold" issue="42094" type="add"> Initial release of Component framework backported from log4j 1.3. </action> </release> --> </body> </document> \ No newline at end of file Added: logging/sandbox/jul-to-log4j-bridge/src/site/apt/examples.apt URL: http://svn.apache.org/viewvc/logging/sandbox/jul-to-log4j-bridge/src/site/apt/examples.apt?view=auto&rev=549274 ============================================================================== --- logging/sandbox/jul-to-log4j-bridge/src/site/apt/examples.apt (added) +++ logging/sandbox/jul-to-log4j-bridge/src/site/apt/examples.apt Wed Jun 20 15:11:04 2007 @@ -0,0 +1,32 @@ +Examples + +* Example 1 - Completely take over JUL and route all LogRecords into log4j + ++-------------------+ +JULLog4jBridge.assimilate(); ++-------------------+ + +* Example 2 - As (1), but using log4j XML configuration + ++-------------------+ +<log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/" debug="true"> + <plugin name="julreceiver" class="org.apache.log4j.jul.JULReceiver" /> + ...... +</log4j:configuration> ++-------------------+ + +* Example 3 - Bridge a single JUL Logger + ++-------------------+ +JULLog4jBridge.bridgeJULLogger("foo"); ++-------------------+ + + This bridges all events posted to the 'foo' logger into log4j's Logger called 'foo'. + + <<NOTE:>> this does <<NOT>> automatically bridge child Loggers. + +* Example 4 - Reset java.util.logging back to pristine state + ++-------------------+ +JULLog4jBridge.repatriate(); ++-------------------+ Added: logging/sandbox/jul-to-log4j-bridge/src/site/apt/intro.apt URL: http://svn.apache.org/viewvc/logging/sandbox/jul-to-log4j-bridge/src/site/apt/intro.apt?view=auto&rev=549274 ============================================================================== --- logging/sandbox/jul-to-log4j-bridge/src/site/apt/intro.apt (added) +++ logging/sandbox/jul-to-log4j-bridge/src/site/apt/intro.apt Wed Jun 20 15:11:04 2007 @@ -0,0 +1,9 @@ +Introduction + + Bridging support between the java.util.logging (JUL) framework and log4j. + + Requirements: + + * JDK 1.4+ + + * log4j 1.2.15 - This library will not work with log4j 1.2.14 or earlier. Added: logging/sandbox/jul-to-log4j-bridge/src/site/apt/keyclasses.apt URL: http://svn.apache.org/viewvc/logging/sandbox/jul-to-log4j-bridge/src/site/apt/keyclasses.apt?view=auto&rev=549274 ============================================================================== --- logging/sandbox/jul-to-log4j-bridge/src/site/apt/keyclasses.apt (added) +++ logging/sandbox/jul-to-log4j-bridge/src/site/apt/keyclasses.apt Wed Jun 20 15:11:04 2007 @@ -0,0 +1,8 @@ +Key classes + + * {{{apidocs/org/apache/logging/julbridge/JULLog4jBridge.html}org.apache.logging.julbridge.JULLog4jBridge}} - main entry point to configure a bridge + + * {{{apidocs/org/apache/logging/julbridge/JULLevelConverter.html}org.apache.logging.julbridge.JULLevelConverter}} - Because the JUL Level classes are quite different + this converter interface performs the mapping into the log4j Level space. In + many cases you can use a default converter. + Modified: logging/sandbox/jul-to-log4j-bridge/src/site/site.xml URL: http://svn.apache.org/viewvc/logging/sandbox/jul-to-log4j-bridge/src/site/site.xml?view=diff&rev=549274&r1=549273&r2=549274 ============================================================================== --- logging/sandbox/jul-to-log4j-bridge/src/site/site.xml (original) +++ logging/sandbox/jul-to-log4j-bridge/src/site/site.xml Wed Jun 20 15:11:04 2007 @@ -15,7 +15,7 @@ limitations under the License. --> -<project name="Component"> +<project name="apache-jul-to-log4j-bridge"> <bannerLeft> <name>Logging Services</name> <src>images/ls-logo.jpg</src> @@ -31,6 +31,12 @@ <item name="Log4j" href="http://logging.apache.org/log4j/"/> <item name="Log4j Companions" href="http://logging.apache.org/log4j/companions"/> </links> + <menu name="JUL->log4j Bridge"> + <item name="Introduction" href="intro.html"/> + <item name="Examples" href="examples.html"/> + <item name="Key Classes" href="keyclasses.html"/> + + </menu> <menu ref="reports"/> </body> </project> --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]