I

Specifies an additional directory for the include path.

IDE Equivalent

Windows: General > Additional Include Directories (/include)

Preprocessor > Additional Include Directories (/include)

Linux: None

Mac OS X: Preprocessor > Additional Include Directories (/include)

Architectures

IA-32, Intel® 64, IA-64 architectures

Syntax

Linux and Mac OS X:

-Idir

Windows:

/Idir

Arguments

dir

Is the directory to add to the include path.

Default

OFF

The default include path is used.

Description

This option specifies an additional directory for the include path, which is searched for module files referenced in USE statements and include files referenced in INCLUDE statements. To specify multiple directories on the command line, repeat the option for each directory you want to add.

For all USE statements and for those INCLUDE statements whose file name does not begin with a device or directory name, the directories are searched in this order:


  1. The directory containing the first source file.

    Note that if assume nosource_include is specified, this directory will not be searched.

  2. The current working directory where the compilation is taking place (if different from the above directory).

  3. Any directory or directories specified using the I option. If multiple directories are specified, they are searched in the order specified on the command line, from left to right.

  4. On Linux and Mac OS X systems, any directories indicated using environment variable FPATH. On Windows systems, any directories indicated using environment variable INCLUDE.

This option affects fpp preprocessor behavior and the USE statement.

Alternate Options

Linux and Mac OS X: None

Windows: /include

See Also