BUILD = expression
The BUILD option specifies which topics containing build tags are included in a build. The BUILD option does not apply to topics that do not contain build tags.
A topic contains a build tag if it contains a build-tag \footnote statement. Topics without build tags are always compiled, regardless of the current build expression.
expression
Specifies the build expression. This parameter consists of a combination of build tags (specified in the [BUILDTAGS] section) and the following operators:
Operator | Description |
~ | Applies the NOT operator to a single tag. The Help compiler compiles a topic only if the tag is not present. This operator has the highest precedence; the compiler applies it before any other operator. |
& | Combines two tags by using the AND operator. The Help compiler compiles a topic only if it contains both tags. The compiler applies this operator only after the ~ operator has been applied. |
| | Combines two tags by using the OR operator. The Help compiler compiles a topic if it has at least one tag. This operator has the lowest precedence; the compiler applies it only after all other operators have been applied. |
Parentheses may be used to override operator precedence. Expressions enclosed in parentheses are always evaluated first.
Only one BUILD option can be given per project file.
The Help compiler evaluates all build expressions from left to right, using the specified precedence rules.
The following examples assume that the [BUILDTAGS] section in the project file defines the build tags DEMO, MASTER, and TEST_BUILD. Although the following examples show several BUILD options on consecutive lines, only one BUILD option per project file is allowed.
BUILD = DEMO ; compile topics that have the DEMO tag
BUILD = DEMO & MASTER ; compile topics with both DEMO and MASTER
BUILD = DEMO | MASTER ; compile topics with either DEMO or MASTER
BUILD = ~DEMO ; compile topics that do not have DEMO
BUILD = (DEMO | MASTER) & TEST_BUILD
; compile topics that have TEST_BUILD and
; either DEMO or MASTER
[BUILDTAGS], [OPTIONS]