31.2.4 Assigning values to configuration variables

A configuration-variable assignment can be any of the following, depending on the context and the extent of the configuration override: 

Context	Persistent override	Temporary override
*Config marker	[Section]Key=Value	[Section]=Value
Mif2Go macro	$$[Section]Key=Value	$$[Section]=Value

where:

Section	names the configuration-file section where the setting belongs
Key	names the keyword whose value you want to change, or the format or object whose properties you want to change; omit for temporary overrides
Value	is the new value for the setting.

When you assign a value to a configuration variable, observe the following:

• Spaces around [Section] are optional.

• Section is not case sensitive.

• In a macro, [Section] must be prefixed with $$; in a *Config marker, the prefix is optional.

• Include Key only for a persistent override; see §31.2.1 Determining the extent of a configuration override.

• Key is case sensitive for variable-key settings.

• Key may not use wildcards.

• Key must be enclosed in quotes if Key contains any spaces or non-alphanumeric characters.

• If Key requires an on/off value, Mif2Go recognizes "1" (numeral one), "Yes", and "True" as on, and "0" (zero), "No", and "False" as off.

• In a macro, if Value is a text string, Value must be enclosed in quotes. In a *Config marker, quotes around text values are optional; if present, Mif2Go removes them. Therefore, if the value to be assigned actually contains quotes at both ends, you must double them for assignment in a *Config marker. For example:

HTMConfig: [StyleTextStore]=""a quoted phrase""

• If Value includes the name of a macro or macro variable, whether that name should be enclosed in quotes depends on the context; see §31.2.5 Assigning a macro or variable to a configuration variable.

Add new configuration values

Besides overriding existing settings in the configuration file, you can use a configuration-variable assignment to specify a persistent override for a setting that is not even present in your configuration file, provided both of the following are true:

• [Section] is listed as subject to overrides in one of Table 31-2 through Table 31-6.

• Key is a valid key for the section.

If the section is not listed, or the key is not valid for the section, the setting you specify is treated instead as an error, with value "0" (zero).

---

> 31 Overriding configuration settings > 31.2 Overriding settings with markers or macros > 31.2.4 Assigning values to configuration variables