mirror of
https://github.com/ksherlock/mpw.git
synced 2024-11-27 17:51:04 +00:00
96 lines
2.3 KiB
Markdown
96 lines
2.3 KiB
Markdown
MPW Emulator
|
|
------------
|
|
|
|
by Kelvin W Sherlock, _et alia_
|
|
|
|
Please check the [wiki](https://github.com/ksherlock/mpw/wiki/_pages) for useful information.
|
|
|
|
Please check the [releases](https://github.com/ksherlock/mpw/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](http://fellow.sourceforge.net) 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](https://github.com/jeftyneg/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.
|
|
|