.\" Automatically generated by Pod::Man 2.22 (Pod::Simple 3.14)
.\"
.\" 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
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
'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 turned on, 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.
.ie \nF \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    nr % 0
.    rr F
.\}
.el \{\
.    de IX
..
.\}
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "Config 3pm"
.TH Config 3pm "2006-07-23" "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::Config \- import Lire configuration variables to perl
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
.Vb 1
\& use Lire::Config;
\&
\& Lire::Config\->init();
\&
\& my $cfg\->value = Lire::Config\->get( \*(Aqlr_schemas_path\*(Aq );
\&
\& my $var = Lire::Config\->get_var( \*(Aqlr_schemas_path\*(Aq );
.Ve
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
This package provides the \s-1API\s0 to access the Lire configuration.
.SH "METHODS"
.IX Header "METHODS"
These methods can be called directly on a Lire::Config instance or the
Lire::Config package itself. In the last case, it is the same thing
as calling the method on the object returned by the \fIinstance()\fR
method.
.SS "\fIinstance()\fP"
.IX Subsection "instance()"
Returns the singleton Lire::Config object from which configuration can
be queried.
.SS "\fIconfig_spec()\fP"
.IX Subsection "config_spec()"
Returns the configuration specification used by the current
configuration.
.SS "\fIconfig_spec_path()\fP"
.IX Subsection "config_spec_path()"
Returns a list of directories which will be searched for configuration
specification file. By default, configuration specifications are only
looked for in \fI<datadir\fR/lire/config\-spec>.
.ie n .SS "add_config_spec_path_dir( $dir )"
.el .SS "add_config_spec_path_dir( \f(CW$dir\fP )"
.IX Subsection "add_config_spec_path_dir( $dir )"
This method adds a directory to list of directories that will is used
to search for configuration specification files.
.ie n .SS "del_config_spec_path_dir( $dir )"
.el .SS "del_config_spec_path_dir( \f(CW$dir\fP )"
.IX Subsection "del_config_spec_path_dir( $dir )"
This method removes a directory from the list of directories that is
used to search for configuration specification files.
.SS "\fIconfig_files()\fP"
.IX Subsection "config_files()"
Returns the list of configuration files that will be used for this
configuration.
.ie n .SS "add_config_path( $path )"
.el .SS "add_config_path( \f(CW$path\fP )"
.IX Subsection "add_config_path( $path )"
Adds configuration files to the list of files that are part of the
configuration. Directories will be scanned recursively.
.ie n .SS "add_config_file( $file )"
.el .SS "add_config_file( \f(CW$file\fP )"
.IX Subsection "add_config_file( $file )"
Adds a configuration file to the list of files that will be parsed to
initialize the configuration.
.ie n .SS "del_config_file( $file )"
.el .SS "del_config_file( \f(CW$file\fP )"
.IX Subsection "del_config_file( $file )"
Removes a configuration file from the list of files that are part of
the configuration.
.SS "get_config_file($file)"
.IX Subsection "get_config_file($file)"
Get a parsed configuration file object from the list of files.
.SS "\fIinit()\fP"
.IX Subsection "init()"
This method loads and parses the configuration files. It should be called
prior to using the \fIget()\fR method to obtain configuration data. This
method will throw an exception in case there is an invalid
parameter in the configuration.
.ie n .SS "get( $varname )"
.el .SS "get( \f(CW$varname\fP )"
.IX Subsection "get( $varname )"
Returns the configuration value for the \f(CW$varname\fR configuration
variable. \fIinit()\fR should have been called to load the configuration
data before using this method. It will \fIcroak()\fR otherwise. If the
\&\f(CW$varname\fR is unknown, an exception will also be thrown.
.ie n .SS "get_var( $varname )"
.el .SS "get_var( \f(CW$varname\fP )"
.IX Subsection "get_var( $varname )"
Returns the configuration value for the \f(CW$varname\fR configuration
variable as the configuration object. \fIinit()\fR should have been called
to load the configuration data before using this method. It will
\&\fIcroak()\fR otherwise. If the \f(CW$varname\fR is unknown, an exception will also
be thrown.
.SH "DEBUGGING"
.IX Header "DEBUGGING"
One can call this module direct from the commandline, e.g. for debugging
purposes, by doing something like:
.PP
.Vb 2
\& perl \-e \*(Aquse lib "/path/to/your/share/perl5"; use Lire::Config; \e
\&  use Lire::Program; print Lire::Config\->get( "lr_mail_from" ), "\en"\*(Aq
.Ve
.PP
or
.PP
.Vb 2
\& perl \-e \*(Aquse Lire::Config; use Lire::Program; \e
\&  $a = Lire::Config\->get( lr_converters_init_path );  print "@$a\en"; \*(Aq
.Ve
.PP
\&.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fILire::Config::TypeSpec\fR\|(3pm), \fILire::Config::Value\fR\|(3pm)
.SH "AUTHORS"
.IX Header "AUTHORS"
Wessel Dankers <wsl@logreport.org>
Francis J. Lacoste <flacoste@logreport.org>
Joost van Baal <joostvb@logreport.org>
.SH "VERSION"
.IX Header "VERSION"
\&\f(CW$Id:\fR Config.pm,v 1.47 2006/07/23 13:16:28 vanbaal Exp $
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
Copyright (C) 2001\-2004 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 \s-1GNU\s0 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 \s-1WITHOUT\s0 \s-1ANY\s0 \s-1WARRANTY\s0; without even the implied warranty of
\&\s-1MERCHANTABILITY\s0 or \s-1FITNESS\s0 \s-1FOR\s0 A \s-1PARTICULAR\s0 \s-1PURPOSE\s0.  See the
\&\s-1GNU\s0 General Public License for more details.
.PP
You should have received a copy of the \s-1GNU\s0 General Public License
along with this program (see \s-1COPYING\s0); if not, check with
http://www.gnu.org/copyleft/gpl.html.