A09

============================== F E A T U R E S ==============================

A09 - 6800/6801/6809/6301/6309 Assembler

Based on Lennart Benschop's C core that can be found somewhere on  the 'net
(last address known was http://koti.mbnet.fi/~atjs/mc6809/Assembler/A09.c),
Herman built a complete Macro Assembler that is  functionally  better  than
the TSC Flex9 Assembler (no wonder, Herman got multimegabytes to play with,
whereas this excellent piece of software works within 50K or so!).

It can deliver binary, Intel Hex, Motorola S1, and Flex9 binary output files,
plus Flex9 RELASMB-compatible relocatable object modules.

Herman taylored the original to itself taste by working through the source
code; since A09 has reached a level of complexity that doesn't really lend
itself to following the "Use the Source, Luke!" principle if you just want
to hack a little 6809 assembly program, Herman added this documentation.

Have fun!

============================ R E Q U I R E M E N T ==========================

A09 tested and worked fine on the following configurations:

- AmigaOS 3.9               (Kickstart 40.68, Workbench 45.1)
- AmigaOS 4.1 Final Edition (Kickstart 53.70, Workbench 53.14)
- IcarOS i386               (Kickstart 51.51, Workbench 40.0, AROS ABIv0)
- AROS One i386             (Kickstart 51.51, Workbench 40.0, AROS ABIv0)

================================= U S A G E =================================

a09 [-{b|r|s|x|f}[file]]|[-c] [-l[file]] [-ooption]* [-dsym=value]* srcfile*

-c
    suppresses code output (corresponds to ASMB's B command line option)

-bfile (default output mode)
    create a binary output file
    if no file name is given, the extension .bin is used (.b on Unix)

-rfile
    create a Flex9 RELASMB-compatible output file name
    if no file name is given, the extension .rel is used

-sfile
    create a Motorola S-record output file name
    if no file name is given, the extension .s09 is used

-xfile
    create an Intel hex output file name
    if no file name is given, the extension .hex is used

-ffile
    create Flex9 ASMB-compatible output file
    if no file name is given, the extension .bin is used

-lfile
    create a list file (default no listing)
    if no file name is given, the extension .lst is used

-dsym[=value]
    define a symbol (see TEXT directive below)
    (roughly corresponds to ASMB's command line parameters 1-3)

-oopt
    defines an option (see Docs)

srcfile
    the assembler source file(s) to be processed.
    At least one source file must be given; the first one also
    defines the default output and listing file names.

============================= C H A N G E L O G =============================

New for version 1.45:
 
Macros can override mnemonics now; a  before the mnemonic
prohibits macro invocation and uses the original mnemonic.

TEXT pseudo-op interpreted trailing blanks wrong.
TEXT and macro parameter expansion does NOT include leading
and trailing string delimiters in the output any more;

This is RELASMB-compatible and allows more constructs.
As an indirect consequence, "&gotcha" now REPLACES &text
with the contents of a text named gotcha;
If you want the verbatim output, you need to write it as "&gotcha".
bitdirect() and the ~ operator on constants didn't work correctly;

Thanks to Ray Bellis for pointing that out.
See https://github.com/Arakula/A09/issues/9 for details.

================================ S O U R C E ================================

Based on aminet version source
https://github.com/Arakula/A09

This is based on the source code of the original version  A09 V1.45 Assembler
which was written back in 2020 by the talented programmer Hermann Seib.

        ______ ______              ______ ______ 
 ______|:: .__|:: .__|_____ ______|:: ___|:: ___|______ _____ 
|: ,   |:  |  |:  |  |:  ,_|:  ,__|:___  |:___  |:  -  |:  ,_|
|__|___|______|______|___|   _____|______|______|______|___|

                home cross-compilation factory