f-cpu/COMPILE.txt
created Tue Aug 28 08:26:04 2001 by whygee@f-cpu.org

Thanks for reading this file which explains how compile the
different parts of this source tree. If you have a "source only"
version of this F-CPU package, you will remark that some steps are
required to obtain a working source tree. You can probably find
already pre-processed source files but their modification will
require the modification of the original (before preprocessing)
files.


Basically, you need the following GNU tools :
 - a good un*x shell (bash is fine)
 - m4 (without whom we can't configure anything)
 - a text editor of your choice (sorry, no time to start loosy flamewars :-D)
 - make
 - gcc (for the C stuff)
and a VHDL tool that you can access (see the VHDL-HOWTO in the f-cpu/vhdl
directory for more explanations).

First, you have to go to f-cpu/configuration and run "make" :
this command will create/update a lot of files which depend
on user settings in different langages. This operation was first
performed by a script (f-cpu/configure.sh) but it is now only a
wrapper for the make utility. However this name was chosen on purpose
because "configure" is usually executed before "make" in most GNU packages.

Only after this step is performed, you can start to look around.
Please look at the f-cpu/configuration directory for more information
about the configuration stage. It is also where the "original" files
(suffixed with ".in") are stored.

Then, you can start to compile the tools and the VHDL packages.
A shell script (suffixed with ".bat" for DOS or ".sh" for un*x)
or a Makefile is provided in each subdirectory. Concerning the
VHDL part, read the HOWTO.

Have fun,
YG
