Siphalor/tweed5-commons-logging
1
0
Fork 0
Code Activity

Use HTTPS

Browse Source
This commit is contained in:
Gary Gregory
2023-11-19 08:53:14 -05:00
parent cd210b5d9b
commit 38f9e3dac8
10 changed files with 120 additions and 136 deletions
Download Patch File Download Diff File Expand all files Collapse all files

82
src/site/site.xml
View File

@@ -1,64 +1,48 @@
<?xml version="1.0" encoding="ISO-8859-1"?> <?xml version="1.0" encoding="ISO-8859-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 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.
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.
--> -->
<project xmlns="http://maven.apache.org/DECORATION/1.1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
<project xmlns="http://maven.apache.org/DECORATION/1.1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/DECORATION/1.1.0 http://maven.apache.org/xsd/decoration-1.1.0.xsd"> xsi:schemaLocation="http://maven.apache.org/DECORATION/1.1.0 http://maven.apache.org/xsd/decoration-1.1.0.xsd">
<bannerRight> <bannerRight>
<name>Commons Logging</name> <name>Commons Logging</name>
<src>/images/logo.png</src> <src>/images/logo.png</src>
<href>http://commons.apache.org/logging/</href> <href>https://commons.apache.org/logging/</href>
</bannerRight> </bannerRight>
<body> <body>
<menu name="Commons Logging"> <menu name="Commons Logging">
<item name="Overview" <item name="Overview" href="/index.html" />
href="/index.html"/> <item name="Download" href="/download_logging.cgi" />
<item name="Download" <item name="User Guide" href="/guide.html" />
href="/download_logging.cgi"/> <item name="Troubleshooting Guide" href="/troubleshooting.html" />
<item name="User Guide" <item name="Release Notes" href="/RELEASE-NOTES.txt" />
href="/guide.html"/> <item name='Javadoc (Latest release)' href='/javadocs/api-release/index.html' />
<item name="Troubleshooting Guide" <item name='Javadoc (v1.1.3)' href='/javadocs/api-1.1.3/index.html' />
href="/troubleshooting.html"/> <item name='Javadoc (v1.0.4)' href='/javadocs/api-1.0.4/index.html' />
<item name="Release Notes"
href="/RELEASE-NOTES.txt"/>
<item name='Javadoc (Latest release)'
href='/javadocs/api-release/index.html'/>
<item name='Javadoc (v1.1.3)'
href='/javadocs/api-1.1.3/index.html'/>
<item name='Javadoc (v1.0.4)'
href='/javadocs/api-1.0.4/index.html'/>
</menu> </menu>
<menu name="Development"> <menu name="Development">
<item name="Building" <item name="Building" href="/building.html" />
href="/building.html"/> <item name="Mailing Lists" href="/mail-lists.html" />
<item name="Mailing Lists" <item name="Issue Tracking" href="/issue-tracking.html" />
href="/mail-lists.html"/> <item name="Proposal" href="/proposal.html" />
<item name="Issue Tracking" <item name="Tech Guide" href="/tech.html" />
href="/issue-tracking.html"/> <item name="Wiki" href="https://wiki.apache.org/commons/Logging" />
<item name="Proposal" <item name='Javadoc (SVN latest)' href='/apidocs/index.html' />
href="/proposal.html"/> </menu>
<item name="Tech Guide"
href="/tech.html"/>
<item name="Wiki"
href="http://wiki.apache.org/commons/Logging"/>
<item name='Javadoc (SVN latest)'
href='/apidocs/index.html'/>
</menu>
</body> </body>
</project> </project>

6
src/site/xdoc/building.xml
View File

@@ -24,8 +24,8 @@ limitations under the License.
<!-- ================================================== --> <!-- ================================================== -->
<section name="Overview"> <section name="Overview">
<p> <p>
Commons Logging uses <a href="http://maven.apache.org">Maven 2.0.x</a> as its Commons Logging uses <a href="https://maven.apache.org">Maven 2.0.x</a> as its
primary build system. <a href="http://ant.apache.org">Ant</a> can also be used. primary build system. <a href="https://ant.apache.org">Ant</a> can also be used.
</p> </p>
</section> </section>
<!-- ================================================== --> <!-- ================================================== -->
@@ -56,7 +56,7 @@ limitations under the License.
</p> </p>
<p> <p>
Further details can be found in the Further details can be found in the
<a href="http://commons.apache.org/building.html">commons build instructions</a>. <a href="https//commons.apache.org/building.html">commons build instructions</a>.
</p> </p>
</section> </section>
<!-- ================================================== --> <!-- ================================================== -->

20
src/site/xdoc/download_logging.xml
View File

