# $Id$

ReadMe for config-file-tools


Introduction
============

The config-file-tools are yet another script collection to help admins
manage config files.


Commands overview
=================

* cft-setoptions

'merges' settings from template files or -S into other config file(s).


Common options
==============

General options:

  --help      Prints command syntax.
  --version   Prints command version info and exits.

  -d          Debug mode, logs everything.
  -q          Quiet mode, supresses informative messages, for  feeding.
  -v          Verbose verboser, logs more.


Input options:

  -i file     Uses specied file as source of config options to set.
              Can be repeated to use multiple files.
  -s n=v      Set option n to value v.


Target options:

  file ...    Config file(s) to work on.

  -a          Add options to set that are not yet there.
  -n          Add new options only, do not alter existing options.
  -u          Update, only existing options are changed. Default.

  -c comment  Over new value insert line with '# comment'.
  -k          Keep former value as comment, i.e. prefixed with '#'.
  -t          Over new value insert line with '# by cft-xy at timestamp'.


  -f format   Specify format. For now only 'n=v' format is supported.
              Ideas for other formats include 'ini', 'n_v'.

