include Configuration File Directive

The include directive processes text from another file in place of the include directive. This directive is often used as a subdirective of the if directive so that blocks of directives that apply only in some circumstances can be stored in a separate file.

This diagram shows the syntax of the include directive:

The include directive has the following parameter:

filename
This parameter must be a string literal, and must include the extension as well as the root file name. It can specify an absolute path or a path relative to the directory of the file containing the include directive.

The named file must contain complete directives. The contents of the included file must conform to configuration file syntax even if the include directive is in a directive block that is not processed during the build.

A build can proceed if a file named an include directive is not available, provided the include directive is not acted upon. For example, if the include directive is skipped because of conditional processing in your configuration file it does not matter whether the included file exists. An error is reported only when the build process tries to include a file that cannot be found or is not readable.



Configuration Files
How Configuration Files Are Processed


Change a Build Setup
Build


Configuration File Directives
Build Options