
                        6502 CROSS ASSEMBLER

     Cross-assemblers aren't cheap, thats why we wrote are own. We have
been using this cross-assembler for 3 years now, in production software projects,
and have not experienced any problems. It pretty fast, too.

     This 6502 cross assembler was written in Turbo Pascal, and is mostly
compatable with the ORCA/M assembler for the Apple. This assembler does not
support macros.


     To invoke enter : 6502asm <file name>
                  or : 6502asm
                       (and you'll be prompted through a series of questions)

     When entering the filename in the command line it must be entered, by
using only the characters to the left of the period. The default extension
is .ASM. Calling 6502asm this way will, generate a .OBJ file, which can then
be burnt into a Prom. It will also generate a listing with all local and
global variables, .LST file.

     When entering simply 6502asm, you'll be promted :

     Enter source file name : (enter a complete filename Ex. TEST.A, TEST.ASM)
     Enter object file name : (enter your output file, Ex. TEST.OBJ, TEST.PRG)
     Enter assembly file name : (enter a listing file, Ex. TEST.LST, TEST.PRN)
     Enter Y to save listing/symbol to disk : (Y saves listing, N does not.)
     Enter Y to display/save symbols : (Y will but symbol table in listing)
     Enter Y to display/save listing : (Y will put assembled code in listing)


     Its faster to assembly, with the listing turned off.


     A program XTRCTSYM.COM is also included, this will strip the symbol
table from a listing, for debugging and such. Invoke by typing :
XTRCTSYM <filename>
File name must be the characters to the left of the period and the defualt
extension is .LST, it creates a file called <file name>.SYM.


     I tried to cover most of the typical assembler directives in the TEST.ASM
files, so take a look at them.

     The maxium size for an object code file is 22.5k.

     Also included is a program called LISTASM.COM, this program will list
your source code, and use the APPEND directive to concat the source to the
printer.

     Also included is a 6502 debugger/prom burner/prom reader, invoke by
entering PROMS <filename>, this filename requires the full name of the
object code file. Enter a ? for help. This debugger tries to mimic the MSDOS
debugger. Some commands aren't implemented, but if interest persist, I will
rectify this problem. The prom burner is compatable with Bay Technical Asso.'s
model 953A Eprom programmer. Again, modifications can be made so you can
burn proms on different hardware, but that takes time and time is money.

    Also included is a utility to burn Eproms of any type, on the PROMAC15.
To invoke enter : PROMAC15.
Enter the object code file without the .OBJ extension.
Enter the start address in the prom to burn in, enter $addr for Hex addresses.
Enter the length of the object code, must be on an even 16 byte boundry.
Enter the Prom type as it would appear on the display of the Promac.


IMPORTANT - This cross-assembler did take a couple of weeks to put together,
            so any of you people, who do use it, and do like it. I would
            sure like a contribution of $5 to $20 bucks, this will ensure my
            continued interest in contributing to public domain software.

            Thanks for your support.


            John J. Haughey
            (71121,2261)
            2306 San Luis St.
            Richmond, Ca. 94804
            (415) 524-2259


            Any questions, (if you gave a minium donation), or comments will
            always be welcomed.
