| Files

Previous | The A68k Assembler | Next

`A68k` uses the following files:

- The source code file - this file contains the program to be assembled. This file is an ASCII text file whose last line must be an `END` statement.

  (TIGCC) | This `END` statement is no longer necessary starting from v.2.71.F3c. Moreover, the assembler will no longer accept an `END` statement in include files or macros, since it did never expect that and caused bugs.

- The object code file - this file is created by `A68k`, replacing any previous version which may exist. If any errors are encountered during the assembly, this file will be scratched, unless the '-k' (keep) switch is specified (see below). Although this file is normally written in AmigaDOS format, the '-s' switch (see below) will cause it to be written in Motorola S-record format instead.
- The listing file - this file is optionally created by `A68k` and contains a listing complete with page headings (including form feeds), generated object code, and error messages if any. It is suitable for feeding to a printer.
- An equate file - this file is optionally created by `A68k` and consists of a leading comment line followed by `EQU` statements, one for each symbol encountered by `A68k` whose value is absolute. This file is only created if the '-e' command-line switch is specified (see below).
- A header file - if requested, this file is read by `A68k` immediately prior to the source code file. It treated exactly as if it were requested by an `INCLUDE` statement at the front of the source file, but is selected only if the '-h' command-line switch is specified (see below).
- Include files are selected by `INCLUDE` directives within the source file, and are inserted in the source code in place of the `INCLUDE` directive itself. `A68k` first searches the current directory for `INCLUDE` files; the '-i' command-line switch (see below) specifies additional directories which can be searched.