Overriding Compiler/Linker Command Line Options
It is possible to override specific options in the compiler or
linker command line when building with IncrediBuild. This is useful
when different behavior is required in IncrediBuild builds compared
to standard Visual Studio builds (for example, you may want to
define a preprocessor symbol only in your IncrediBuild builds).
To specify command line overrides in a solution or workspace,
create a file named after the solution/workspace name, with the
extension .ib_ini. This file should be located in the same folder
as the solution/workspace's .sln or .dsw file.
The file should be similar in syntax to the following sample
.ib_ini file:
[SolutionLevelOptions]
CL_REM=
CL_ADD=
LINK_ADD=
LINK_REM=
[ProjectName]
CL_REM=
CL_ADD=
LINK_ADD=
LINK_REM=
The "[SolutionLevelOptions]" block represents command line
overrides that will affect all projects in the solution, while the
"[ProjectName]" block represents command line overrides affecting a
specific project (replace "ProjectName" with the name of the
project to be affected).
The 4 entries in each block represent options added (CL_ADD) and
subtracted (CL_REM) from the compiler command lines, and options
added (LINK_ADD) and subtracted (LINK_REM) from the compiler
command line. All 4 are optional. To specify a command line
modification, simply add the option to be subtracted or added from
the tool's command line after the "=".
For example:
[MyProject]
CL_ADD=/D "__INCREDIBUID__ /nologo"
CL_REM="/Yx"
This will add the symbol __INCREDIBUILD__ and remove automatic
precompiled headers usage (/Yx) ONLY in the project "MyProject".
Since in this example no changes were required in the linker
command line, the LINK_REM and LINK_ADD options were omitted.
Notes:
- You may specify several project blocks for different
projects.
- The SolutionLevelOptions block is optional and can be
omitted.
- If you are already using an .ib_ini file to specify Project Priorities (or a different
option), simply add the command line override definitions to the
existing file.
Copyright (C) 2001-2008 Xoreax Software Ltd. All rights
reserved.