Macintosh Programmer's Workshop (mpw) compatibility layer
Go to file
2020-11-05 18:53:52 -05:00
.github/workflows Update cmake.yml 2020-11-05 18:50:36 -05:00
bin fixup clang range warnings. 2020-11-05 18:53:52 -05:00
cpu sync cpu code with fellow. fixes some instruction times and 64-bit division. 2017-12-14 08:23:17 -05:00
cxx clean up trailing whitespace / end of file linefeed. 2015-02-18 12:00:21 -05:00
libsane@0a41c901a4 submodule update. 2018-07-24 11:23:32 -04:00
macos clean up makefiles a bit. 2017-10-02 15:11:28 -04:00
mplite clean up makefiles a bit. 2017-10-02 15:11:28 -04:00
mpw case sensitive headers. 2017-10-02 21:16:12 -04:00
test update libsane 2017-12-14 10:47:45 -05:00
toolbox fixup clang range warnings. 2020-11-05 18:53:52 -05:00
verbatim Smarter handling of : after a variable. 2015-02-08 14:49:08 -05:00
.gitignore updated gitignore 2015-02-06 20:51:25 -05:00
.gitmodules use libsane... 2017-12-13 21:58:43 -05:00
.travis.yml Update .travis.yml 2016-01-27 14:21:35 -05:00
CHANGELOG.text changeling, bump version 2015-02-12 20:14:15 -05:00
CMakeLists.txt bump version. 2017-12-14 10:50:50 -05:00
README.md Update README.md 2015-06-23 13:31:11 -04:00
README.text updated readme 2013-08-16 22:53:04 -04:00
TODO.txt todo update 2013-08-21 21:28:50 -04:00

MPW Emulator

by Kelvin W Sherlock, et alia

Please check the wiki for useful information.

Please check the releases for compiled binaries.

System compatibility

Currently, only OS X 10.8+ with case-insensitive HFS+ is supported.

License

The 680x0 CPU code is from WinFellow and is licensed under GPL v2 or later. Consequently, the compiled binary is licensed under the GPL v2 as well.

The memory allocator (NewHandle/NewPointer) code is from mempoolite, which 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.

Building

Compiling requires cmake, ragel, lemon, and a recent version of clang++ with c++11 support. It has only been built and tested with OS X 10.8+.

mkdir build cd build cmake .. make

This will generate bin/mpw and bin/disasm.

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)
/usr/local/share/mpw/
/usr/share/mpw/

The layout is reminiscent of actual MPW installations.

mpw/Environment.text
mpw/Tools/...
mpw/Interfaces/...
mpw/Libraries/...
mpw/Help/...

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 simple.

# 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
Libraries=$MPW:Libraries:Libraries:
Libraries=${MPW}:Libraries:Libraries:

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)

/usr/local/bin/AsmIIgs:

#!/usr/bin/sh

exec mpw AsmIIgs $@

mpw uses the MPW $Commands variable to find the command, similar to $PATH on Unix. If the $Commands variable is not set, mpw looks in the current directory and then in the $MPW:Tools: directory.