Configuration settings
Woof! configurations settings are stored in the subdirectory config under the Woof! root directory. The configuration is stored in two files:
_woof.cfg | This file contains default configuration settings shipped as part of Woof! and generally should not be edited. |
application.cfg | This file contains site-specific configuration settings and can be edited to override the default settings. |
Both files are expected to contain Tcl code. Woof! reads its configuration by executing the files application.cfg and _woof.cfg, in that order, in a special temporary Tcl interpreter. A configuration variable is any variable that is set in either file that does not begin with an underscore (_).
Note that _woof.cfg sets variables using
the init
command which will only set the variable if it
has not already been set. This ensures
that _woof.cfg does not override
variables set in application.cfg.
The configuration files are actually executed in a safe Tcl interpreter so only a subset of Tcl commands are available. See the Tcl documentation for details.
The specific configuration variables and their values are documented in the relevant sections of this guide as well in the configuration files themselves.