@@ -88,7 +88,7 @@ limitations under the License.
</form> </form>
<p> <p>
The <a href="http://www.apache.org/dist/commons/KEYS">KEYS</a> The <a href="https//www.apache.org/dist/commons/KEYS">KEYS</a>
link links to the code signing keys used to sign the product. link links to the code signing keys used to sign the product.
The <code>PGP</code> link downloads the OpenPGP compatible signature from our main site. The <code>PGP</code> link downloads the OpenPGP compatible signature from our main site.
The <code>MD5</code> link downloads the checksum from the main site. The <code>MD5</code> link downloads the checksum from the main site.
@@ -100,13 +100,13 @@ limitations under the License.
<table> <table>
<tr> <tr>
<td><a href="[preferred]/commons/logging/binaries/commons-logging-1.2-bin.tar.gz">commons-logging-1.2-bin.tar.gz</a></td> <td><a href="[preferred]/commons/logging/binaries/commons-logging-1.2-bin.tar.gz">commons-logging-1.2-bin.tar.gz</a></td>
<td><a href="http://www.apache.org/dist/commons/logging/binaries/commons-logging-1.2-bin.tar.gz.md5">md5</a></td> <td><a href="https//www.apache.org/dist/commons/logging/binaries/commons-logging-1.2-bin.tar.gz.md5">md5</a></td>
<td><a href="http://www.apache.org/dist/commons/logging/binaries/commons-logging-1.2-bin.tar.gz.asc">pgp</a></td> <td><a href="https//www.apache.org/dist/commons/logging/binaries/commons-logging-1.2-bin.tar.gz.asc">pgp</a></td>
</tr> </tr>
<tr> <tr>
<td><a href="[preferred]/commons/logging/binaries/commons-logging-1.2-bin.zip">commons-logging-1.2-bin.zip</a></td> <td><a href="[preferred]/commons/logging/binaries/commons-logging-1.2-bin.zip">commons-logging-1.2-bin.zip</a></td>
<td><a href="http://www.apache.org/dist/commons/logging/binaries/commons-logging-1.2-bin.zip.md5">md5</a></td> <td><a href="https//www.apache.org/dist/commons/logging/binaries/commons-logging-1.2-bin.zip.md5">md5</a></td>
<td><a href="http://www.apache.org/dist/commons/logging/binaries/commons-logging-1.2-bin.zip.asc">pgp</a></td> <td><a href="https//www.apache.org/dist/commons/logging/binaries/commons-logging-1.2-bin.zip.asc">pgp</a></td>
</tr> </tr>
</table> </table>
</subsection> </subsection>
@@ -114,13 +114,13 @@ limitations under the License.
<table> <table>
<tr> <tr>
<td><a href="[preferred]/commons/logging/source/commons-logging-1.2-src.tar.gz">commons-logging-1.2-src.tar.gz</a></td> <td><a href="[preferred]/commons/logging/source/commons-logging-1.2-src.tar.gz">commons-logging-1.2-src.tar.gz</a></td>
<td><a href="http://www.apache.org/dist/commons/logging/source/commons-logging-1.2-src.tar.gz.md5">md5</a></td> <td><a href="https//www.apache.org/dist/commons/logging/source/commons-logging-1.2-src.tar.gz.md5">md5</a></td>
<td><a href="http://www.apache.org/dist/commons/logging/source/commons-logging-1.2-src.tar.gz.asc">pgp</a></td> <td><a href="https//www.apache.org/dist/commons/logging/source/commons-logging-1.2-src.tar.gz.asc">pgp</a></td>
</tr> </tr>
<tr> <tr>
<td><a href="[preferred]/commons/logging/source/commons-logging-1.2-src.zip">commons-logging-1.2-src.zip</a></td> <td><a href="[preferred]/commons/logging/source/commons-logging-1.2-src.zip">commons-logging-1.2-src.zip</a></td>
<td><a href="http://www.apache.org/dist/commons/logging/source/commons-logging-1.2-src.zip.md5">md5</a></td> <td><a href="https//www.apache.org/dist/commons/logging/source/commons-logging-1.2-src.zip.md5">md5</a></td>
<td><a href="http://www.apache.org/dist/commons/logging/source/commons-logging-1.2-src.zip.asc">pgp</a></td> <td><a href="https//www.apache.org/dist/commons/logging/source/commons-logging-1.2-src.zip.asc">pgp</a></td>
</tr> </tr>
</table> </table>
</subsection> </subsection>
@@ -131,7 +131,7 @@ limitations under the License.
</p> </p>
<ul> <ul>
<li class="download"><a href="[preferred]/commons/logging/">browse download area</a></li> <li class="download"><a href="[preferred]/commons/logging/">browse download area</a></li>
<li><a href="http://archive.apache.org/dist/commons/logging/">archives...</a></li> <li><a href="https//archive.apache.org/dist/commons/logging/">archives...</a></li>
</ul> </ul>
</section> </section>
</body> </body>

18
src/site/xdoc/guide.xml
View File

