Subject: ANNOUNCE: App::Config 1.07 released
From: [email-masked] (Andy Wardley)
Date: 9 Jul 1998 13:59:33 GMT
Newsgroups: comp.lang.perl.announce,comp.lang.perl.modules

A new version of App::Config (1.07) has been uploaded to CPAN.

This version contains a number of minor bug fixes and enhancements.  See
the "Changes" file in the distribution for further details.

Extracts from the documentation are included below.

A

========================================================================

NAME
    App::Config - Perl5 extension for managing global application
    configuration information.

SYNOPSIS
        use App::Config;
        my $cfg = new App::Config;

        $cfg->define("foo");            # very simple variable definition

        $cfg->set("foo", 123);          # trivial set/get examples
        $fval = $cfg->get("foo");      
        
        $cfg->foo(456);                 # direct variable access 

        $cfg->cfg_file(".myconfigrc");  # read config file
        $cfg->cmd_line(\@ARGV);         # process command line

OVERVIEW
    App::Config is a Perl5 module to handle global configuration
    variables for perl programs. The advantages of using such a
    module over the standard "global variables" approach include:

    *   Reduction of clutter in the main namespace.

    *   Default values can be specified.

    *   Multiple names (aliases) can refer to the same variable.

    *   Configuration values can be set directly from config files
        and/or command line arguments.

    *   Data values can be automatically validated by pattern matching
        (e.g. "\d+" to accept digits only) or through user-supplied
        routines.

    *   User-defined routines can be called automatically when
        configuration values are changed.

PREREQUISITES
    App::Config requires Perl version 5.004 or later. If you have an
    older version of Perl, please upgrade to latest version. Perl
    5.004 is known to be stable and includes new features and bug
    fixes over previous versions. Perl itself is available from your
    nearest CPAN site (see http://www.perl.com/CPAN).

INSTALLATION
    To install this module type the following:

        perl Makefile.PL
        make
        make install

    The 'make install' will install the module on your system. You
    may need root access to perform this task. If you install the
    module in a local directory (for example, by executing "perl
    Makefile.PL LIB=~/lib" in the above - see `perldoc MakeMaker'
    for full details), you will need to ensure that the PERL5LIB
    environment variable is set to include the location, or add a
    line to your scripts explicitly naming the library location: use
    lib '/local/path/to/lib';

AUTHOR
    Andy Wardley, `<[email-masked]>'

    Web Technology Group, Canon Research Centre Europe Ltd.

    App::Config is based in part on the ConfigReader module, v0.5,
    by Andrew Wilcox (currently untraceable).

    Thanks to all the people who have reported bugs and made
    suggestions. Extra special thanks to those who sent patches:

        Mik Firestone <[email-masked]>
            * GLOBAL arguments

        Blair Zajac <[email-masked]>
            * getpw*() check for Win32 compatibility

REVISION
    $Revision: 1.7 $

COPYRIGHT
    Copyright (C) 1997,98 Canon Research Centre Europe Ltd. All
    Rights Reserved.

    This module is free software; you can redistribute it and/or
    modify it under the term of the Perl Artistic License.

SEE ALSO
    Andy Wardley's Home Page
        http://www.kfs.org/~abw/

    Canon Research Centre Europe
        http://www.cre.canon.co.uk/perl/

    The ConfigReader module.
        The module which provided inspiration and ideas for the
        development of App::Config.

--
Andy Wardley <[email-masked]>   Signature regenerating.  Please remain seated.
     <[email-masked]>   For a good time: http://www.kfs.org/~abw/