ad40b8fdb4
git-svn-id: https://svn.apache.org/repos/asf/jakarta/commons/proper/logging/trunk@138814 13f79535-47bb-0310-9956-ffa450edef68
93 lines
2.4 KiB
HTML
93 lines
2.4 KiB
HTML
<html>
|
|
<head>
|
|
<title>Proposal for Logging Library Package</title>
|
|
</head>
|
|
<body bgcolor="white">
|
|
|
|
<div align="center">
|
|
<h1>Proposal for <em>Logging</em> Package</h1>
|
|
</div>
|
|
|
|
<h3>(0) Rationale</h3>
|
|
|
|
<p>There is a great need for debugging and logging information inside of
|
|
Commons components such as HTTPClient and dbcp. However, there are many
|
|
logging APIs out there and it is difficult to choose among them.
|
|
</p>
|
|
|
|
<p>The Logging package will be an ultra-thin bridge between different logging
|
|
libraries. Commons components may use the Logging JAR to remove
|
|
compile-time/runtime dependencies on any particular logging package,
|
|
and contributors may write Log implementations for the library of their choice.
|
|
</p>
|
|
|
|
<h3>(1) Scope of the Package</h3>
|
|
|
|
<p>The package shall create and maintain a package that provides extremely
|
|
basic logging functionality and bridges to other, more sophisticated logging
|
|
implementations.
|
|
</p>
|
|
|
|
<p>
|
|
The package should :
|
|
<ul>
|
|
<li>Have an API which should be as simple to use as possible</li>
|
|
<li>Provide support for log4j</li>
|
|
<li>Provide pluggable support for other logging APIs</li>
|
|
</ul>
|
|
</p>
|
|
|
|
<p>
|
|
Non-goals:
|
|
<ul>
|
|
<li>This package will not perform logging itself, except at the most basic
|
|
level.</li>
|
|
<li>We do not seek to become a "standard" API.</li>
|
|
</ul>
|
|
</p>
|
|
|
|
<h3>(1.5) Interaction With Other Packages</h3>
|
|
|
|
<p><em>Logging</em> relies on:
|
|
</p>
|
|
|
|
<ul>
|
|
<li>Java Development Kit (Version 1.1 or later)
|
|
</li>
|
|
<li>log4j (compile-time dependency only)
|
|
</ul>
|
|
|
|
<h3>(2) Required Jakarta-Commons Resources</h3>
|
|
|
|
<ul>
|
|
<li>CVS Repository - New directory <code>logging</code> in the
|
|
<code>jakarta-commons</code> CVS repository.</li>
|
|
|
|
<li>Initial Committers - The list is provided below. </li>
|
|
|
|
<li>Mailing List - Discussions will take place on the general
|
|
<em>commons-dev@jakarta.apache.org</em> mailing list. To help list
|
|
subscribers identify messages of interest, it is suggested that the
|
|
message subject of messages about this component be prefixed with
|
|
[Logging].</li>
|
|
|
|
<li>Bugzilla - New component "Logging" under the "Commons" product
|
|
category, with appropriate version identifiers as needed.</li>
|
|
|
|
<li>Jyve FAQ - New category "commons-logging" (when available).</li>
|
|
</ul>
|
|
|
|
|
|
<h3>(4) Initial Committers</h3>
|
|
|
|
<p>The initial committers on the Logging component shall be:</p>
|
|
|
|
<ul>
|
|
<li>Morgan Delagrange</li>
|
|
<li>Rodney Waldhoff</li>
|
|
<li>Craig McClanahan</li>
|
|
</ul>
|
|
|
|
</body>
|
|
</html>
|