ConfRead()

NAME

ConfRead - read the configuration file and set the WinDom parameters.

PROTOTYPAGE

int ConfRead( void);

PARAMETERS

ConfRead() returns an error code:

0:

no error,

-1:

application not find in the configuration file,

-33:

configuration file not found.

DESCRIPTION

ConfRead() reads in the WinDom configuration file the settings of the application. Only WinDom parameters are set. This file can contain other parameters readable with the functions ConfGetLine() and ConfInquire(). These parameters are specific to the application.

This function is used by ApplInit() to initialize the WinDom settings and by EvntWindom() when it receives the AP_CONF message.

The WinDom configuration file is an unique text file grouping the configuration of all WinDom application in a similar way then the '.Xdefaults' X11 file for example. This file is typically located in the HOME folder. Actually, WinDom searchs this file in the following directories :

• the application directory,

• the $HOME\Defaults directory,

• the $HOME directory,

• the $ETCDIR directory,

• the $PATH directories (can be multiple),

• the 'C:\' directory

This file is nammed 'windom.cnf' or '.windomrc' if the file system supports the long name file.

BUGS

Each line has the following syntax :

keyword = value list ...

A space character is required between the keyword and the '=' character.

SEE ALSO

ApplInit(), EvntWindom(), ConfInquire(), ConfGetLine(), WinDom configuration.