Provided by: lire_2.0.1-4_all bug

NAME

       Lire - generate reports from various log files

INTRODUCTION

       Lire allows one to generate reports from various log files.

       In this manpage, we give an overview of the Lire documentation.

       Documentation on installing Lire

       For installation instructions, read the file INSTALL. This file is
       shipped with the Lire tarball, lire-version.tar.gz.  It is available
       from the World Wide Web at http://logreport.org/pub/current/INSTALL.

       Some platform-specific hints are documented in the Frequently Asked
       Question About Lire, which gets installed - in various different
       formats - in /usr/[local/]share/doc/lire/faq*.  In the Lire tarball, it
       resides in /doc/faq* .  It is available online too, at
       http://logreport.org/pub/current/doc/faq/ .

       Documentation for users

       Read the Lire README file for a quick start on Lire’s usage.  This file
       is shipped with the Lire tarball.  If you’ve installed Lire from a
       package for your Operating System, it might be installed in a location
       like /usr/share/doc/lire/README .

       Read the Lire Users Manual for a more in-depth overview.  This manual
       is available in various formats, and installed in
       /usr/[local/]share/doc/lire/user-manual* .  It is available online, at
       http://logreport.org/pub/current/doc/user-manual/ .

       The main Lire commands (lire(1), lr_log2mail(1), lr_log2report(1),
       lr_run(1), lr_xml2report(1), ...) should be in your PATH.  The usage of
       these commands is documented in man pages; running e.g.

        man lr_log2report

       should show you the lr_log2report manpage.  All these commands have a
       leading ‘lr_’ in their names.  (So, if your shell does tab-completion,
       type ‘lr_tab’ to see them all.)

       Documentation for developers

       If you plan to change the Lire internals, or if you are trying to fix a
       bug, you should consult the Lire Developers Manual.  This document is
       available in various formats, and installed in
       /usr/[local/]share/doc/lire/dev-manual* .

       A lot of Lire internal scripts get installed in
       /usr/[local/]libexec/lire/.  They all have a leading ‘lr_’ in their
       name.  These all come with their own man page.  Lire convertors, which
       take care of log file specific processing, are installed in
       /usr/[local/]libexec/lire/convertors/.  These scripts are named
       service2dlf, and all come with their own man page.  If you’re looking
       for information, specifically for your log file type, you should look
       here.

       The Lire internal scripts use Perl modules to do the real work.  These
       come with their own manpages.  They’re installed in
       /usr[/local]/share/perl5/Lire/ .  If you plan to write customized Lire
       extensions, you should read these manpages.

       If you plan to cooperate with the LogReport team, or you’re just
       interested in what the team is up to, development wise, you should
       consult The Lire Roadmap; installed in
       /usr/[local/]share/doc/lire/roadmap* .  The BUGS file, as distributed
       with the Lire tarball, is interesting too.

       The file COPYING documents terms and conditions for copying,
       distribution and modification of Lire.  Some extra explanation about
       this is given in Frequently Asked Question About Lire.

       Other sources of information

       Some documentation on Lire and LogReport is not distributed with the
       Lire tarball.  Documentation is available from the LogReport website on
       http://www.logreport.org/ .  It offers mailing list archives on
       http://www.logreport.org/contact/lists/ .

       You can get in touch with other Lire users on the Lire mailing lists,
       see http://logreport.org/contact/lists/ .  The LogReport team can be
       contacted directly too (email, irc, snailmail), see
       http://logreport.org/contact/ for details.

VERSION

       This manpage: $Id: lire.pod,v 1.3 2004/04/07 20:44:59 flacoste Exp $

COPYRIGHT

       Copyright (C) 2002 Stichting LogReport Foundation
       LogReport@LogReport.org

       This manpage is part of Lire.

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

       This program 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
       General Public License for more details.

       You should have received a copy of the GNU General Public License along
       with this program (see COPYING); if not, check with
       http://www.gnu.org/copyleft/gpl.html or write to the Free Software
       Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111, USA.

AUTHOR

       Joost van Baal <joostvb@logreport.org>