FILEFIX v6.25 - July 20, 1994
------------------------------

FILEFIX is a utility that converts an executable file output by the ALN
linker (.COF or .ABS files) into separate files containing the raw data for
the TEXT and DATA sections of the program, and a symbol table containing the
symbol information for the program, and an RDBJAG script file for loading it
all into the ALPINE board of a Jaguar Development System.

Some developers have wondered why FILEFIX is needed, since RDBJAG can read
.ABS & .COF files directly.  Perhaps the most important reason is that when
you want to build a Jaguar ROM or EPROM cartridge from your program, you need
access to the raw data that cooresponds to what will become the ROM image of
the cartridge.  FILEFIX makes this very easy and convenient.  FILEFIX also 
creates a symbol file that has been sorted and had duplicates removed.

When you send a program to Atari that may end up becoming a cartridge (like
an early version of a game), please use FILEFIX and send the resulting files
rather than sending an ABS file (or in addition to sending an ABS file).


July 20, 1994
-------------
FILEFIX still does not output a .SYM symbol file when the source file is a
COFF-format executable, but this new version now adds a command to the output
script file to make the debugger load symbols from the original executable
file. This does not provide everything the separate .SYM file does, but it
should cover most situations. (The difference is that the symbol table in a
.SYM file is sorted and has had duplicate symbols deleted.)

Also, there was a bug in the PC version of FILEFIX which caused RDBJAG/WDB to
print an error message when you did a GETSYM command on one of the .SYM files
it created.  (The error message would be either "Out of Memory" or "This file
was created by a buggy version of FILEFIX".)  This has been fixed.


June 28, 1994
-------------
There was a bug fixed that would cause FILEFIX to create DTA and TXT files
that were zero bytes long if the data section and/or text section was empty,
rather than simply not creating the files in the first place.  As of this
version, when a section is empty the files are not created and the references
to them are left out of the debugger script file that is output.

The tools now use a default filename extension of .COF for BSD/COFF format
executables, and FILEFIX has been updated to support this.  Now FILEFIX will
first look for the filename exactly as specified on the commandline.  If that
file is not found, and no extension was specified, then it will try for
<filename>.COF and <filename>.ABS in that order.  If the filename specified
did have an extension, then an error message is displayed and the program
aborts with an error code.


May 13, 1994
------------                                                                           								
The FILEFIX utility has been updated to work with the new BSD/COFF file
format used by GCC, MADMAC, and ALN.  Please Note: when reading BSD/COFF
files, FILEFIX will not output a symbol file, and the RDBJAG script file it
outputs will not reference the symbol file.
