5.3 Preprocessor

The preprocessor statements are a GNU extension to the Sieve language. The syntax for a preprocessor statement is similar to that used in C programming language, i.e.: a pound character (`#') followed by a preprocessor directive and its arguments. Any amount of whitespace can be inserted between the `#' and the directive. Currently implemented directives are include and searchpath.

Sieve #include directive		Include the contents of a file.
Sieve #searchpath directive		Modify the current search path.

Sieve #include directive

The #include directive reads in the contents of the given file. The contents is "inserted" into the text being parsed starting at the line where the directive appears. The directive takes two forms:

#include "filename"

The filename is taken relative to the current directory.

#include <filename>"

The filename is searched in the list of include directories as specified by the `-I' command line options.

If filename starts with a directory separator character (`/') both forms have the same effect.

Sieve #searchpath directive

The #searchpath directive adds its argument to the list of directories searched for loadable modules. It has the same effect as `-L' command line switch used by GNU sieve utility (see section 3.1.9 Sieve Specific Options).