v4.0 Package Editor Configuration File (.cfx)

The configuration files in the package have the same configuration file format as installed configuration files except for added formatting commands. These formatting commands determine the way the distributed files are merged with existing ones.
uimpga-ga
The configuration files in the package have the same configuration file format as installed configuration files except for added formatting commands. These formatting commands determine the way the distributed files are merged with existing ones.
The layout of a configuration file looks like this:
<section1>
   key1 = value1
   <section2>
     key2 = value2
   </section2>
</section1>
<section3>
   key3 = value3
</section3>
Directives to determine merging behavior are added to the beginning of a section. The following directives are supported:
  • No directive
    Add keys from this section if they are not already present in the target configuration file.
  • ‘overwrite’
    Add keys from this section overwriting existing keys in the target configuration file. Note that changed sections are moved to the end of the containing section. This behaviour is needed when adding or changing a set of sections which need to be in a particular order.
  • ‘edit’
    Add or change keys from this section overwriting existing keys. The section position is not changed when using this option.
  • ‘delete’
    Remove keys mentioned.
  • ‘clear’
    Remove the whole section. If the section contains any keys then re-create the section adding these keys.
Note:
The same section may appear several times, for example:
<a> delete
   key1 =
</a>
<a>
   key2 = hei
</a>
This removes key1 from section a and adds key2.
Directives are not inherited by sub-sections but must be specified explicitly for each. The ‘clear’ directive is an exception to this since it will affect all subsections.
Examples of configuration file use
Add a key if it does not already exist:
<setup>
   loglevel = 0
</setup>
Set a key regardless of its earlier setting:
<setup> overwrite
   loglevel = 0
</setup>
Remove a section:
<setup> clear
</setup>
Remove all keys from a section and add one:
<setup> clear
   loglevel = 0
</setup>
Remove one key from a section and add another:
<setup> delete      
    logfile =       
</setup>        
<setup> overwrite           
    datafile = config.dat       
</setup>