The required syntax
Follow these rules when editing a configuration file:
- Lines starting with ``
%
'' are ignored and can be used to include comments.
This is also true for lines starting with ``@
'', but in this case the rest
of the line appears in the window.
All other lines are said to be ``significant''.
- Each significant line must contain at least one ``
=
'' character.
Any characters before the first ``=
'' are ignored, as are spaces or tabs
immediately after it. The rest of the line contains the information used
by , usually in the form of one or more strings.
If only one string is required then any further information is ignored.
Use double quotes around a string that includes one or more spaces.
- Do not change the order of significant lines
(except between the first and last ``
==
'').
expects to find all the parameters in a fixed sequence.
- To avoid long significant lines you can use ``
|
'' to split lines anywhere
you like. Upon reading a ``|
'', will ignore the rest of the current
line and continue reading from the next line. The best place to use ``|
''
is where a space is allowed; that way you can safely indent the next line
to make the file more readable.
- To help keep non-default configuration files short and simple, use these
special characters:
- If ``
?
'' is the first character of a parameter's value
then the parameter is not changed and the rest of the line is ignored.
- ``
!
'' is similar to ``?
'' but in addition all remaining parameters
are left unchanged (in fact the rest of the file is ignored).
Note that these characters are not recognized as special in the
Default file because every parameter must be given a default value,
even if empty.