--------------------------------------------------------------------------
This is the README file for the package 'xa', written by A.Fachat. 

The package 'xa' is provided 'as is', no warranty will be taken
for any damage caused by it or by any use of it.

The package contains the source code for the Cross assembler 'xa', several
utilities in the 'misc' subdirectory, as well as example programs and
the rest of this directory tree. As of release 2.1.4f a gcc-go32 DOS
cross-compiling make option is included.

The current version for 'xa' is 2.1.4f, as of 03mar1998

The whole package is placed under the GNU Public License, for further
information on redistribution see the included file "COPYING".
--------------------------------------------------------------------------

XA is a 6502 cross compiler:

 - under GNU public license

 - can produce _relocatable_ binaries

 - The full fileformat description and 6502 file loader included.

 - also included relocation and info utilites, as well as linker

 - for any ANSI-C compliant computer (only utilities need 'stat' call 
   for file size). 

 - fast by hashtables

 - Rockwell CMOS opcodes

 - running under DOS and any ANSI C system (Unix, Amiga, Atari ST)

I developed this cross assembler for the 6502 CPU family quite some time
ago on my Atari ST. The assembler has successfully been ported to Amiga 
and Unix computer (ported? just compiled... :-) 
Lately I came across the problem to need relocatable 6502 binary files, so
I revised the assembler from version 2.0.7 to 2.1.0, adding a (admittedly
proprietary) 6502 relocatable binary format. But there are not many other
formats around and they didn't fit my needs. I have developed this format 
myself and it is under the GNU public license.
With version 2.1.1 the 'official' version of the fileformat is supported.

To compile it, just type "make" (if you have the GNU gcc. If not, edit the 
Makefile for the compiler options). This produces "xa", the cross
assembler;
"uncpk", a small packing utility (where the C64 counterpart is in the
examples subdirectory), "printcbm", that lists C64 BASIC files and
'file65' that prints some information about o65 files.  The "loader" in
the loader subdirectory is a basic 6502 implementation of a relocating
binary loader.
"file65" prints file information on 'o65' relocatable files. "reloc65"
can relocate 'o65' files.

If you want to use it under DOS, you have to have the GO32 DOS
crosscompiling
tools to compile. Then just type "make dos" and you'll end up with the
appropriate DOS binaries. This has been tested only under i386 Linux,
however. 
Another archive with the DOS binaries included is provided.

One problem on the Atari was it's broken "malloc". Therefore I used to
alloc everything in one chunk and divide the memory by hand. So everything
was kind of statically allocated. This is almost gone now. Only the
temporary storage between pass1 and pass2 and the preprocessor are still
allocated in one chunk (size definitions in xah.h). The rest is allocated
as needed.

The docs are in the 'doc' subdir. There also is a description of the
6502 relocatable binary format. If you think some things could be 
expressed in a better way, feel free and mail me to improve my english ;-)

For further information:

         Andre Fachat
         email: a.fachatphysik.tu-chemnitz.de

 PERMSSN    UID  GID    PACKED    SIZE  RATIO     CRC       STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[generic]                 8596   24424  35.2% -lh5- 15d5 Jan 26  1998 xa-2.1.4f/docs/fileformat.txt
[generic]                 5760   14073  40.9% -lh5- d792 May  9  2003 xa-2.1.4f/docs/xa.txt
[generic]                 1230    9719  12.7% -lh5- c7a9 Apr 20  1998 xa-2.1.4f/misc/errs
[generic]                10048   16396  61.3% -lh5- 3108 Apr 20  1998 xa-2.1.4f/misc/file65
[generic]                 2727    7461  36.6% -lh5- a712 Dec 12  1998 xa-2.1.4f/misc/file65.c
[generic]                11276   18556  60.8% -lh5- 0fff Apr 20  1998 xa-2.1.4f/misc/ld65
[generic]                 4689   15224  30.8% -lh5- 60f1 Apr 16  1997 xa-2.1.4f/misc/ld65.c
[generic]                   93     109  85.3% -lh5- 672d Jan  4  1997 xa-2.1.4f/misc/lt1.a
[generic]                   43      43 100.0% -lh0- 84a0 Jan  4  1997 xa-2.1.4f/misc/lt2.a
[generic]                  288     752  38.3% -lh5- 3265 Mar  3  1998 xa-2.1.4f/misc/Makefile
[generic]                 1065    1978  53.8% -lh5- 9ed8 Jan  3  1997 xa-2.1.4f/misc/mkrom.sh
[generic]                 7467   11660  64.0% -lh5- ebb9 Apr 20  1998 xa-2.1.4f/misc/printcbm
[generic]                 1061    2056  51.6% -lh5- 0e45 Jan  3  1997 xa-2.1.4f/misc/printcbm.c
[generic]                10270   16720  61.4% -lh5- 01d4 Apr 20  1998 xa-2.1.4f/misc/reloc65
[generic]                 2976    8737  34.1% -lh5- efa1 Apr 16  1997 xa-2.1.4f/misc/reloc65.c
[generic]                   89     137  65.0% -lh5- f1be Apr 20  1998 xa-2.1.4f/misc/SCOPTIONS
[generic]                  204     498  41.0% -lh5- f3dc Apr 20  1998 xa-2.1.4f/misc/smakefile
[generic]                 7511   11768  63.8% -lh5- 0070 Apr 20  1998 xa-2.1.4f/misc/uncpk
[generic]                 1623    3980  40.8% -lh5- 85a6 Jan  3  1997 xa-2.1.4f/misc/uncpk.c
[generic]                 1161    8075  14.4% -lh5- a9e8 Apr 20  1998 xa-2.1.4f/src/errs
[generic]                   89     137  65.0% -lh5- f1be Apr 20  1998 xa-2.1.4f/src/SCOPTIONS
[generic]                  155     227  68.3% -lh5- 3668 Apr 20  1998 xa-2.1.4f/src/smakefile
[generic]                29090   55928  52.0% -lh5- 08de Apr 20  1998 xa-2.1.4f/src/xa
[generic]                 6673   21796  30.6% -lh5- bce5 Apr 20  1998 xa-2.1.4f/src/xa.c
[generic]                 1703    3639  46.8% -lh5- 37ec May 19  2003 xa.readme
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total        25 files  115887  254093  45.6%            May 21  2003