94 lines
2.1 KiB
Raw Permalink Normal View History

2013-07-15 01:05:18 +00:00
MPW Emulator
2013-08-17 02:45:57 +00:00
by Kelvin W Sherlock, et alia.
2013-07-15 01:05:18 +00:00
2013-08-17 02:53:04 +00:00
0. System compatibility
2013-07-15 01:05:18 +00:00
Currently, only OS X 10.8 with case-insensitive HFS+ is supported.
2013-08-17 02:53:04 +00:00
1. License
2013-07-15 01:05:18 +00:00
The 680x0 CPU code is from WinFellow ( and is
licensed under GPL v2 or later. Consequently, the rest of the code is licensed
under the GPL v2 as well.
The memory allocator (NewHandle/NewPointer) code is from mempoolite, which
2013-08-17 02:53:04 +00:00
is a fork of the SQLite zero-alloc allocator by Jefty Negapatan and D. Richard Hipp.
It, as is SQLite, is in the public domain.
2013-07-15 01:05:18 +00:00
2. Building
2013-07-17 02:43:48 +00:00
Compiling requires cmake, ragel, lemon, and a recent version of clang++ with
2013-07-15 01:05:18 +00:00
c++11 support. It has only been built and tested with OS X 10.8.
mkdir build
cd build
cmake ..
This will generate bin/mpw and bin/disasm.
3. Installation
Certain configuration and execution files are generally useful. They are
stored in an mpw directory, which may be located:
$MPW (shell variable)
~/mpw/ (your home directory)
The layout is reminiscent of actual MPW installations.
4. Environment file
The Environment.text file is new; it contains MPW environment variables (many
of them set the library and include file locations). The format is fairly
# this is a comment
#this sets a variable
name = value
# this sets a variable if it is undefined.
name ?= value
# values may refer to other variables
eventually, mpw will support a -Dname=value flag, so you can do something like:
# use 3.2 headers/libraries unless overridden on the command line
MPWVersion ?= 3.2
5. Usage
mpw [mpw flags] command-name [command arguments]
you may also create shell aliases:
alias AsmIIgs='mpw AsmIIgs'
or create a shell script (in /usr/local/bin, etc)
2013-07-15 01:05:18 +00:00
exec mpw AsmIIgs "$@"
2013-07-15 01:05:18 +00:00
mpw looks in the current directory and then in the $MPW:Tools: directory
for the command to run. The MPW $Commands variable is not yet supported.