From 8553c49b3da3ef29acb769611cb09cf6cb50765f Mon Sep 17 00:00:00 2001 From: Frank Halasz Date: Sun, 10 Dec 2023 18:57:12 -0800 Subject: [PATCH] Bring running-on-mac.md up to the level of running-on-linux.md --- .../install-and-run/running-on-mac.md | 65 +++++++++++++++---- 1 file changed, 51 insertions(+), 14 deletions(-) diff --git a/content/en/software/install-and-run/running-on-mac.md b/content/en/software/install-and-run/running-on-mac.md index 41553f170..165997374 100644 --- a/content/en/software/install-and-run/running-on-mac.md +++ b/content/en/software/install-and-run/running-on-mac.md @@ -1,31 +1,68 @@ ---- +--- title: Install and Run on MacOS weight: 30 type: docs aliases: - /running/running-on-mac --- + + +## **Prerequisite: Install XQuartz** + +Before installing and running Medley on your Mac, you will need to download and install XQuartz - an open-source X11 Windows server for the Mac. You can download the latest XQuartz .pkg from [XQuartz.org](https://xquartz.org) and install it using the MacOS installer. + +If you do not have a three-button mouse on your Mac, you will need to set `Emulate three button mouse` in the XQuartz preferences. + +>To do so, start XQuartz (e.g., by double clicking the XQuartz icon within Launchpad). Select XQuartz->Preferences from the menu bar. In the Preferences dialog, select the Input tab and then check the *Emulate three button mouse* option. + +## **Install Medley** + +Medley releases on MacOS are distributed as a .zip file. The .zip file contains universal binaries so that the same file can be used for either Intel or Apple Silicon machines. + +To install Medley: + +1. Download the latest release .zip from the Medley latest releases page [(here)](https://online.interlisp.org/downloads/medley_downloads.html) , under the heading "MacOS ...". + + >You can also download the latest release .zip as well as any prior release .zips from the Medley GitHub site [(here)](https://github.com/Interlisp/medley/releases). In the Assets for any given release, the MacOS .zip file will be entitled *medley-full-macos-universal...zip* + +2. Drag the downloaded *medley-full-macos-universal...zip* file (which MacOS treats as an unzipped folder) from the Downloads folder into any folder of your choosing. For the purposes of these instructions, we will call this the *\*. And the file/folder just dragged into the \, we will call the *\*. + >You may also want to rename the \ from *medley-full-macos-universal...* to something more manageable - e.g., *medley-latest*. + +4. In a Terminal window, you will need to remove the quarantine attributes from the executable files by executing the following command: +`xattr -d com.apple.quarantine //maiko/darwin.universal/lde*` + + For example: +``` +ssd@Mac-mini ~ % xattr -d com.apple.quarantine ~/il/medley-latest/maiko/darwin.universal/lde* +``` + + +## **Run Medley** + +On MacOS, Medley must be started from a Terminal window. + +At the Terminal prompt, you need to execute the command `//medley/medley`. +>Note: it is usually easiest to first `cd \/\/medley` and then just execute `./medley` -## **How to Install** +For example: +``` +ssd@Mac-mini ~ % cd ~/il/medley-latest/medley +ssd@Mac-mini medley % ./medley -a -e -n +``` -1. Get the Installer - Download the MacOS installer from [the latest release page](https://github.com/Interlisp/medley/releases/latest). +Note that the first time you run it, Medley may take 10-15 seconds to start up as it starts the XQuartz X Windows server (assuming that it is not already running). +>You can optionally start the XQuartz server manually before starting Medley. It will take 10-15 seconds to start up and then display an Xterm window in the upper-left corner of the screen. You can just close this Xterm window. -2. Run Medley - Unzip the `medley-full-macos-universal...zip` file on your computer. Run the `medley/run-medley` script in the unzipped folder to start Medley. +There are many options to the `medley` command. For a brief overview, run `./medley --help`. For a more complete description, run `./medley --man` or click + [here](https://online.interlisp.org/downloads/man_medley.html). +For first-time users: `./medley -a -e -n` is a good starting point. This will give you a fully populated Medley system, including the applications built on Medley such as Notecards and Rooms. It will start with a Interlisp Exec window (instead of the Xerox Common Lisp Exec window). -## install medley from release, build maiko +#### Notes: -Need XCode -Need XQuartz installed before you build maiko (includes XClient libraries). +>By default, `medley` will create a directory in *$HOME/il*. This will be used by the Medley system as its *LOGINDIR*. Medley will start up with *LOGINDIR* as its current connected directory. It will load the personal init file (if any) from *LOGINDIR*/INIT or *LOGINDIR*/INIT.LCOM. Finally, Medley will use *LOGINDIR*/vmem/ to store its virtual memory file(s). The location of *LOGINDIR* can be changed using the `--logindir` option to `medley`. -* Requirements -- Intel or M1/M2 Macintosh (or even older) -- XQuartz Macintosh X server for your OS/mac vintage) -## XQuartz settings -emulate 3-button mouse