Configuration parameters are set in the configuration file. When setting configuration parameter values, you must use UTF-8.
This section describes how to enter parameter values in the configuration file.
The following settings for Boolean parameters are interchangeable:
TRUE = true = ON = on = Y = y = 1
FALSE = false = OFF = off = N = n = 0
To enter a comma-separated list of strings when one of the strings contains a comma, you can indicate the start and the end of the string with quotation marks, for example:
ParameterName=cat,dog,bird,"wing,beak",turtle
Alternatively, you can escape the comma with a backslash:
ParameterName=cat,dog,bird,wing\,beak,turtle
If any string in a comma-separated list contains quotation marks, you must put this string into quotation marks and escape each quotation mark in the string by inserting a backslash before it. For example:
ParameterName="<font face=\"arial\" size=\"+1\"><b>","<p>"
Here, quotation marks indicate the beginning and end of the string. All quotation marks that are contained in the string are escaped.
You can reference an external configuration file to include shared settings. The following examples show how to include a configuration file, or a section or parameter from the file.
Include a whole configuration file:
< "ConfigurationFile.cfg"
Include a section from another configuration file:
< "ConfigurationFile.cfg" [SharedSection]
Include a single parameter from another configuration file:
[SectionName] < "ConfigurationFile.cfg" [SharedSection] ParameterName
You can also include a default value to use if the shared configuration file does not contain the specified parameter:
< "ConfigurationFile.cfg" [SharedSection] ParameterName=DefaultValue
Merge a section of an external configuration file into a specified section with a different name:
[SectionName] < "ConfigurationFile.cfg" [SharedSection]
This example includes the values in [SharedSection]
from the external configuration file into [SectionName]
in your file.
In all these examples, ConfigurationFile.cfg
is the path and file name of the shared configuration file. You can specify the file location by using absolute paths, relative paths, and network locations. For example:
../sharedconfig.cfg K:\sharedconfig\sharedsettings.cfg \\example.com\shared\idol.cfg file://example.com/shared/idol.cfg
Relative paths are relative to the primary configuration file.
|