=========================================================================
Config::FileManager -- Configuration File Management with versionning
-------------------------------------------------------------------------
$Id: README,v 1.3 2013/11/07 10:19:25 doccy Exp $
=========================================================================


OVERVIEW:
========

The Config::FileManager module helps to manage configuration files.
It provides versionning and check for updates of obsolete
versions

All files are self documented using the POD format and tools.

DESCRIPTION:
===========

Usage:

 use Config::FileManager;

 my $cfg = new Config(
                      # Mandatory settings
                      "toolname" => "tool name",
                      # Optional settings
                      "version" => "version string", # default to undef
                      "filename" => "config file basename", # default to "config"
                      "paths" => [qw(list of/paths /to/look ./for)], # default to [qw(. __APPDIR__ /usr/local/etc /etc)],
                      "interactive" => 0, # default to 1
                     );

INSTALLATION:
============

To install this module type the following:

   perl Makefile.PL
   make
   make test
   make install


DEPENDENCIES:
============

This package requires these other programs, modules and libraries* :

- perl 5.1 or +
- strict
- warnings
- utf8
- Exporter
- File::Basename
- File::HomeDir
- POSIX
- Pod::Usage
- Text::Patch
- Text::Diff
- Data::Dumper
- Carp

Notice that almost required modules/libraries are standard.


PROBLEMS:
========


COPYRIGHT AND LICENCE:
=====================

  Copyright �� 2012-2013 -- LIRMM/UM2
                          (Laboratoire d'Informatique, de Robotique et de
                           Micro��lectronique de Montpellier /
                           Universit�� de Montpellier 2)
                           IRB/INSERM
                          (Institut de Recherche en Bioth��rapie /
                           Institut National de la Sant�� et de la
                           Recherche M��dicale)

Auteurs/Authors: Alban MANCHERON  <alban.mancheron@lirmm.fr>
                 Nicolas PHILIPPE <nicolas.philippe@inserm.fr>

-------------------------------------------------------------------------

Ce fichier  fait partie  du Pipeline  de traitement  de donn��es NGS de la
plateforme ATGC lab��lis��e par le GiS IBiSA.

Ce logiciel est r��gi  par la licence CeCILL  soumise au droit fran��ais et
respectant les principes  de diffusion des logiciels libres.  Vous pouvez
utiliser, modifier et/ou redistribuer ce programme sous les conditions de
la licence CeCILL  telle que diffus��e par le CEA,  le CNRS et l'INRIA sur
le site "http://www.cecill.info".

En contrepartie de l'accessibilit�� au code source et des droits de copie,
de modification et de redistribution accord��s par cette licence, il n'est
offert aux utilisateurs qu'une garantie limit��e.  Pour les m��mes raisons,
seule une responsabilit��  restreinte p��se  sur l'auteur du programme,  le
titulaire des droits patrimoniaux et les conc��dants successifs.

��  cet ��gard  l'attention de  l'utilisateur est  attir��e sur  les risques
associ��s  au chargement,  ���� l'utilisation,  ���� la modification  et/ou au
d��veloppement  et ����la reproduction du  logiciel par  l'utilisateur ��tant
donn��  sa sp��cificit��  de logiciel libre,  qui peut le rendre  complexe ��
manipuler et qui le r��serve donc ����des d��veloppeurs et des professionnels
avertis  poss��dant  des  connaissances  informatiques  approfondies.  Les
utilisateurs  sont donc  invit��s  ���� charger  et  tester  l'ad��quation du
logiciel  ����leurs besoins  dans des conditions  permettant  d'assurer  la
s��curit�� de leurs syst��mes et ou de leurs donn��es et,  plus g��n��ralement,
����l'utiliser et l'exploiter dans les m��mes conditions de s��curit��.

Le fait  que vous puissiez acc��der  ����cet en-t��te signifie  que vous avez
pris connaissance  de la licence CeCILL,  et que vous en avez accept�� les
termes.

-------------------------------------------------------------------------

This File is part of the NGS data processing Pipeline of the ATGC
accredited by the IBiSA GiS.

This software is governed by the CeCILL license under French law and
abiding by the rules of distribution of free software. You can use,
modify and/ or redistribute the software under the terms of the CeCILL
license as circulated by CEA, CNRS and INRIA at the following URL
"http://www.cecill.info".

As a counterpart to the access to the source code and rights to copy,
modify and redistribute granted by the license, users are provided only
with a limited warranty and the software's author, the holder of the
economic rights, and the successive licensors have only limited
liability.

In this respect, the user's attention is drawn to the risks associated
with loading, using, modifying and/or developing or reproducing the
software by the user in light of its specific status of free software,
that may mean that it is complicated to manipulate, and that also
therefore means that it is reserved for developers and experienced
professionals having in-depth computer knowledge. Users are therefore
encouraged to load and test the software's suitability as regards their
requirements in conditions enabling the security of their systems and/or
data to be ensured and, more generally, to use and operate it in the same
conditions as regards security.

The fact that you are presently reading this means that you have had
knowledge of the CeCILL license and that you accept its terms.