commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From bay...@apache.org
Subject cvs commit: jakarta-commons/logging/xdocs proposal.xml
Date Thu, 19 Feb 2004 03:11:47 GMT
bayard      2004/02/18 19:11:47

  Added:       logging/xdocs proposal.xml
  Log:
  translated PROPOSAL.html to proposal.xml
  
  Revision  Changes    Path
  1.1                  jakarta-commons/logging/xdocs/proposal.xml
  
  Index: proposal.xml
  ===================================================================
  <document>
  <properties>
  <title>Proposal for Logging Library Package</title>
  </properties>
  <body>
  
  
  <section name="Proposal for Logging Package">
  
  
  
  <subsection name="(0) Rationale">
  
  <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>
  
  </subsection>
  <subsection name="(1) Scope of the Package">
  
  <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>
  
  </subsection>
  <subsection name="(1.5) Interaction With Other Packages">
  
  <p><em>Logging</em> relies on:
  </p>
  
  <ul>
    <li>Java Development Kit (Version 1.1 or later)
    </li>
    <li>log4j (compile-time dependency only) </li>
  </ul>
  
  </subsection>
  <subsection name="(2) Required Jakarta-Commons Resources">
  
  <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>
  
  
  </subsection>
  <subsection name="(4) Initial Committers">
  
  <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>
  
  </subsection>
  </section>
  </body>
  </document>
  
  
  

---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org


Mime
View raw message