.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" Required to disable full justification in groff 1.23.0.
.if n .ds AD l
.\" ========================================================================
.\"
.IX Title "Logger 3pm"
.TH Logger 3pm 2025-09-28 "Lire 2.1.1" "LogReport's Lire Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH NAME
Lire::Logger \- Lire\*(Aqs logging interface.
.SH SYNOPSIS
.IX Header "SYNOPSIS"
Any program:
.PP
.Vb 1
\&    use Lire::Logger qw/ lr_info lr_debug lr_warn /;
\&
\&    lr_info( "doing stuff " );
\&    lr_debug( "debugging information" );
\&    lr_warn( "encountered unexpected value: ", $value );
\&    open( CFGFILE, "my.conf" ) or lr_err( "open error: ", $! );
.Ve
.SH DESCRIPTION
.IX Header "DESCRIPTION"
This module contains functions that should be used by everything in
the Lire framework which should need logging.
.PP
All logging functions take any number of parameters that will be
joined together to form the message (like \fBprint()\fR, \fBdie()\fR, \fBwarn()\fR and
friends).
.SS \fBlr_emerg()\fP
.IX Subsection "lr_emerg()"
This logs a message at the \f(CW\*(C`emerg\*(C'\fR level and aborts your program. This
probably shouldn\*(Aqt be used.
.SS \fBlr_crit()\fP
.IX Subsection "lr_crit()"
This logs a message at the \f(CW\*(C`crit\*(C'\fR level and aborts your program. This
should only be used when something is really broken in the Lire
program or the environment. It is used a few places in Lire when
assertion that should really never fail (like a DLF file with the
wrong number of fields).
.SS \fBlr_err()\fP
.IX Subsection "lr_err()"
This logs a message at the \f(CW\*(C`err\*(C'\fR level and usually aborts your
program. (It is the equivalent of a \fBdie()\fR.) The program won\*(Aqt abort if
it\*(Aqs used in an eval block. Uses this for error condition.
.SS \fBlr_warn()\fP
.IX Subsection "lr_warn()"
This logs a message at the \f(CW\*(C`warning\*(C'\fR level. Perl\*(Aqs builtin warn is
mapped to this function. Use this for non\-fatal errors.
.SS \fBlr_notice()\fP
.IX Subsection "lr_notice()"
This logs a message at the \f(CW\*(C`notice\*(C'\fR level. This should be used for
significant informational messages that the user should see. (By
default, the user will only see messages at level \f(CW\*(C`notice\*(C'\fR or
higher.)
.SS \fBlr_info()\fP
.IX Subsection "lr_info()"
This logs a message at the \f(CW\*(C`info\*(C'\fR level. Use this for general
informational messages.
.SS \fBlr_debug()\fP
.IX Subsection "lr_debug()"
This logs a message at the \f(CW\*(C`debug\*(C'\fR level. Use this for debugging messages.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fBLire::Program\fR\|(3pm)
.SH AUTHOR
.IX Header "AUTHOR"
.Vb 1
\&  Francis J. Lacoste <flacoste@logreport.org>
.Ve
.SH VERSION
.IX Header "VERSION"
\&\f(CW$Id:\fR Logger.pm,v 1.10 2006/07/23 13:16:29 vanbaal Exp $
.SH COPYRIGHT
.IX Header "COPYRIGHT"
Copyright (C) 2001\-2003 Stichting LogReport Foundation LogReport@LogReport.org
.PP
This file is part of Lire.
.PP
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.
.PP
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.
.PP
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.