# Macintosh Installation

The build system requires MacOS >= 8.6. Earlier versions behave badly.

Required tools:

- MetroWerks 5.3 Compiler (our own version with modified headers)
- Python 2.1.1
- Python Extension OSAm
- Python Extension StuffIt
- StuffIt Engine (special version, goes with Python StuffIt)
- MacCVS Pro 2.5 beta 2
- AkauSweets AppleScript extension
- ResManip AppleScript extension (our own, lost the source)
- RMA Build Prefs file in System Folder:Preferences:
- build module from CVS (cvs checkout build from /home/source)

The two Python extensions, OSAm and StuffIt, need to be copied into the :Mac:Plugins folder of the Python 2.1 installation. The AppleScript extensions, AkauSweets and ResManip, need to be copied into System Folder:Scripting Additions. There is a copy of the StuffIt engine which works with the StuffIt Python extension, but you can probably use whatever StuffIt came with your Mac.

One thing missing on the Macintosh is environment variables. The are simulated with a preferences file, RMA Build Prefs, that needs to be created in System Filer:Preferences. Here is a example:

Example(RMA Build Prefs):

    ## Sample RMA Build Prefs
    ## Environment Variables:
    ##   BUILD_ROOT: The path to the build system.
    ##   SOURCE_ROOT: The path to where you want to checkout/build source code.
    ##   BUILD_SW: The path to the CodeWarrior IDE.
    ##   MACCVS_PATH: The path to the MacCVS Pro program.
    ##   CVSSESSION_PATH: The path to the MacCVS Pro session file you created.

    os.environ = {
    "BUILD_ROOT" : "MacOS:dev:build",
    "SOURCE_ROOT" : "MacOS:dev:src",
    "BUILD_SW" : '"MacOS:CodeWarrior Pro 5:MetroWerks CodeWarrior: CodeWarrior IDE 4.0.4"',
    "MACCVS_PATH" : '"MacOS:dev:tools:MacCVS"',
    "CVSSESSION_PATH" : '"MacOS:dev:cvssession"'
    }

Now you need to compile two Python scripts in the build system in Python applets. This is done using the Build Applet tool in the Python install directory. Drag build:bin:build, and build:bin:umake onto Build Applet. For each applet created, you will need to increase the memory to about 20MB. After the applets are created, they can be moved onto the desktop, or wherever else you like to keep them. Double-click on the build applet to start the build system, or drag and drop Umakefils onto the umake applet to generate individual makefiles. The makefiles are AppleScript, and can be run easily by the Script Editor.