Thomas von Dein d50bae5acf 2.01 - added -ConfigFile (in replace for -file) and
-ConfigHash (in replace for -hash) to get a consistent
	   parameter naming scheme. The old names are still
	   supported for backward compatibility, but no more
	   documented.

         - the parameter -BaseHash has been dropped because
	   -DefaultConfig already has the capabilities of
           defining a custom backing hash. The pod section for
	   -DefaultConfig has been enhanced to reflect this.

	 - README changed something. Removed the 'small' keyword,
	   because the module isn't really small anymore :-)
	   At least IMHO.


git-svn-id: http://dev.catalyst.perl.org/repos/Config-General/trunk@27 be1acefe-a474-0410-9a34-9b3221f2030f
2009-10-10 16:20:41 +00:00
2009-10-10 16:07:21 +00:00
2009-10-10 16:14:41 +00:00

NAME
       Config::General - Generic Config Module

SYNOPSIS
        use Config::General;
        $conf = new Config::General(-ConfigFile => "myconfig.rc");
        my %config = $conf->getall;


DESCRIPTION
       This module opens a config file and parses it's contents
       for you. After parsing the module returns a hash structure
       which contains the representation of the 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% read-compatible to apache configs, but
       you can also just use simple name/value pairs in your config
       files.

       In addition to the capabilities of a apache config file
       it supports some enhancements such as here-documents, C-
       style comments or multiline options. It is also possible to
       save the config back to disk, which makes the module a
       perfect backend for configuration interfaces.

       It is possible to use variables in config files and there
       exists also support for object oriented access to the
       configuration.


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
	2.01
Description
No description provided
Readme 322 KiB
Languages
Perl 96.9%
Shell 1.9%
Roff 1.1%