Directives

NMAKE32 provides directives that:
Conditionally execute commands
Display error messages
Include the contents of other files
Turn some NMAKE32 options on or off
Each of these directives controls description file processing, rather than target processing. Read-time directives should begin with an exclamation point (!) and must start in column one. Run-time directives must be preceded by one or more spaces and must start with a percent sign (%). Spaces may exist between the conditional character and the rest of the line. For example, "! if expression" is the same as "!if expression".
The list below describes the directives:
Note: This table shows directives defined using an exclamation point.
кФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФТФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФПГDirective syntax              ГUsage                         Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г!if expression                ГProcesses the statements      Г
Г                              Гbetween the !if keyword and   Г
Г                              Гthe next !else, !elif, or     Г
Г                              Г!endif directive if expressionГ
Г                              Гevaluates to a non-zero value Г
Г                              Г(TRUE). Otherwise, the lines  Г
Г                              Гare ignored.                  Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г!else                         ГProcesses the statements      Г
Г                              Гbetween the !else and the     Г
Г                              Г!elif or !endif directive if  Г
Г                              Гthe preceeding !if, !elif,    Г
Г                              Г!ifdef, or !ifndef expression Г
Г                              Гevaluated to zero (FALSE).    Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г!elif expression              ГIs identical to !else         Г
Г                              Гprocessing except that the    Г
Г                              Гlines which follow are        Г
Г                              Гprocessed only if the new     Г
Г                              Гexpression evaluates to a     Г
Г                              Гnon-zero value.               Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г !elseif expression           ГIs a synonym for !elif        Г
Г                              Гexpression.                   Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г!endif                        ГMarks the end of a !if,       Г
Г                              Г!ifdef, or !ifndef block of   Г
Г                              Гstatements.                   Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г!foreach var [in] word_list   ГProcesses all statements up   Г
Г                              Гthrough the ending !endfor    Г
Г                              Гonce for each word in         Г
Г                              Гword_list. During each        Г
Г                              Гiteration the variable var    Г
Г                              Гwill be set to the            Г
Г                              Гcorresponding word from the   Г
Г                              Гlist. This macro can be       Г
Г                              Гreferenced as any other macro Г
Г                              Гwould be referenced, via      Г
Г                              Г$(var). After all iterations  Г
Г                              Гare complete, the macro will  Г
Г                              Гretain the last value.        Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г!endfor                       ГMarks the end of a !foreach   Г
Г                              Гblock of statements.          Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г!ifdef macro                  ГIs identical to !if           Г
Г                              Гprocessing, except that the   Г
Г                              Гstatements which follow are   Г
Г                              Гprocessed only if the macro   Г
Г                              Гvariable is currently defined.Г
Г                              ГNote that variables defined toГ
Г                              Гbe the null string are still  Г
Г                              Гconsidered to be defined for  Г
Г                              Г!ifdef processing. For        Г
Г                              Гcompatibility with previous   Г
Г                              Гversions of MAKE, the form    Г
Г                              Г!ifdef $(macro) is still      Г
Г                              Гsupported.                    Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г!ifndef macro                 ГIs identical to !ifdef        Г
Г                              Гprocessing, except that the   Г
Г                              Гlines which follow are        Г
Г                              Гprocessed only if the macro   Г
Г                              Гvariable is not currently     Г
Г                              Гdefined. Note that variables  Г
Г                              Гdefined to be the null string Г
Г                              Гare still considered to be    Г
Г                              Гdefined for !ifndef           Г
Г                              Гprocessing.                   Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г!undef macro                  ГUndefines a previously definedГ
Г                              Гmacro. Subsequent references  Г
Г                              Гto $(macro) will return an    Г
Г                              Гempty string, and !ifdef macroГ
Г                              Гwill evaluate to zero.        Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г!error text                   ГPrints out text (macros are   Г
Г                              Гexpanded) and then immediatelyГ
Г                              Гterminates NMAKE32 with a     Г
Г                              Гreturn code of 1.             Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г!include [<filename>]         ГReads and evaluates the file  Г
Г                              Гfilename before continuing    Г
Г                              Гwith the current description  Г
Г                              Гfile. If filename is enclosed Г
Г                              Гby angle brackets (<>),       Г
Г                              ГNMAKE32 searches for the file Г
Г                              Гin the directories specified  Г
Г                              Гby the INCLUDE macro;         Г
Г                              Гotherwise, it looks only in   Г
Г                              Гthe directory specified. The  Г
Г                              ГINCLUDE macro is initially setГ
Г                              Гto the value of the INCLUDE   Г
Г                              Гenvironment variable.         Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г!tryinclude [<filename>]      ГSimilar to !include, except ifГ
Г                              Гthe file does not exist,      Г
Г                              ГNMAKE32 will ignore the error Г
Г                              Гand continue.                 Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г!cmdswitches {+|-}<opt>       ГTurns on or off one of four   Г
Г                              ГNMAKE32 options: /D, /I, /N,  Г
Г                              Гand /S. If no options are     Г
Г                              Гspecified, the options are    Г
Г                              Гreset to the values they had  Г
Г                              Гwhen NMAKE32 was started. To  Г
Г                              Гturn an option on, precede it Г
Г                              Гwith a plus sign (+); to turn Г
Г                              Гit off precede it with a minusГ
Г                              Гsign (-). This directive      Г
Г                              Гupdates the MAKEFLAGS macro.  Г
РФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФСФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФй
[Back] [Next]