Path: usenet.cise.ufl.edu!huron.eel.ufl.edu!usenet.eel.ufl.edu!uky.edu!news.campus.mci.net!calwebnntp!206.165.113.230.MISMATCH!nntpX.primenet.com!nntp.primenet.com!cpk-news-hub1.bbnplanet.com!cam-news-hub1.bbnplanet.com!news.bbnplanet.com!news.mathworks.com!uunet!in2.uu.net!news.neta.com!not-for-mail
From: [email protected] (Andy Wardley)
Newsgroups: comp.lang.perl.announce,comp.lang.perl.modules
Subject: ANNOUNCE: App::Config 1.07 released
Followup-To: comp.lang.perl.modules
Date: 9 Jul 1998 13:59:33 GMT
Organization: Canon Research Centre Europe, Ltd.
Lines: 119
Approved: [email protected] (comp.lang.perl.announce)
Message-ID: <[email protected]>
NNTP-Posting-Host: gadget.cscaper.com
X-Disclaimer: The "Approved" header verifies header information for article transmission and does not imply approval of content.
Xref: usenet.cise.ufl.edu comp.lang.perl.announce:86 comp.lang.perl.modules:2626



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 protected]>'

   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 protected]>
           * GLOBAL arguments

       Blair Zajac <[email protected]>
           * 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 protected]>   Signature regenerating.  Please remain seated.
    <[email protected]>   For a good time: http://www.kfs.org/~abw/