diff options
Diffstat (limited to 'BUILDING.txt')
| -rw-r--r-- | BUILDING.txt | 31 |
1 files changed, 17 insertions, 14 deletions
diff --git a/BUILDING.txt b/BUILDING.txt index 3a7adf5..4e2a4df 100644 --- a/BUILDING.txt +++ b/BUILDING.txt @@ -1,20 +1,21 @@ Build Requirements for Atari 8-bit Taipan: +- cc65. At least version 2.15. 2.13.x and 2.14 are specifically known + not to work. To build the regular executable (taipan.xex), you can + use any version from 2.15 to 2.19 (latest as of this writing). If + you're still using cc65-2.14, it's about 8 years old, isn't it time + to upgrade? + - make. I've used GNU make 3.82 and 4.1. I also occasionally test with an old version of BSD make, but not often. If you can't get BSD make to work for you, install gmake from ports/pkgsrc or whatever your platform uses. -- cc65. At least version 2.15. 2.13.x and 2.14 are specifically known - not to work. To build the regular executable (taipan.xex), you can - use any version from 2.15 to 2.19 (latest as of this writing). To - build the cartridge image, you specifically need cc65 2.15 (newer - versions won't do, until I fix it). - -- gcc. I've used versions 4.8.2 and 5.5.0. Probably any version will do. - It's only needed for convfont.c (and there's nothing gcc-specific - about it, so really you just need any C compiler, see HOSTCC in the - Makefile). +- gcc. I've used versions 4.8.2 and 5.5.0, probably any version will do. + I've also tested with clang and pcc. Pretty much any C compiler + that produces native binaries for your platform should work. It's + used for various host tools (convfont.c, textcomp.c, mkcart.c, + gzip2deflate.c) - perl. I used version 5.18.1 and later upgraded to 5.22.2. Probably any 5.x version will work. @@ -27,8 +28,8 @@ Build Requirements for Atari 8-bit Taipan: have it, the git hash will be built into the binary and appear on the title screen. -- A UNIX/POSIX environment. At least, you need a 'cat' command and - a shell that does I/O redirection. Linux, BSD, and Mac OS X should +- A UNIX/POSIX environment. At least, you need command like cat, cp, rm, + and a shell that does I/O redirection. Linux, BSD, and Mac OS X should be fine. If you're on Windows, try Cygwin. If you plan to edit the port status screen, you'll need the Atari800 @@ -43,5 +44,7 @@ it doesn't work, you're likely missing one or more of the requirements listed above. If you'd prefer a cartridge image, "make cart" will build both a raw image -(taipan.rom) and an image with an Atari800 CART header (taipan.cart). You'll -specifically need cc65 version 2.15 for this (for now, anyway). +(taipan.rom) and an image with an Atari800 CART header (taipan.cart). + +Once you've compiled Taipan, see RUNNING.txt to find out what to do +with the executable. |