PackageDescription: WoodchuckBundle(Bundle)


Woodchuck Bundle

Last published: December 12, 2009 by 'klnsrgn'

Woodchuck is a simple logging package. For usage examples, have a look at the testcases in package WoodchuckTests
(e.g. GeneralTest>>testCompleteExample)

Basically, five objects are involved:

* A Registry singleton that knows all active logs (Woodchuck.Registry)
* One or more Logs. One of these logs is the root log (Woodchuck.Log)
* Each log has one or more Writer (corresponding to class Appender in Log4j), that actually output the log messages (Woodchuck.Writer)
* Each log also has a processor that passes log entries to the writers (possibly delayed) (Woodchuck.LogEntryProcessor)
* Each writer has a formatter (corresponding to class Layout in Log4j), that format and/or augment the log messages (Woodchuck.Formatter)

---- License ---

This is a Smalltalk library, licensed under the LGPL, and distributed WITHOUT
ANY WARRANTY (see below). However, it is not obvious how some of
the terms and concepts in the license should be sensibly applied to Smalltalk
The various Smalltalk image models often do not directly correspond to
the ideas of programs and libraries that are linked to form executables.
We, the authors, would like to clarify our interpretation of the LGPL as it
applies to Smalltalk, and what we permit you to do with this code. We
will sometimes use the term LGPL(S) to distinguish the use of the LGPL
with these clarifications.

This code is intended to be usable as a library, without the intention to
restrict the license of the program that uses it. Thus, you may use this library
the same way you would normally use any other Smalltalk library. That is,
you may load it into an image or otherwise make it available for use in whatever
ways are appropriate to the Smalltalk implementation you are using (including,
but not limited to file-in, linking a shared library, or loading a binary
representation such as a parcel, BOSS file, image segment or image component).
You may write code that uses the library, including subclassing library classes
and having the library call back to your code using blocks, the #perform:
mechanism, or similar mechanisms. You may use this code, including creating
and distributing packaged images, libraries, development images and executables
that include the library code. We do not consider these activities sufficient
to make the entire program/image/executable or any portion of it beyond the
library itself be considered a derivative work, and in any case we place no
restrictions on what licenses you may use for code that uses this library in
these or similar manners.

If, however, you modify the class definitions or methods of the library, we do
consider those modified sections a derivative work, and as such they are fully subject
to the restrictions described in the LGPL. Basically, you'll need to release the
source of any modifications.

---- LGPL ---

This program is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License as published by the Free Software Foundation; either
version 2.1 of the License, or (at your option) any later version.

This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public
License along with this library; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA