Getting Started: macOS

Download the latest release. The AMD64_LINUX installer works for any 64-bit little-endian Unix.

See Getting Started for context and background information.

Prerequisites

You will need Xcode, available through the App store, and the command-line developer tools

xcode-select --install

The MacPorts project has good instructions for setting up a development environment on MacOS.

The installer requires Python 3, CMake, and a C++ compiler. The distribution is packaged using GNU tar. Via Homebrew:

brew install cmake gnu-tar

Headless install

The default install builds a "headless" system, not including any of the UI libraries or X11 applications.

curl -LO https://github.com/modula3/cm3/releases/download/d5.11.4/cm3-dist-AMD64_LINUX-d5.11.4.tar.xz
gtar Jxf cm3-dist-AMD64_LINUX-d5.11.4.tar.xz
mkdir build
cd build
../cm3-dist-AMD64_LINUX-d5.11.4/scripts/concierge.py install --prefix $HOME/cm3
PATH=$HOME/cm3/bin:$PATH

The build directory above is used as a scratch space for building the bootstrap compiler. It can be safely deleted.

Full install

Specify all to build a full system including the UI libraries and X11 applications. You will need to install X11 development libraries.

brew install xquartz libxaw libxft

curl -LO https://github.com/modula3/cm3/releases/download/d5.11.4/cm3-dist-AMD64_LINUX-d5.11.4.tar.xz
gtar Jxf cm3-dist-AMD64_LINUX-d5.11.4.tar.xz
mkdir build
cd build
../cm3-dist-AMD64_LINUX-d5.11.4/scripts/concierge.py install --prefix $HOME/cm3 all
PATH=$HOME/cm3/bin:$PATH

It is safe to delete the build directory.

Next Steps

• Try the tutorial.
• There is a directory of examples included in the download. Also available online.
• Review the CM3 documentation, in particular:
  • interface documentation for the included libraries, and
  • historical Modula-3 books and papers.
• Visit the Modula-3 homepage.