| include-directive: | (include | +) < <filename> > |
| (include | +) <expr> |
Includes the preprocessor output of the specified file. If a Unicode file is used, it must be UTF-8 (with or without a BOM) encoded.
If the filename is enclosed in angle brackets, ISPP searches for it on the current include path, set via pragma, then on the path specified by the INCLUDE environment variable. By default, the include path is the compiler directory.
If the filename is an expression, such as a filename enclosed in quotes, ISPP first searches for it in the directory where the current file resides, then in the directory where the file that included the current file resides, and so on, then in the directory specified by SourcePath. If the file isn't found, ISPP searches the same two paths as for angle brackets, and finally the compiler directory.
If the filename starts with .\ or ..\, it's relative to the directory where the current file resides. If it starts with compiler:, it's relative to the compiler directory. If it starts with userdocs:, it's relative to the My Documents folder of the currently logged-in user. In these cases, ISPP doesn't search other directories.
This directive can't be used inline.
#include
<file.iss>
#include
"c:\dir\file.iss"
#include
AddBackslash(CompilerPath) + "common.iss"