====== cc65 under OS X ======
cc65 runs perfectly fine under various versions of OS X. While at the moment there are no up to date binary installation packages distributed, one can quite easily build his own binaries from sources provided as either [[ftp://ftp.musoftware.de/pub/uz/cc65/|stable versions]] in form of "tarballs" or check out the bleeding edge from [[ftp://ftp.musoftware.de/pub/uz/cc65/snapshot/|snapshot directory]] or subversion [[svn://svn.cc65.org/cc65/trunk|repository]].

Please note that in order to build cc65 from sources one requires a working UNIX development environment (especially GCC compiler), which is not a part of the default system installation. The requirements are then:

  * Apple Developer's Tools (mandatory) - please download((At the time of writing [[http://www.apple.com/|Apple]] provides necessary [[http://developer.apple.com/technologies/xcode.html|developer tools]] free of charge but requires registration in order to download the software.)) appropriate, latest package available for your OS version and install it with "UNIX Development" option checked((Checking this option places all necessary command line tools, headers, and other files required for typical UNIX style development, where they are expected to be in a working unix development environment (/usr/) ))
  * linuxdoc-tools (optional) - required only to build the documentation((Probably the easiest way to obtain a working set of linuxdoc tools is to install them using [[http://www.macports.org/|MacPorts]] (formerly known as "Darwin Ports") software distribution system, which in itself is a very good thing to have also for many other reasons))
If you have downloaded the source "tarball", extract the files from the archive to a directory of your choice. Since cc65 is very cleanly written - no additional configuration processes are needed. Once the necessary prerequisites are in place, start your terminal and cd to the directory where you have either extracted or checked out the cc65 sources. Simple command:
<code>
$ make -f make/gcc.mak
</code>
given from the directory you just cd'ed to, should be enough to build binaries, libraries, and documentation (the last only if the optional linuxdoc tools are installed)((The most recent versions of cc65 recognise automatically whether linuxdoc tools are present and skip the documentation build process if none found. Earlier versions, which were expecting linuxdoc-tools to be always present, had a bad habit of stopping the building process with error when no linuxdoc-tools were installed on the host machine. Therefore, if you get errors when building documentation, you should most probably update your source tree.))

Once the build process is finished without errors, the next step is to install the files in their default locations:
<code>
$ sudo make -f make/gcc.mak install
</code>
installs all the required files in their default location of /usr/local/((Please use the recent (2.13.1+) cc65 sources - some earlier version installed in different default locations, interfering sometimes with system's own binaries!))
===== Compatibility =====
=== OS X 10.6 "Snow Leopard" (i386) ===
Building from source works 100% - tested
=== OS X 10.5 "Leopard" (ppc) ===
Building from source works 100% - tested
=== OS X 10.5 "Leopard" (i386) ===
Building from source works 100% - tested
=== OS X 10.4 "Tiger" (ppc) ===
Building from source should work fine - untested
=== OS X 10.4 "Tiger" (i386) ===
Building from source should work fine - untested
=== OS X 10.3 "Panther" (ppc) ===
Building from source should work fine - tested, please consider switching to 10.4, which is (IMHO) the first mature OS X version
=== OS X 10.2 "Jaguar" (ppc) ===
Building from source works 100% - tested, but while 10.2 was probably the first usable OS X version, you shouldn't really be running it anymore these days
=== OS X 10.1 or earlier (ppc) ===
Those were not really usable (IMHO) - I don't believe you might still be running it...