C166/ST10 Cross-Assembler, Linker/Locator, Utilities ... - Tasking

• • • • • • • •
Assembler Controls 6−3
6.1 INTRODUCTION
Assembler controls are provided to alter the default behavior of the
assembler. They can be specified on the command line or on control lines,
embedded in the source file. A control line is a line with a dollar sign ($)
on the first position. Such a line is not processed like a normal assembly
source line, but as an assembler control line. Only one control per source
line is allowed. An assembler control line may contain comments.
The controls are classified as: primary or general.
Primary controls affect the overall behavior of the assembler and remain
in effect throughout the assembly. For this reason, primary controls
may only be used on the invocation line or at the beginning of a
source file, before the assembly starts. If you specify a primary control
more than once, a warning message is given and the last definition is
used. This enables you to override primary controls via the invocation
line.
General controls are used to control the assembler during assembly.
Control lines containing general controls may appear anywhere in a
source file and are also allowed in the invocation. When you specify
general controls via the invocation line the corresponding general
controls in the source file are ignored.
The controls GEN, NOGEN, GENONLY and INCLUDE are implemented in
the macro preprocessor. If one of these controls is encountered, the
assembler generates a warning.
The examples in this chapter are given for a PC environment.
An overview of all assembler controls is listed in the next section.