D - Define Text Macro

This option allows the definition of a symbolic identifier that becomes visible during the assembly of the input file. A single parameter must be specified using one of the following forms:

The Name entry must have the same lexical syntax as a normal assembler Identifier. The Name entry is converted to a Text-EquateName before assembly begins. If no explicit value is specified for the name, then it is assigned the empty string. This is equivalent to specifying the following assembler statement:

    Name EQU <>

If an explicit value is to be assigned, the Name entry must be immediately followed by a colon (:) or equals sign (=) delimiter with no intervening spaces. Blank characters may be specified between the delimiter and the value field. The Value field may contain any text data, but it must be enclosed in double quotes ("") if it contains blanks, tabs, or operating system metacharacters (such as & or |).

Note: If quotes are used to specify a value containing embedded blanks or tabs, then at least one blank is required between the delimiter (colon or equals sign) and the opening quote of the value field. For example:

  -D:NAME= "This string will be correctly interpreted"
  -D:NAME="This will not; no blank after the equals sign"
┌────┬──────┬─────┬────┬──────────────────────────────────────────────────┐
│Type│Global│Group│File│Default                                           │
├────┼──────┼─────┼────┼──────────────────────────────────────────────────┤
│P   │Yes   │Yes  │Yes │(no default value)                                │
└────┴──────┴─────┴────┴──────────────────────────────────────────────────┘


[Back: Base Options]
[Next: I - Specify Include File Search Path]