##
##  OSSP l2 - Flexible Logging
##  Copyright (c) 2001-2005 Cable & Wireless <http://www.cw.com/>
##  Copyright (c) 2001-2005 The OSSP Project <http://www.ossp.org/>
##  Copyright (c) 2001-2005 Ralf S. Engelschall <rse@engelschall.com>
##
##  This file is part of OSSP l2, a flexible logging library which
##  can be found at http://www.ossp.org/pkg/lib/l2/.
##
##  Permission to use, copy, modify, and distribute this software for
##  any purpose with or without fee is hereby granted, provided that
##  the above copyright notice and this permission notice appear in all
##  copies.
##
##  THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
##  WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
##  MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
##  IN NO EVENT SHALL THE AUTHORS AND COPYRIGHT HOLDERS AND THEIR
##  CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
##  SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
##  LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
##  USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
##  ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
##  OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
##  OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
##  SUCH DAMAGE.
##
##  l2tool.pod: tool manual page
##

=pod

=head1 NAME

B<l2tool> - OSSP l2 logging tool

=head1 VERSION

OSSP l2 L2_VERSION_STR

=head1 SYNOPSIS

B<l2tool>
I<specification>

=head1 DESCRIPTION

The B<l2tool> program is a little helper utility which reads log
messages from F<stdin> and writes it to a channel tree specified via the
channel tree I<specification>.

=head1 OPTIONS

B<l2tool> accepts the following options:

=over 4

=item B<--help>

Prints the short usage information.

=item B<--version>

Prints the version number and date of the installed l2(3) library.

...

=back

=head1 EXAMPLE

=head1 SEE ALSO

l2(3).

=head1 AUTHOR

 Ralf S. Engelschall
 rse@engelschall.com
 www.engelschall.com

=cut