@@ -97,8 +97,8 @@ a specific logging implementation.
</p> </p>
<p>JCL provides thin-wrapper <code>Log</code> implementations for <p>JCL provides thin-wrapper <code>Log</code> implementations for
other logging tools, including other logging tools, including
<a href="http://logging.apache.org/log4j/docs/index.html">Log4J</a>, <a href="https//logging.apache.org/log4j/docs/index.html">Log4J</a>,
<a href="http://avalon.apache.org/logkit/index.html">Avalon LogKit</a> <a href="https//avalon.apache.org/logkit/index.html">Avalon LogKit</a>
(the Avalon Framework's logging infrastructure), (the Avalon Framework's logging infrastructure),
JDK 1.4, and an implementation of JDK 1.4 logging APIs (JSR-47) for pre-1.4 JDK 1.4, and an implementation of JDK 1.4 logging APIs (JSR-47) for pre-1.4
systems. systems.
@@ -174,16 +174,16 @@ compatibility to pre-1.0 versions of this API, a system property
<li> <li>
If the Log4J logging system is available in the application If the Log4J logging system is available in the application
class path, use the corresponding wrapper class class path, use the corresponding wrapper class
(<a href="http://commons.apache.org/logging/apidocs/org/apache/commons/logging/impl/Log4JLogger.html">Log4JLogger</a>). (<a href="https//commons.apache.org/logging/apidocs/org/apache/commons/logging/impl/Log4JLogger.html">Log4JLogger</a>).
</li> </li>
<li> <li>
If the application is executing on a JDK 1.4 system, use If the application is executing on a JDK 1.4 system, use
the corresponding wrapper class the corresponding wrapper class
(<a href="http://commons.apache.org/logging/apidocs/org/apache/commons/logging/impl/Jdk14Logger.html">Jdk14Logger</a>). (<a href="https//commons.apache.org/logging/apidocs/org/apache/commons/logging/impl/Jdk14Logger.html">Jdk14Logger</a>).
</li> </li>
<li> <li>
Fall back to the default simple logging wrapper Fall back to the default simple logging wrapper
(<a href="http://commons.apache.org/logging/apidocs/org/apache/commons/logging/impl/SimpleLog.html">SimpleLog</a>). (<a href="https//commons.apache.org/logging/apidocs/org/apache/commons/logging/impl/SimpleLog.html">SimpleLog</a>).
</li> </li>
</ol> </ol>
<p> <p>
@@ -217,7 +217,7 @@ is responsible for handling such issues.
<p> <p>
Log4J is a very commonly used logging implementation (as well as being the JCL primary default), Log4J is a very commonly used logging implementation (as well as being the JCL primary default),
so a <i>few</i> details are presented herein to get the developer/integrator going. so a <i>few</i> details are presented herein to get the developer/integrator going.
Please see the <a href='http://logging.apache.org/log4j/docs/index.html'>Log4J Home</a> for more details Please see the <a href='https//logging.apache.org/log4j/docs/index.html'>Log4J Home</a> for more details
on Log4J and it's configuration. on Log4J and it's configuration.
</p> </p>
<p> <p>
@@ -388,8 +388,8 @@ In addition to the logging methods, the following are provided for code guards:
The <code>commons-logging.jar</code> file includes the JCL API, the default The <code>commons-logging.jar</code> file includes the JCL API, the default
<code>LogFactory</code> implementation and thin-wrapper <code>Log</code> <code>LogFactory</code> implementation and thin-wrapper <code>Log</code>
implementations for implementations for
<a href="http://logging.apache.org/log4j/docs/index.html">Log4J</a>, <a href="https//logging.apache.org/log4j/docs/index.html">Log4J</a>,
<a href="http://avalon.apache.org/logkit/index.html">Avalon LogKit</a>, <a href="https//avalon.apache.org/logkit/index.html">Avalon LogKit</a>,
the Avalon Framework's logging infrastructure, the Avalon Framework's logging infrastructure,
JDK 1.4, as well as an implementation of JDK 1.4 logging APIs (JSR-47) for JDK 1.4, as well as an implementation of JDK 1.4 logging APIs (JSR-47) for
pre-1.4 systems. pre-1.4 systems.
@@ -784,7 +784,7 @@ for details.
JCL is distributed with a very simple <code>Log</code> implementation named JCL is distributed with a very simple <code>Log</code> implementation named
<code>org.apache.commons.logging.impl.SimpleLog</code>. This is intended to be a minimal <code>org.apache.commons.logging.impl.SimpleLog</code>. This is intended to be a minimal
implementation and those requiring a fully functional open source logging system are implementation and those requiring a fully functional open source logging system are
directed to <a href='http://logging.apache.org/log4j'>Log4J</a>. directed to <a href='https//logging.apache.org/log4j'>Log4J</a>.
</p> </p>
<p> <p>
<code>SimpleLog</code> sends all (enabled) log messages, <code>SimpleLog</code> sends all (enabled) log messages,

8
src/site/xdoc/index.xml
View File

@@ -60,13 +60,13 @@ containing any code that is specific to the logging implementation used.</p>
Release Notes</a> document the new features and bug fixes that have been Release Notes</a> document the new features and bug fixes that have been
included in the latest release.</p> included in the latest release.</p>
<p>The <a href="http://commons.apache.org/logging/apidocs/index.html"> <p>The <a href="https//commons.apache.org/logging/apidocs/index.html">
Javadoc API documents</a> for the latest release are available online. Javadoc API documents</a> for the latest release are available online.
In particular, you should read the package overview of the <code>org.apache.commons.logging</code> In particular, you should read the package overview of the <code>org.apache.commons.logging</code>
package. In addition, there is a (short) package. In addition, there is a (short)
<a href="guide.html">User Guide</a>.</p> <a href="guide.html">User Guide</a>.</p>
<p>The <a href="http://wiki.apache.org/commons/Logging">Wiki site</a> has <p>The <a href="https//wiki.apache.org/commons/Logging">Wiki site</a> has
the latest updates, an FAQ and much other useful information.</p> the latest updates, an FAQ and much other useful information.</p>
<p> <p>
Users needing to become experts or wanting to help develop JCL should Users needing to become experts or wanting to help develop JCL should
@@ -79,7 +79,7 @@ This gives short introductions to topics such as advanced class loading.
<section name="Releases"> <section name="Releases">
<p> <p>
Binary and source distributions are available Binary and source distributions are available
<a href="http://commons.apache.org/logging/download_logging.cgi">here</a>. <a href="https//commons.apache.org/logging/download_logging.cgi">here</a>.
</p> </p>
<subsection name='1.2 Release - July 2014'> <subsection name='1.2 Release - July 2014'>
<p>The main purpose of the 1.2 release is to drop support for Java 1.1.</p> <p>The main purpose of the 1.2 release is to drop support for Java 1.1.</p>
@@ -138,7 +138,7 @@ Binary and source distributions are available
</section> </section>
<section name="Development Builds"> <section name="Development Builds">
<p>Regular builds of the current SVN HEAD code are made available. See the <p>Regular builds of the current SVN HEAD code are made available. See the
<a href="http://wiki.apache.org/commons/Logging">wiki</a> for details.</p> <a href="https//wiki.apache.org/commons/Logging">wiki</a> for details.</p>
</section> </section>
</body> </body>
</document> </document>

22
src/site/xdoc/issue-tracking.xml
View File

