https://github.com/ksherlock/mpw

Macintosh Programmer's Workshop (mpw) compatibility layer
https://github.com/ksherlock/mpw

macintosh-programmers-workshop mpw mpw-emulator

Last synced: 23 days ago
JSON representation

Macintosh Programmer's Workshop (mpw) compatibility layer

• Host: GitHub
• URL: https://github.com/ksherlock/mpw
• Owner: ksherlock
• Created: 2013-07-26T15:44:57.000Z (almost 12 years ago)
• Default Branch: master
• Last Pushed: 2024-05-30T04:07:02.000Z (11 months ago)
• Last Synced: 2025-04-06T06:32:54.953Z (24 days ago)
• Topics: macintosh-programmers-workshop, mpw, mpw-emulator
• Language: C
• Homepage:
• Size: 1.34 MB
• Stars: 247
• Watchers: 25
• Forks: 22
• Open Issues: 21
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.text
  • Funding: .github/FUNDING.yml

Awesome Lists containing this project

README

        
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

First initialize and fetch submodules:

    git submodule init

    git submodule update

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`:

    #!/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.