$Id: README,v 1.69 2001/04/20 19:04:34 Exp $


What Configurator is

The configurator Component enables you to package applications and configuration files in a one shot installation.


Distribution Details

This distribution comes with :

The lib/ directory includes a few useful utilities These utilities aren't installed either.

There are no tests for the moment.


Basic Installation

This component may be installed through the CPAN shell in the usual CPAN shell manner. It typically is:

perl -MCPAN -e 'install BabelObjects::Component::Data::Configurator'

It involves a little more work if you have an older CPAN shell:

perl -MCPAN -e shell
install BabelObjects::Component::Data::Configurator


Getting The Latest Version

This component can also be installed manually. Tarballs are available from several sources:

The most recent stable release can be found at your favorite CPAN mirror. If you don't have a favorite CPAN mirror, there's always:

ftp://ftp.cpan.org/pub/CPAN/authors/id/K/KE/KERMAGO/

The most recent development snapshot is available from :

http://www.BabelObjects.org/

The BabelObjects project includes a CVS repository browser, so you can look around to see what's new. It also has facilities for people to submit bug reports, patches, and support requests.

On BabelObjects, you will find this same project in Java and Php (so you understand now the name Babel Objects :-). If you are brave, come and develop the framework in a new language.


Building The Latest Version

Downloading and unpacking the distribution are left as an exercise for the reader. See the previous section for tarball locations.

System requirements and compatibility issues are covered in the main BabelObjects manpage. You can preview them before building BabelObjects.

perldoc ./BabelObjects.pm

Please read the Changes file if you already have programs which use this component. Sometimes there are changes that break compatibility with older versions, and the Changes file can tell you about them before you install it.

less ./Changes

If everything looks good, build the component

perl Makefile.PL
make

Then test the distribution. This is an important step since it also ferrets out the modules BabelObjects needs. It reports on the BabelObjects components which won't work because of missing dependencies, and it recommends things to install. Please read the dependency report carefully. Tests are not available for the moment.

make test

Now you're ready to install the component, but first you may want to look at its samples. Some of the samples may not work; the important thing is that the tests pass.

Finally you can install it:

make install


Test Results

To do...


Test Coverage

To do...

Thanks for reading!

-- Jean-Christophe Kermagoret / jck@BabelObjects.Org / www.BabelObjects.Org