@@ -50,14 +50,14 @@ limitations under the License.
<section name="Commons Logging Issue tracking"> <section name="Commons Logging Issue tracking">
<p> <p>
Commons Logging uses <a href="http://issues.apache.org/jira/">ASF JIRA</a> for tracking issues. Commons Logging uses <a href="https//issues.apache.org/jira/">ASF JIRA</a> for tracking issues.
See the <a href="http://issues.apache.org/jira/browse/LOGGING">Commons Logging JIRA project page</a>. See the <a href="https//issues.apache.org/jira/browse/LOGGING">Commons Logging JIRA project page</a>.
</p> </p>
<p> <p>
To use JIRA you may need to <a href="http://issues.apache.org/jira/secure/Signup!default.jspa">create an account</a> To use JIRA you may need to <a href="https//issues.apache.org/jira/secure/Signup!default.jspa">create an account</a>
(if you have previously created/updated Commons issues using Bugzilla an account will have been automatically (if you have previously created/updated Commons issues using Bugzilla an account will have been automatically
created and you can use the <a href="http://issues.apache.org/jira/secure/ForgotPassword!default.jspa">Forgot Password</a> created and you can use the <a href="https//issues.apache.org/jira/secure/ForgotPassword!default.jspa">Forgot Password</a>
page to get a new password). page to get a new password).
</p> </p>
@@ -65,13 +65,13 @@ limitations under the License.
If you would like to report a bug, or raise an enhancement request with If you would like to report a bug, or raise an enhancement request with
Commons Logging please do the following: Commons Logging please do the following:
<ol> <ol>
<li><a href="http://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&amp;pid=12310484&amp;sorter/field=issuekey&amp;sorter/order=DESC&amp;status=1&amp;status=3&amp;status=4">Search existing open bugs</a>. <li><a href="https//issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&amp;pid=12310484&amp;sorter/field=issuekey&amp;sorter/order=DESC&amp;status=1&amp;status=3&amp;status=4">Search existing open bugs</a>.
If you find your issue listed then please add a comment with your details.</li> If you find your issue listed then please add a comment with your details.</li>
<li><a href="mail-lists.html">Search the mailing list archive(s)</a>. <li><a href="mail-lists.html">Search the mailing list archive(s)</a>.
You may find your issue or idea has already been discussed.</li> You may find your issue or idea has already been discussed.</li>
<li>Decide if your issue is a bug or an enhancement.</li> <li>Decide if your issue is a bug or an enhancement.</li>
<li>Submit either a <a href="http://issues.apache.org/jira/secure/CreateIssueDetails!init.jspa?pid=12310484&amp;issuetype=1&amp;priority=4&amp;assignee=-1">bug report</a> <li>Submit either a <a href="https//issues.apache.org/jira/secure/CreateIssueDetails!init.jspa?pid=12310484&amp;issuetype=1&amp;priority=4&amp;assignee=-1">bug report</a>
or <a href="http://issues.apache.org/jira/secure/CreateIssueDetails!init.jspa?pid=12310484&amp;issuetype=4&amp;priority=4&amp;assignee=-1">enhancement request</a>.</li> or <a href="https//issues.apache.org/jira/secure/CreateIssueDetails!init.jspa?pid=12310484&amp;issuetype=4&amp;priority=4&amp;assignee=-1">enhancement request</a>.</li>
</ol> </ol>
</p> </p>
@@ -86,15 +86,15 @@ limitations under the License.
<p> <p>
For more information on subversion and creating patches see the For more information on subversion and creating patches see the
<a href="http://www.apache.org/dev/contributors.html">Apache Contributors Guide</a>. <a href="https//www.apache.org/dev/contributors.html">Apache Contributors Guide</a>.
</p> </p>
<p> <p>
You may also find these links useful: You may also find these links useful:
<ul> <ul>
<li><a href="http://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&amp;pid=12310484&amp;sorter/field=issuekey&amp;sorter/order=DESC&amp;status=1&amp;status=3&amp;status=4">All Open Commons Logging bugs</a></li> <li><a href="https//issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&amp;pid=12310484&amp;sorter/field=issuekey&amp;sorter/order=DESC&amp;status=1&amp;status=3&amp;status=4">All Open Commons Logging bugs</a></li>
<li><a href="http://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&amp;pid=12310484&amp;sorter/field=issuekey&amp;sorter/order=DESC&amp;status=5&amp;status=6">All Resolved Commons Logging bugs</a></li> <li><a href="https//issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&amp;pid=12310484&amp;sorter/field=issuekey&amp;sorter/order=DESC&amp;status=5&amp;status=6">All Resolved Commons Logging bugs</a></li>
<li><a href="http://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&amp;pid=12310484&amp;sorter/field=issuekey&amp;sorter/order=DESC">All Commons Logging bugs</a></li> <li><a href="https//issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&amp;pid=12310484&amp;sorter/field=issuekey&amp;sorter/order=DESC">All Commons Logging bugs</a></li>
</ul> </ul>
</p> </p>
</section> </section>

44
src/site/xdoc/mail-lists.xml
View File

