FILEFIX v6.50 - Sept. 29, 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.

FILEFIX also has an option for writing out ROM image files.  These files
are 2mb or 4mb in length and consist of the program's text segment and
data segment, with the rest of the file set to zero bytes.  There are
also some other new options.  See the information below.


Usage:
------
filefix [options] <filename>

<filename> =	A DRI or BSD/COFF format absolute-position executable file.
		A filename extension of .COF or .ABS is assumed if none is given.
		(i.e. "FILEFIX testprog\" will look for <testprog>, then
		<testprog.cof>, then <testprog.abs>, before giving up.

Options
-------

-q = Quiet mode, don't print information about executable file.

-r <romfile> = Create ROM image file named <romfile> from executable

-rs <romfile> = Same as -r, except also create DB script to load and run file.

-p = Pad ROM file with zero bytes to next 2mb boundary.
     (this must be used along with the -r or -rs switch)

-p4 = Same as -p, except pads to a 4mb boundary
      (this must be used along with the -r or -rs switch)


Examples:
---------
	filefix program

This example finds 'program', 'program.cof', or 'program.abs'
Creates program.txt, program.dta, program.db, and program.sym (if the
file is not a COFF-format file)

	filefix program.abs

Finds program.abs, creates same files as previous example.

	filefix -rs program.rom -p -q program

Finds 'program', 'program.cof', or 'program.abs.  Creates a ROM
image file named PROGRAM.ROM, pads the size to 2mb boundary, and
prints only minimal information to screen.




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).


CHANGES
-------

Sept. 29, 1994
--------------
Filefix now supports a number of new command line options, primarily related
to the new capability of writing out ROM image files.  See the list of
command line switches for more information.



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.
