\input texinfo @c -*-texinfo-*-
@c %**start of header
@setfilename fidoconfig.info
@settitle FidoConfig Manual
@setchapternewpage odd
@c %**end of header

@ifinfo
This file documents fidoconfig.

Copyright 1998-99 Matthias Tichy

@end ifinfo

@titlepage
@title FidoConfig Manual
@subtitle a way to make your unix fido-capable
@author Matthias Tichy

@page
@vskip 0pt plus 1filll
Copyright @copyright{} 1998-99 Matthias Tichy

@end titlepage

@ifinfo
@node Top, , , (dir)
@top fidoconfig

This document describes the use of fidoconfig to make fido work on your unix
workstation.

This document applies to version 0.9 of fidoconfig.
@end ifinfo

@menu
* design goals::  what we want to achieve
* config file::   how does it look like
* tparser::       testing your config
* converting::    Converting fidoconfig to golded and msged
* contact::       contacting the author
@end menu

@node design goals, config file, Top, Top
@chapter 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.

@node config file, converting, design goals, Top
@chapter Config file
@include proposal.texi

@node converting, tparser, config file, Top
@chapter Converting fidoconfig to golded, msged and aquaed
Since goldEd not support fidoconfig, and msged and aquaed only in beta
versions, we have developed two
programs which converts your fidoconfig to the proprietary config file format.

@enumerate
@item fconf2golded
fconf2golded <goldedConfigFileName> [<default.cfg>]

@example
fconf2golded ~/golded/golded.cfg ~/golded/goldDefaults.cfg
@end example

@item fconf2msged
fconf2msged <msgedConfigFileName> 

@example
fconf2msged ~/msged.areas
@end example

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

@example
fconf2aquaed ~/aquaed/aquaed.cfg
@end example

@end enumerate

@node tparser, contact, converting, Top
@chapter Testing the config
You should run tparser everytime you have changed the config. If tparser
crashes please correct your config file and send your config or the line which
causes the crash. 

@example
./tparser | less
@end example

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

@node contact, , tparser, Top
@chapter Contacting the author
You can reach me at 

@example
@email{mtt@@tichy.de}
2:2432/605.14
2:2433/1245
@end example

and in the fido echoarea

@example
linux.develop.ger
@end example

The actual fidoconfig library and other fido software will be on
@code{www.tichy.de}.

@bye
