Vsys/Atari/ASM

`Vsys/Atari/ASM/`

Manual


`../doc/AAmanual.e`

Source

The Ann Arbor Macro Assembler (AAma) needs relatively few IO functions and does not use the standard IO modules. IO code for the various systems is contained in Vmain.a.


`Vmain.a`			Main program. Initial comments summarize calling sequence options.
`Vassm.a`			Block assembler.
`Ctable.a`
`Instr.a`
`Emul.a`			Floating point emulation.
`Finals.a`
`Backw.a`			Disassembler.
`Amacro.e`			Storage and machine parameter includes.
`Aobject.e`			Included by `Backw.a`.

Command Files

These scripts build the assembler with an extra 100 in the machine option, for making a special assembler (one that assembles the assembler). Namely, k=111 for the Atari, k=113 for the Amiga, k=114 for the Macintosh. and k=115 for the NeXT. See the comments in Amacro.e about MACHINE=.Key. The scripts include the optional software floating point emulation module Emul.a, which implements the assembler .EMUL directive for systems without hardware floating point. The cross-built AAma executables should be functionally equivalent, if not identical, to the corresponding native-built versions.


`AA11.s`			`AAma.ttp` executable for the Atari.
`AA13c.s`			`AAma13c` executable for the Amiga.
`AA14c.s`			`AAma14c` executable for the Macintosh.
`AA15c.s`			`AAma15c` executable for the NeXT.

Examples

The following short examples illustrate some basic AAma features and concepts. See the comments in the .a source files for more explanation. The accompanying .s command files build only Amiga executables (no cross building). They are much the same up to file names, but with a twist in Argu.s.


`hello.a` `hello.s`			Command line standard IO, basic pseudo's, subroutine and startup stack arguments, argument addresses, etc.
`hello1.a` `hello1.s`			A version of `hello.a` that loads `IOst.a` and explicitly jumps to its entry code.
`hello2.a` `hello2.s`			A version of `hello.a` whose executable is position independent when linked with `IOst.a`.
`hello3.a` `hello3.s`			Another version of `hello.a` which is position independent in the same sense as `hello2.a.`
`Argu.a` `Argu.s`			Display command line arguments, accessed by direct manipulation of the stack instead of through formal subroutine arguments as in `hello.a`.

Notes


`asm_var.e`			Assembler variables.
`Notes.e`			Miscellaneous.

Up to Vsys/