This file documents fidoconfig.

Copyright 1998-2002 Husky Development Team

fidoconfig
**********

This document describes the use of fidoconfig to make fido work on your favorite platform.

This document applies to version 1.4 of fidoconfig.

Design goals
************

The design goal of fidoconfig was to provide one config-file for several different fido software packages like editor, tosser etc. An additional aim was to have one library (fidoconfig) which can be used by all programs. The advantage is you only have to edit one config-file, so changing your system is much easier than with common software packages. Also bugs can only creep in one library and not in thousands over thousands libraries. The config definition can be used in all operating systems. Also the library should be quite portable.

Config file
***********

     [file proposal.texi not included]

Converting fidoconfig to golded, msged and aquaed
*************************************************

Since original GoldEd by Odinn Sorensen does not support fidoconfig at all and msged and aquaed only in beta versions, we have developed three programs that convert your fidoconfig to these proprietary config file formats.

 1. fconf2golded fconf2golded <goldedConfigFileName> [<default.cfg>]

          fconf2golded ~/golded/golded.cfg ~/golded/goldDefaults.cfg

 2. fconf2msged fconf2msged <msgedConfigFileName>

          fconf2msged ~/msged.areas

 3. fconf2aquaed fconf2aquaed <aquaedConfigFileName> [<default.cfg>] (if you specify default.cfg there will be a include <default.cfg> generated in your config file)

          fconf2aquaed ~/aquaed/aquaed.cfg

Testing the config
******************

You should run tparser EVERYTIME you have changed the config. If tparser found error in config please correct your config file and try again.

Syntax:
     tparser [-h|--help] [-Dvar=value] [-E] [-P] [/path/to/config/file]

Example:

          tparser -Dmodule=hpt | less

tparser (like any fidoconfig program) will display error messages if you have made an error in the config. It also may be display some warnings about your config settings. It will grumble on every Keyword it does not know. It will stop after the first error (not warning) to give you the ability to change your config.

Options
-------

-Dvar=value
     Set the config variable var to value.

-E
     Dumps config into stdout (all config variables expanded).

-h
--help
     Display usage information.

-P
     Try to create non-existing directories.

Contacting the author
*********************

You can reach me at

     mtt@tichy.de
     2:2432/645

and in the fido echoarea

     linux.develop.ger
     fidosoft.husky

Max Levenkov:

     sackett@mail.ru
     ru.husky (russian)
     ru.echoprocessors (russian)
     fidosoft.husky (english)

The actual fidoconfig library and other fido software will be on http://husky.sourceforge.net.