Config file

Wconnect has two config files both called wconnect.cf.

The system config-file (the equivalent of unix's /etc/wconnect.cf) goes in the same directory as wconnect, and is read first.

Every user also has their own private config file (the equivalent of unix's ~/.wconnect) stored somewhere appropriate. (Look in the Debug page of Wconnect's Propetiers Window to see where.) When wconnect exits, the current values of the Properties Window are saved out to the user's config file; these settings are then reloaded next time wocnnect starts, overriding entries in the system config file.

Editing the system config file allows you to set defaults for every user who runs that copy of wconnect without having to (find and) edit their individual config files. Entries in a system config-file can also be marked global, which tells wconnect to ignore the user's value; the user can still edit properties (they get a warning when they do) but these values will be ignored when they reload wconnect. So if a user nukes your settings then restarting wconnect will guarantee some sensible defaults.

Both config files have the same, unix-like format. Comments begin with a single hash (#) and run through to the end of line. Entries take the form

     [global] option [=] value
     

Only one entry per line. A value with non alphanumerics has to be quoted using single or double quotes and the usual range of C/unix backslash-escapes. (Including escaping backslashes, so for every '\' you must put a '\\').

Option names are case sensative.

When a system config-file entry begins with 'global' wconnect ignores the setting in the user's config file. (Which is why it makes no sense for an option in the user's file to be global.)

Errors are displayed in the debug console (you may need to enable it on the Menu page of wconnect's Properties). And Typos are not spotted.

The config file has a GUI-front end: its called the Properties windows; for every control in the Properties Window their is an option in the config file. However there are also config options which aren't yet accessible from the properties dialog. These are detailed in the config file.