diff --git a/xdocs/proposal.xml b/xdocs/proposal.xml new file mode 100644 index 0000000..e1acafd --- /dev/null +++ b/xdocs/proposal.xml @@ -0,0 +1,99 @@ + + +Proposal for Logging Library Package + + + + +
+ + + + + +

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. +

+ +

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. +

+ + + + +

The package shall create and maintain a package that provides extremely +basic logging functionality and bridges to other, more sophisticated logging +implementations. +

+ +

+The package should : +

    +
  • Have an API which should be as simple to use as possible
    • +
  • Provide support for log4j
    • +
  • Provide pluggable support for other logging APIs
    • +
+

+ +

+Non-goals: +

    +
  • This package will not perform logging itself, except at the most basic + level.
    • +
  • We do not seek to become a "standard" API.
    • +
+

+ + + + +

Logging relies on: +

+ +
    +
  • Java Development Kit (Version 1.1 or later) +
    • +
  • log4j (compile-time dependency only)
    • +
+ + + + +
    +
  • CVS Repository - New directory logging in the +jakarta-commons CVS repository.
    • + +
  • Initial Committers - The list is provided below.
    • + +
  • Mailing List - Discussions will take place on the general +commons-dev@jakarta.apache.org 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].
    • + +
  • Bugzilla - New component "Logging" under the "Commons" product +category, with appropriate version identifiers as needed.
    • + +
  • Jyve FAQ - New category "commons-logging" (when available).
    • +
+ + + + + +

The initial committers on the Logging component shall be:

+ +
    +
  • Morgan Delagrange
    • +
  • Rodney Waldhoff
    • +
  • Craig McClanahan
    • +
+ + +
+ +