Configuration File Syntax

Configuration files contain text. You can modify them from the Configuration section of the IDE, or using a text editor. You can give configuration files any name and extension you choose. By default, they have the extension .icc.

The configuration file syntax follows these C and C++ rules:

// this comment runs to the end of the line
/* this comment is delimited at both ends 
and can span lines */ 

The content of a configuration file is a sequence of directives and comments. For example, the following lines contain one comment and the three directives: target, option, and source.

// build an executable program
target "myprog.exe" {
   option lang(compatIO) {
      source "mymain.cpp", "myclasses.hpp" 
   }
}

Directives often contain names of options used by processes run during a build. In the code above, lang(compatIO) is a language option that applies to C++ sources.

Unlike C and C++ statements, directives do not require a semicolon or other termination character. Directive names are case-sensitive and must be in lowercase. Option names are not case-sensitive.

Configuration files can also contain the following elements:

Example of a Configuration File



Configuration Files
How Configuration Files Are Processed


Change a Build Setup
Add or Change Source Files
Add or Change Targets
Build


Configuration File Directives
Build Options