Files
Config-General/README
Thomas von Dein 31144f9e4f 1.34 - Danial Pearce <danial@infoxchange.net.au> reported a bug
in _store(), which caused the module to create scalar
	   entries even if the entry contained newlines. While
	   Danial supplied a patch to fix this - thx(TM) - I
	   did not apply it, because I "outsourced" this kind of
	   stuff to the subroutine _write_scalar(), see next.

         - added internal methods _write_scalar() and _write_hash()
	   to simplify _store(), which did the same thing more
	   than once, which is a good time to create a sub which
	   does the job.

         - fixed cut'n paste bug in General/Extended.pm reported by
	   Danial Pearce <danial@infoxchange.net.au>, which caused
	   Config::General::Extended::is_scalar() to return true even
	   when the key you pass in is an array.

         - added new method Config::General::Extended::delete() suggested
	   by Danial Pearce <danial@infoxchange.net.au>, which deletes
	   the given key from the config.


git-svn-id: http://dev.catalyst.perl.org/repos/Config-General/trunk@23 be1acefe-a474-0410-9a34-9b3221f2030f
2009-10-10 16:18:02 +00:00

69 lines
1.7 KiB
Plaintext

NAME
Config::General - Generic Config Module
SYNOPSIS
use Config::General;
$conf = new Config::General("rcfile");
my %config = $conf->getall;
DESCRIPTION
This small module opens a config file and parses it's
contents for you. The new method requires one parameter
which needs to be a filename. The method getall returns a
hash which contains all options and it's associated values
of your config file.
The format of config files supported by Config::General is
inspired by the well known apache config format, in fact,
this module is 100% compatible to apache configs, but you
can also just use simple name/value pairs in your config
files.
In addition to the capabilities of an apache config file
it supports some enhancements such as here-documents, C-
style comments or multiline options.
INSTALLATION
to install, type:
perl Makefile.PL
make
make test
make install
to read the complete documentation, type:
perldoc Config::General
perldoc Config::General::Extended
perldoc Config::General::Interpolated
see some example config files which can
be parsed with Config::Genreal in the subdirectory
t/cfg.*
COPYRIGHT
Config::General
Config::General::Extended
Copyright (c) 2000-2002 Thomas Linden <tom@daemon.de>
Config::General::Interpolated
Copyright (c) 2001 Wei-Hon Chen <plasmaball@pchome.com.tw>
This library is free software; you can redistribute it
and/or modify it under the same terms as Perl itself.
BUGS
make test does currently not catch all possible scenarios.
AUTHOR
Thomas Linden <tom@daemon.de>
VERSION
1.34