Index: ossp-pkg/l2/README RCS File: /v/ossp/cvs/ossp-pkg/l2/README,v rcsdiff -q -kk '-r1.4' '-r1.5' -u '/v/ossp/cvs/ossp-pkg/l2/README,v' 2>/dev/null --- README 2001/09/13 14:22:02 1.4 +++ README 2001/11/09 12:45:37 1.5 @@ -9,7 +9,26 @@ ABSTRACT - The L2 library is [...] + OSSP L2 is a C library providing a very flexible and sophisticated + Unix logging facility. It is based on the model of arbitrary number + of channels, stacked together in a top-down data flow tree structure + with filtering channels in internal nodes and output channels on the + leave nodes. + + Channel trees can be either constructed manually through lower-level + API functions or all at once with a single API function controlled by + a compact syntactical description of the channel tree. For generating + log messages a printf-style formatting engine is provided which can be + extended through callback functions. The data flow inside the channel + tree is controlled by (eight fixed and nine custom) logging message + severity levels which are assigned to each individual channel. + + Channels are implemented by channel handlers which can be even + customer supplied for creating own channels which seamlessly integrate + into the framework. For convinience reasons, L2 already ships with + pre-implemented filtering (noop, filter, prefix, buffer) and output + (null, fd, file, pipe, socket, syslog, smtp) channels which already + cover mostly all use cases of logging. COPYRIGHT AND LICENSE Index: ossp-pkg/l2/l2.pod RCS File: /v/ossp/cvs/ossp-pkg/l2/l2.pod,v rcsdiff -q -kk '-r1.7' '-r1.8' -u '/v/ossp/cvs/ossp-pkg/l2/l2.pod,v' 2>/dev/null --- l2.pod 2001/09/20 16:26:56 1.7 +++ l2.pod 2001/11/09 12:45:37 1.8 @@ -43,7 +43,26 @@ =head1 DESCRIPTION -The B library is... +OSSP L2 is a C library providing a very flexible and sophisticated +Unix logging facility. It is based on the model of arbitrary number of +channels, stacked together in a top-down data flow tree structure with +filtering channels in internal nodes and output channels on the leave +nodes. + +Channel trees can be either constructed manually through lower-level +API functions or all at once with a single API function controlled by +a compact syntactical description of the channel tree. For generating +log messages a printf-style formatting engine is provided which can be +extended through callback functions. The data flow inside the channel +tree is controlled by (eight fixed and nine custom) logging message +severity levels which are assigned to each individual channel. + +Channels are implemented by channel handlers which can be even +customer supplied for creating own channels which seamlessly integrate +into the framework. For convinience reasons, L2 already ships with +pre-implemented filtering (noop, filter, prefix, buffer) and output +(null, fd, file, pipe, socket, syslog, smtp) channels which already +cover mostly all use cases of logging. =head1 FUNCTIONS