@@ -49,7 +49,7 @@ limitations under the License.
<section name="Overview"> <section name="Overview">
<p> <p>
<a href="index.html">Commons Logging</a> shares mailing lists with all the other <a href="index.html">Commons Logging</a> shares mailing lists with all the other
<a href="http://commons.apache.org/components.html">Commons Components</a>. <a href="https//commons.apache.org/components.html">Commons Components</a>.
To make it easier for people to only read messages related to components they are interested in, To make it easier for people to only read messages related to components they are interested in,
the convention in Commons is to prefix the subject line of messages with the component's name, the convention in Commons is to prefix the subject line of messages with the component's name,
for example: for example:
@@ -59,9 +59,9 @@ limitations under the License.
</p> </p>
<p> <p>
Questions related to the usage of Commons Logging should be posted to the Questions related to the usage of Commons Logging should be posted to the
<a href="http://mail-archives.apache.org/mod_mbox/commons-user/">User List</a>. <a href="https//mail-archives.apache.org/mod_mbox/commons-user/">User List</a>.
<br /> <br />
The <a href="http://mail-archives.apache.org/mod_mbox/commons-dev/">Developer List</a> The <a href="https//mail-archives.apache.org/mod_mbox/commons-dev/">Developer List</a>
is for questions and discussion related to the development of Commons Logging. is for questions and discussion related to the development of Commons Logging.
<br /> <br />
Please do not cross-post; developers are also subscribed to the user list. Please do not cross-post; developers are also subscribed to the user list.
@@ -102,10 +102,10 @@ limitations under the License.
<td><a href="mailto:user-subscribe@commons.apache.org">Subscribe</a></td> <td><a href="mailto:user-subscribe@commons.apache.org">Subscribe</a></td>
<td><a href="mailto:user-unsubscribe@commons.apache.org">Unsubscribe</a></td> <td><a href="mailto:user-unsubscribe@commons.apache.org">Unsubscribe</a></td>
<td><a href="mailto:user@commons.apache.org?subject=[logging]">Post</a></td> <td><a href="mailto:user@commons.apache.org?subject=[logging]">Post</a></td>
<td><a href="http://mail-archives.apache.org/mod_mbox/commons-user/">mail-archives.apache.org</a></td> <td><a href="https//mail-archives.apache.org/mod_mbox/commons-user/">mail-archives.apache.org</a></td>
<td><a href="http://markmail.org/list/org.apache.commons.users/">markmail.org</a><br /> <td><a href="https//markmail.org/list/org.apache.commons.users/">markmail.org</a><br />
<a href="http://www.mail-archive.com/user@commons.apache.org/">www.mail-archive.com</a><br /> <a href="https//www.mail-archive.com/user@commons.apache.org/">www.mail-archive.com</a><br />
<a href="http://news.gmane.org/gmane.comp.jakarta.commons.devel">news.gmane.org</a> <a href="https//news.gmane.org/gmane.comp.jakarta.commons.devel">news.gmane.org</a>
</td> </td>
</tr> </tr>
@@ -120,10 +120,10 @@ limitations under the License.
<td><a href="mailto:dev-subscribe@commons.apache.org">Subscribe</a></td> <td><a href="mailto:dev-subscribe@commons.apache.org">Subscribe</a></td>
<td><a href="mailto:dev-unsubscribe@commons.apache.org">Unsubscribe</a></td> <td><a href="mailto:dev-unsubscribe@commons.apache.org">Unsubscribe</a></td>
<td><a href="mailto:dev@commons.apache.org?subject=[logging]">Post</a></td> <td><a href="mailto:dev@commons.apache.org?subject=[logging]">Post</a></td>
<td><a href="http://mail-archives.apache.org/mod_mbox/commons-dev/">mail-archives.apache.org</a></td> <td><a href="https//mail-archives.apache.org/mod_mbox/commons-dev/">mail-archives.apache.org</a></td>
<td><a href="http://markmail.org/list/org.apache.commons.dev/">markmail.org</a><br /> <td><a href="https//markmail.org/list/org.apache.commons.dev/">markmail.org</a><br />
<a href="http://www.mail-archive.com/dev@commons.apache.org/">www.mail-archive.com</a><br /> <a href="https//www.mail-archive.com/dev@commons.apache.org/">www.mail-archive.com</a><br />
<a href="http://news.gmane.org/gmane.comp.jakarta.commons.devel">news.gmane.org</a> <a href="https//news.gmane.org/gmane.comp.jakarta.commons.devel">news.gmane.org</a>
</td> </td>
</tr> </tr>
@@ -138,9 +138,9 @@ limitations under the License.
<td><a href="mailto:issues-subscribe@commons.apache.org">Subscribe</a></td> <td><a href="mailto:issues-subscribe@commons.apache.org">Subscribe</a></td>
<td><a href="mailto:issues-unsubscribe@commons.apache.org">Unsubscribe</a></td> <td><a href="mailto:issues-unsubscribe@commons.apache.org">Unsubscribe</a></td>
<td><i>read only</i></td> <td><i>read only</i></td>
<td><a href="http://mail-archives.apache.org/mod_mbox/commons-issues/">mail-archives.apache.org</a></td> <td><a href="https//mail-archives.apache.org/mod_mbox/commons-issues/">mail-archives.apache.org</a></td>
<td><a href="http://markmail.org/list/org.apache.commons.issues/">markmail.org</a><br /> <td><a href="https//markmail.org/list/org.apache.commons.issues/">markmail.org</a><br />
<a href="http://www.mail-archive.com/issues@commons.apache.org/">www.mail-archive.com</a> <a href="https//www.mail-archive.com/issues@commons.apache.org/">www.mail-archive.com</a>
</td> </td>
</tr> </tr>
@@ -155,9 +155,9 @@ limitations under the License.
<td><a href="mailto:commits-subscribe@commons.apache.org">Subscribe</a></td> <td><a href="mailto:commits-subscribe@commons.apache.org">Subscribe</a></td>
<td><a href="mailto:commits-unsubscribe@commons.apache.org">Unsubscribe</a></td> <td><a href="mailto:commits-unsubscribe@commons.apache.org">Unsubscribe</a></td>
<td><i>read only</i></td> <td><i>read only</i></td>
<td><a href="http://mail-archives.apache.org/mod_mbox/commons-commits/">mail-archives.apache.org</a></td> <td><a href="https//mail-archives.apache.org/mod_mbox/commons-commits/">mail-archives.apache.org</a></td>
<td><a href="http://markmail.org/list/org.apache.commons.commits/">markmail.org</a><br /> <td><a href="https//markmail.org/list/org.apache.commons.commits/">markmail.org</a><br />
<a href="http://www.mail-archive.com/commits@commons.apache.org/">www.mail-archive.com</a> <a href="https//www.mail-archive.com/commits@commons.apache.org/">www.mail-archive.com</a>
</td> </td>
</tr> </tr>
@@ -188,11 +188,11 @@ limitations under the License.
<td><a class="externalLink" href="mailto:announce-subscribe@apache.org">Subscribe</a></td> <td><a class="externalLink" href="mailto:announce-subscribe@apache.org">Subscribe</a></td>
<td><a class="externalLink" href="mailto:announce-unsubscribe@apache.org">Unsubscribe</a></td> <td><a class="externalLink" href="mailto:announce-unsubscribe@apache.org">Unsubscribe</a></td>
<td><i>read only</i></td> <td><i>read only</i></td>
<td><a class="externalLink" href="http://mail-archives.apache.org/mod_mbox/www-announce/">mail-archives.apache.org</a></td> <td><a class="externalLink" href="https//mail-archives.apache.org/mod_mbox/www-announce/">mail-archives.apache.org</a></td>
<td><a class="externalLink" href="http://markmail.org/list/org.apache.announce/">markmail.org</a><br /> <td><a class="externalLink" href="https//markmail.org/list/org.apache.announce/">markmail.org</a><br />
<a class="externalLink" href="http://old.nabble.com/Apache-News-and-Announce-f109.html">old.nabble.com</a><br /> <a class="externalLink" href="https//old.nabble.com/Apache-News-and-Announce-f109.html">old.nabble.com</a><br />
<a class="externalLink" href="http://www.mail-archive.com/announce@apache.org/">www.mail-archive.com</a><br /> <a class="externalLink" href="https//www.mail-archive.com/announce@apache.org/">www.mail-archive.com</a><br />
<a class="externalLink" href="http://news.gmane.org/gmane.comp.apache.announce">news.gmane.org</a> <a class="externalLink" href="https//news.gmane.org/gmane.comp.apache.announce">news.gmane.org</a>
</td> </td>
</tr> </tr>
</table> </table>

2
src/site/xdoc/proposal.xml
View File

@@ -83,7 +83,7 @@ Non-goals:
is selected at runtime).</li> is selected at runtime).</li>
<li>Log4J (compile-time dependency only unless this Log <li>Log4J (compile-time dependency only unless this Log
implementation is selected at runtime)</li> implementation is selected at runtime)</li>
<li><a href="http://sourceforge.net/projects/lumberjack/">Lumberjack</a> <li><a href="https//sourceforge.net/projects/lumberjack/">Lumberjack</a>
(compile-time dependency only unless this Log (compile-time dependency only unless this Log
implementation is selected at runtime)</li> implementation is selected at runtime)</li>
</ul> </ul>

46
src/site/xdoc/tech.xml
View File

@@ -183,10 +183,10 @@ limitations under the License.
</p> </p>
<ul> <ul>
<li> <li>
posting to the <a href='http://commons.apache.org/mail-lists.html'>Apache Commons dev mailing list</a> or posting to the <a href='https//commons.apache.org/mail-lists.html'>Apache Commons dev mailing list</a> or
</li> </li>
<li> <li>
creating an issue in <a href='http://issues.apache.org/jira/browse/LOGGING/'>JIRA</a>. creating an issue in <a href='https//issues.apache.org/jira/browse/LOGGING/'>JIRA</a>.
</li> </li>
</ul> </ul>
<p> <p>
@@ -217,7 +217,7 @@ limitations under the License.
</subsection> </subsection>
<subsection name='Resolution Of Symbolic References'> <subsection name='Resolution Of Symbolic References'>
<p> <p>
(<a href='http://java.sun.com/docs/books/jls/second_edition/html/execution.doc.html#44524'>LangSpec 12.3.3</a>) (<a href='https//java.sun.com/docs/books/jls/second_edition/html/execution.doc.html#44524'>LangSpec 12.3.3</a>)
The bytecode representation of a class contains symbolic names for other classes referenced. The bytecode representation of a class contains symbolic names for other classes referenced.
</p> </p>
<p> <p>
@@ -227,7 +227,7 @@ limitations under the License.
</em> </em>
</p> </p>
<p> <p>
(<a href='http://java.sun.com/docs/books/vmspec/2nd-edition/html/ConstantPool.doc.html#73492'>VMSpec 5.4.3</a>) (<a href='https//java.sun.com/docs/books/vmspec/2nd-edition/html/ConstantPool.doc.html#73492'>VMSpec 5.4.3</a>)
Resolution of a symbolic reference occurs dynamically at runtime and is carried out by Resolution of a symbolic reference occurs dynamically at runtime and is carried out by
the Java Virtual Machine. Resolution of a symbolic reference requires loading and linking of the new class. the Java Virtual Machine. Resolution of a symbolic reference requires loading and linking of the new class.
</p> </p>
@@ -239,7 +239,7 @@ limitations under the License.
</subsection> </subsection>
<subsection name='Loading'> <subsection name='Loading'>
<p> <p>
(<a href='http://java.sun.com/docs/books/vmspec/2nd-edition/html/Concepts.doc.html#19175'>VMSpec 2.17.2</a>) (<a href='https//java.sun.com/docs/books/vmspec/2nd-edition/html/Concepts.doc.html#19175'>VMSpec 2.17.2</a>)
Loading is the name given to the process by which a binary form of a class is obtained Loading is the name given to the process by which a binary form of a class is obtained
by the Java Virtual Machine. by the Java Virtual Machine.
Java classes are always loaded and linked dynamically by the Java Virtual Machine Java classes are always loaded and linked dynamically by the Java Virtual Machine
@@ -256,12 +256,12 @@ limitations under the License.
</subsection> </subsection>
<subsection name='Linking'> <subsection name='Linking'>
<p> <p>
(<a href='http://java.sun.com/docs/books/vmspec/2nd-edition/html/Concepts.doc.html#22574'>VMSpec 2.17.3</a>) (<a href='https//java.sun.com/docs/books/vmspec/2nd-edition/html/Concepts.doc.html#22574'>VMSpec 2.17.3</a>)
Linking is the name used for combining the Linking is the name used for combining the
binary form of a class into the Java Virtual Machine. This must happen before the class can be used. binary form of a class into the Java Virtual Machine. This must happen before the class can be used.
</p> </p>
<p> <p>
(<a href='http://java.sun.com/docs/books/vmspec/2nd-edition/html/Concepts.doc.html#22574'>VMSpec 2.17.3</a>) (<a href='https//java.sun.com/docs/books/vmspec/2nd-edition/html/Concepts.doc.html#22574'>VMSpec 2.17.3</a>)
Linking is composed of verification, preparation and resolution (of symbolic references). Linking is composed of verification, preparation and resolution (of symbolic references).
Flexibility is allowed over the timing of resolution. (Within limit) this may happen at any time after Flexibility is allowed over the timing of resolution. (Within limit) this may happen at any time after
preparation and before that reference is used. preparation and before that reference is used.
@@ -278,11 +278,11 @@ limitations under the License.
<subsection name='Loading Classes'> <subsection name='Loading Classes'>
<p> <p>
(<a href='http://java.sun.com/docs/books/vmspec/2nd-edition/html/Concepts.doc.html#19175'>VMSpec 2.17.2</a>) (<a href='https//java.sun.com/docs/books/vmspec/2nd-edition/html/Concepts.doc.html#19175'>VMSpec 2.17.2</a>)
The loading process is performed by a <code>ClassLoader</code>. The loading process is performed by a <code>ClassLoader</code>.
</p> </p>
<p> <p>
(<a href='http://java.sun.com/docs/books/vmspec/2nd-edition/html/ConstantPool.doc.html#72007'>VMSpec 5.3</a>) (<a href='https//java.sun.com/docs/books/vmspec/2nd-edition/html/ConstantPool.doc.html#72007'>VMSpec 5.3</a>)
A classloader may create a class either by delegation or by defining it directly. A classloader may create a class either by delegation or by defining it directly.
The classloader that initiates loading of a class is known as the initiating loader. The classloader that initiates loading of a class is known as the initiating loader.
The classloader that defines the class is known as the defining loader. The classloader that defines the class is known as the defining loader.
@@ -297,7 +297,7 @@ limitations under the License.
<subsection name='Bootstrap Classloader'> <subsection name='Bootstrap Classloader'>
<p> <p>
(<a href='http://java.sun.com/docs/books/vmspec/2nd-edition/html/ConstantPool.doc.html#72007'>VMSPEC 5.3</a>) (<a href='https//java.sun.com/docs/books/vmspec/2nd-edition/html/ConstantPool.doc.html#72007'>VMSPEC 5.3</a>)
The bootstrap is the base <code>ClassLoader</code> supplied by the Java Virtual Machine. The bootstrap is the base <code>ClassLoader</code> supplied by the Java Virtual Machine.
All others are user (also known as application) <code>ClassLoader</code> instances. All others are user (also known as application) <code>ClassLoader</code> instances.
</p> </p>
@@ -312,12 +312,12 @@ limitations under the License.
</subsection> </subsection>
<subsection name='Runtime Package'> <subsection name='Runtime Package'>
<p> <p>
(<a href='http://java.sun.com/docs/books/vmspec/2nd-edition/html/ConstantPool.doc.html#72007'>VMSpec 5.3</a>) (<a href='https//java.sun.com/docs/books/vmspec/2nd-edition/html/ConstantPool.doc.html#72007'>VMSpec 5.3</a>)
At runtime, a class (or interface) is determined by its fully qualified name At runtime, a class (or interface) is determined by its fully qualified name
and by the classloader that defines it. This is known as the class's runtime package. and by the classloader that defines it. This is known as the class's runtime package.
</p> </p>
<p> <p>
(<a href='http://java.sun.com/docs/books/vmspec/2nd-edition/html/ConstantPool.doc.html#75929'>VMSpec 5.4.4</a>) (<a href='https//java.sun.com/docs/books/vmspec/2nd-edition/html/ConstantPool.doc.html#75929'>VMSpec 5.4.4</a>)
Only classes in the same runtime package are mutually accessible. Only classes in the same runtime package are mutually accessible.
</p> </p>
<p> <p>
@@ -334,7 +334,7 @@ limitations under the License.
<subsection name='Loader Used To Resolve A Symbolic Reference'> <subsection name='Loader Used To Resolve A Symbolic Reference'>
<p> <p>
(<a href='http://java.sun.com/docs/books/vmspec/2nd-edition/html/ConstantPool.doc.html#72007'>VMSpec 5.3</a>) (<a href='https//java.sun.com/docs/books/vmspec/2nd-edition/html/ConstantPool.doc.html#72007'>VMSpec 5.3</a>)
The classloader which defines the class (whose reference is being resolved) is the one The classloader which defines the class (whose reference is being resolved) is the one
used to initiate loading of the class referred to. used to initiate loading of the class referred to.
</p> </p>
@@ -352,10 +352,10 @@ limitations under the License.
<subsection name='Bibliography'> <subsection name='Bibliography'>
<ul> <ul>
<li> <li>
<a href='http://java.sun.com/docs/books/vmspec/'>VMSpec</a> <em>The Java Virtual Machine Specification, Second Edition</em> <a href='https//java.sun.com/docs/books/vmspec/'>VMSpec</a> <em>The Java Virtual Machine Specification, Second Edition</em>
</li> </li>
<li> <li>
<a href='http://java.sun.com/docs/books/jls/'>LangSpec</a> <em>The Java Language Specification, Second Edition</em> <a href='https//java.sun.com/docs/books/jls/'>LangSpec</a> <em>The Java Language Specification, Second Edition</em>
</li> </li>
</ul> </ul>
</subsection> </subsection>
@@ -443,7 +443,7 @@ limitations under the License.
<subsection name='The Context Classloader in Container Applications'> <subsection name='The Context Classloader in Container Applications'>
<p> <p>
The Javadoc for The Javadoc for
<a href="http://java.sun.com/j2se/1.5.0/docs/api/java/lang/Thread.html#setContextClassLoader(java.lang.ClassLoader)"> <a href="https//java.sun.com/j2se/1.5.0/docs/api/java/lang/Thread.html#setContextClassLoader(java.lang.ClassLoader)">
<code>Thread.setContextClassLoader</code></a> emphasizes the setting of the <code>Thread.setContextClassLoader</code></a> emphasizes the setting of the
context classloader as an aspect of thread creation. However, in many context classloader as an aspect of thread creation. However, in many
applications the context classloader is not fixed at thread creation but applications the context classloader is not fixed at thread creation but
@@ -508,7 +508,7 @@ limitations under the License.
Again, this will cause difficulties. Again, this will cause difficulties.
</p> </p>
<p> <p>
Introduced in <a href='http://java.sun.com/j2ee/j2ee-1_3-fr-spec.pdf'>Java J2EE 1.3</a> Introduced in <a href='https//java.sun.com/j2ee/j2ee-1_3-fr-spec.pdf'>Java J2EE 1.3</a>
is a requirement for vendors to appropriately set the context classloader. is a requirement for vendors to appropriately set the context classloader.
Section 6.2.4.8 (1.4 text): Section 6.2.4.8 (1.4 text):
</p> </p>
@@ -569,19 +569,19 @@ above.
<ul> <ul>
<li> <li>
<a <a
href='http://www.onjava.com/pub/a/onjava/2001/07/25/ejb.html'> href='https//www.onjava.com/pub/a/onjava/2001/07/25/ejb.html'>
Article on J2EE class loading Article on J2EE class loading
</a> </a>
</li> </li>
<li> <li>
<a <a
href='http://www.onjava.com/pub/a/onjava/2003/11/12/classloader.html'> href='https//www.onjava.com/pub/a/onjava/2003/11/12/classloader.html'>
Article on class loading Article on class loading
</a> </a>
</li> </li>
<li> <li>
<a <a
href='http://www.javaworld.com/javaworld/javaqa/2003-06/01-qa-0606-load.html'> href='https//www.javaworld.com/javaworld/javaqa/2003-06/01-qa-0606-load.html'>
Article on context class loaders Article on context class loaders
</a> </a>
</li> </li>
@@ -591,19 +591,19 @@ above.
<ul> <ul>
<li> <li>
<a <a
href='http://tomcat.apache.org/tomcat-4.1-doc/class-loader-howto.html'> href='https//tomcat.apache.org/tomcat-4.1-doc/class-loader-howto.html'>
Tomcat 4.1 ClassLoader Guide Tomcat 4.1 ClassLoader Guide
</a> </a>
</li> </li>
<li> <li>
<a <a
href='http://tomcat.apache.org/tomcat-5.0-doc/class-loader-howto.html'> href='https//tomcat.apache.org/tomcat-5.0-doc/class-loader-howto.html'>
Tomcat 5.0 ClassLoader Guide Tomcat 5.0 ClassLoader Guide
</a> </a>
</li> </li>
<li> <li>
<a <a
href='http://publib.boulder.ibm.com/infocenter/wasinfo/v6r0/index.jsp?topic=/com.ibm.websphere.express.doc/info/exp/ae/trun_classload_web.html'> href='https//publib.boulder.ibm.com/infocenter/wasinfo/v6r0/index.jsp?topic=/com.ibm.websphere.express.doc/info/exp/ae/trun_classload_web.html'>
Classloading In WebSphere Classloading In WebSphere
</a> </a>
</li> </li>

