XL2S Entertainment

Introduction

New in Sjasm 0.42b8
Differences with SjASM version 0.3
Known bugs
To do
The assembling process

Sjasm 0.4 is still not quite finished yet, and neither is this manual. Although Sjasm can do more than described here, everything that is in here should work as advertised.

New in Sjasm 0.42b8

New in Sjasm 0.4 BETA 7

New in Sjasm 0.4 BETA 6

New in Sjasm 0.4 BETA 5

New in Sjasm 0.4 BETA 4

New in Sjasm 0.4 BETA 3

New in Sjasm 0.4 BETA 2

New in Sjasm 0.4 BETA 1

Differences with SjASM version 0.3

Sjasm version 0.4 is largely rewritten, and in some places the syntax and meaning of commands and operators has changed compared to previous versions of Sjasm. Some differences:

You can work your way around some of the differences by writing some macros.

Known bugs

Sjasm is still prototype-experimental-beta-like, so there may be some bugs.

If you encounter a bug, we would like to hear it. Please make sure it is a bug (in Sjasm or in this manual), and give a (small) source example if possible. Use info@xl2s.tk to contact us. Even if the bug you found is listed above, your report may be useful by giving some more information on solving the issue.

To do

In random order:

The assembling process

Sjasm will process your code a couple of times. Conceptually you could say Sjasm uses four passes:

The first pass is the pre-processor pass. The pre-processor does the following in this order:

In the first pass you can only use (or reference) labels that are defined before you use them.

In the second pass Sjasm tries to figure out what values all labels should get, and in which order it should place all the code parts. It is not that difficult to make it impossible for Sjasm to do this, and make Sjasm take literally forever to complete this pass.

When all labels have the right values Sjasm generates the output in the third pass. After that, Sjasm goes over the whole code again to generate the listing file, and to see if it can generate some more error messages.

Copyright 2009 XL2S Entertainment