III.8.2 General Controls

$COND	List full IFxx .. ELSEIFxx .. ELSE .. ENDIF constructions. (Default!) The Control is overridden by $NOLIST.
$NOCOND	Don't list lines in false IFxx .. ELSEIFxx .. ELSE .. ENDIF branches. The Control is overridden by $NOLIST.
$CONDONLY	List lines in true IFxx .. ELSEIFxx .. ELSE .. ENDIF branches only, without the IFxx, ELSEIFxx, ELSE and ENDIF statements itself. The Control is overridden by $NOLIST.
$EJECT	Starts a new page in the list file. The control has no effect, when the $NOPAGING control has been specified.
$ERROR (string)	Forces an assembly error with a user-defined error message. This is intended to support configuration management and can be applied sensefully with conditional assembly only.
$WARNING (string)	Outputs a user-defined warning message to the console, and increments the warning count. This is also intended to ease configuration management.
$GEN	List macro calls and expanded macros. (Default!) The listing fully shows the nesting of macro calls. The Control is overridden by $NOLIST.
$NOGEN	List macro calls only. The expanded macros are not listed. The Control is overridden by $NOLIST.
$GENONLY	List the expanded macro bodies only. Macro calls and EXITM statements are not listed. The Control is overridden by $NOLIST.
$INCLUDE (file)	Includes an external source file into the assembler program just behind the $INCLUDE statement. If the include file has not been specified with an absolute path, and it cannot be found in the default directory, the path specified with the /INCLUDES (Linux: -i) command line option (if present) is searched from left to right, and if it cannot be found there either, the path specified with the environment variable ASEM51INC (if defined) is searched from left to right as well. Include files may be nested to any depth.
$LIST	List source code lines. (Default!)
$NOLIST	Do not list source code lines, provided they do not contain errors, until the next $LIST statement occurs.
$SAVE	Saves the current $LIST/$GEN/$COND state on a $SAVE-stack. $SAVE statements can be nested to any depth.
$RESTORE	Restores a previously saved $LIST/$GEN/$COND state.
$TITLE (string)	Inserts a title string into the list file page header. Titles may be truncated according to the specified (or default) page width. Default: ASEM-51 copyright information. The control has no effect, when the $NOPAGING control has been specified.

Examples:

  $NOLIST                ;switch off listing
  $INCLUDE (8052.MCU)    ;include 8052 SFR symbol definition file
  $LIST                  ;switch on listing
  $TITLE (Computer-Controlled Combustion Unit for Motorcycles)
  $EJ                    ;new page with new title
  $ERROR(invalid configuration: buffer size > external RAM size)
  $WARNING(int. RAM doesn't meet minimum stack size requirements)
  $SAVE GENONLY CONDONLY ;save old $LIST/$GEN/$COND status, and list
                         ;only source lines that are really assembled
  $RESTORE               ;restore previous listing mode