8
src/site/xdoc/troubleshooting.xml
View File

@@ -291,8 +291,8 @@ classloader used to load <code>LogFactory</code> and to the TCCL.
Containers known to use this mechanism: Containers known to use this mechanism:
</p> </p>
<ul> <ul>
<li><a href='http://www.ibm.com/software/websphere/'>WebSphere Application Server</a> from <li><a href='https//www.ibm.com/software/websphere/'>WebSphere Application Server</a> from
<a href='http://www.ibm.com/software/websphere/'>IBM</a> (versions 5 and 6).</li> <a href='https//www.ibm.com/software/websphere/'>IBM</a> (versions 5 and 6).</li>
</ul> </ul>
<p> <p>
Containers suspected to use this mechanism: Containers suspected to use this mechanism:
@@ -315,10 +315,10 @@ of other containers using a custom implementation.
implementation should be used but Class 'com.ibm.ws.commons.logging.TrLogFactory' cannot be converted implementation should be used but Class 'com.ibm.ws.commons.logging.TrLogFactory' cannot be converted
to 'org.apache.commons.logging.LogFactory'. The conflict is caused by the presence of multiple to 'org.apache.commons.logging.LogFactory'. The conflict is caused by the presence of multiple
LogFactory classes in incompatible classloaders. Background can be found in LogFactory classes in incompatible classloaders. Background can be found in
http://commons.apache.org/logging/tech.html. If you have not explicitly specified a custom https//commons.apache.org/logging/tech.html. If you have not explicitly specified a custom
LogFactory then it is likely that the container has set one without your knowledge. LogFactory then it is likely that the container has set one without your knowledge.
In this case, consider using the commons-logging-adapters.jar file or specifying the standard In this case, consider using the commons-logging-adapters.jar file or specifying the standard
LogFactory from the command line. Help can be found @http://commons.apache.org/logging. LogFactory from the command line. Help can be found @https//commons.apache.org/logging.
</pre></code> </pre></code>
<p> <p>
This is a WebSphere example so the name of the custom LogFactory is This is a WebSphere example so the name of the custom LogFactory is