| Syntax: | Default: |
|---|---|
| incl(searchPath, path) | none |
This option determines which directories are searched to satisfy #include directives in the C and C++ source files. It also establishes the paths for source files that are specified with relative paths.
If you use this option more than once with the same option directive, the paths are searched in the order that the search paths appear in the configuration file. If you nest option directives, include search paths specified in inner directives are searched before include search paths specified in outer directives. For example, the following lines set up a search that looks in the subdirectories of directory root in the order c, d, a, b:
option incl(searchPath, '\root\a'), incl(searchPath, '\root\b') {
option incl(searchPath, '\root\c'), incl(searchPath, '\root\d') {
source 'x.cpp'
}
}
For files that are included by directives that have the form #include "filename.h", the directory containing the including source file is searched before the include search path, by default. To search directories in the include search paths before the directory that contains the including file, also apply option incl(searchPathFirst, yes).
For C++
user included files, set incl(userStrategy,
primary) or incl(userStrategy, including) to determine which
file is considered to be the including file.
![]()
![]()
For C source
files on OS/2 and Windows NT platforms, you also can tell the compiler to
ignore the paths specified with incl(searchPath, path)
by building with file(ignoreUserIncPaths).
![]()
Incremental C++ Build
C Compilation
Search Paths for Included
Files
![]()
Search Paths for Included
Files
C++ Source Files and Source
Regions
![]()
Add or Change Source
Files
Set Build Options
Build
![]()
Miscellaneous Build Options
![]()
Miscellaneous Build Options
