gpfce patch part3
[fceu.git] / Documentation / README
1 FCE Ultra was developed with gcc and GNU make in mind.  MSVC will probably
2 compile the Windows source code with a few modifications, but you'll still 
3 need to make a project file.
4
5 Several pre-made makefiles are provided:
6         Makefile.beos           - BeOS(with SDL and SDL_net)
7         Makefile.unixsdl        - UN*X(FreeBSD/Linux/etc, with SDL)
8         Makefile.linuxvga       - Linux(with svgalib)
9         Makefile.dos            - (MS/PC/DR) DOS
10         Makefile.win            - MS Windows 9x/Me/Xp/2000/etc.(with DirectX).
11
12 If you want to use Makefile.beos or Makefile.unixsdl for a cpu type other
13 than 80x86, you will need to remove "-DC80x86" from the defines line
14 and also remove "-DLSB_FIRST" if your target cpu uses MSB first ordering.
15 You'll also need to remove/change "-mcpu=xxx".
16
17 For the Windows port, I use MINGW32.  http://www.mingw.org
18
19 To compile the DOS port, you'll need to download the DJGPP package.
20 Any version of gcc >=2.95.3 should compile the code without changes, BUT
21 the DJGPP versions of gcc have some problems:
22   gcc 2.95.3 sometimes breaks when compiling the code.  gcc 3.0.2 seems to 
23   produce bad code for sound.c.  So, I recommend using gcc 3.0.4 for
24   compiling the DOS version.
25
26 Modifying the "-mcpu=i686" string in the makefiles, to optimize more effectively
27 for your cpu type, is a good idea.
28
29 Always do a "make -f Makefile.<platform> clean" before compiling for a 
30 different platform or if you update via cvs and if you have stale object 
31 files lying around.