
               GCC5616 -- GCC Compiler for the DSP5616 series
                              Version 0.2

This file describes compilation and installation instructions for GCC5616.
If you've successfully compiled GCC 1.40 on your machine before, you should
have no trouble with GCC5616.  I use a PC/386 running SysV 3.2.2 UNIX.  No
other platforms have been tested (but I would appreciate reports of
successful compiles on other platforms).

--- Compilation and Installation Steps

1) After un-sharing all these files, copy the following files to the
'config' directory (which resides in your main GCC source directory):
              tm-dsp5616.h
              out-dsp5616.h
              dsp5616.md

2) Copy the file 'gcc56.patch' to the main GCC source directory and apply
the patch as follows:
                    patch -p0 < gcc56.patch

***NOTE*** The name 'patch' is a misnomer.  The 'gcc56.patch' file
*MODIFIES* GCC, it does not just fix bugs (as the name 'patch' implies).
If you wish to use the same directory to generate GCC for another target,
you *must* restore the sources modified by the patch.  The patches are
suitable for building GCC5616 only.

3) Change the Makefile to suit your tastes. I recommend using GCC to
compile GCC5616 (if you've gotten GCC working) but I don't think I've
written any code that can't be compiled with a regular C compiler.

4) Optionally, type 'make realclean' to remove all files generated from
other files.  I found this step necessary because the pre-BISONed files
shipped with the distribution did not work on my machine.  Once I ran their
sources through BISON, everything worked fine.

5) Type:
                'sh config.gcc -host=YOURHOST dsp5616'

where 'YOURHOST' is the machine name of the computer that will be compiling
GCC5616 (i.e., the machine you're probably staring at now).  The 'YOURHOST'
name is simply the name of a machine in a 'xm-???.h' file in the config
directory.  For example, when I compile I type:

                'sh config.gcc -host=i386v dsp5616'

Ensure that all links are set up correctly.

6) Type 'make' and hope for the best.

7) To install the files in your chosen target directories, type 'make
install'.  By default, the top-level executable will be named 'gcc5616' and
installed in /usr/local/bin.  The sub-programs will be named 'gcc5616-cpp'
(the preprocessor) and 'gcc5616-cc1' (the compiler proper) and installed in
/usr/local/lib.  Since the directories are hard-coded into the sources, I
suggest you choose suitable ones before you start compiling.



