diff --git a/README-MAC.txt b/README-MAC.txt deleted file mode 100644 index 869909b3..00000000 --- a/README-MAC.txt +++ /dev/null @@ -1,57 +0,0 @@ -To get Medley to run on a mac: - -Copy this directory to your system. -Edit bin/medley to set MEDLEYDIR where you put it. - -(not sure if *fonts belong in fonts) - -You need a ~/.Xresources file with the line - ldex.screen: 1408x832 - -or whatever value is in the geometry. - - -The display size is an interaction between the .Xresources file and -the -geometry parameter. The values are good for a Macbook Air, so the -whole Lisp display is visible in the window. You can change it for a -bigger display. - -Set up a directory for your lisp init (e.g. /Users/Yourname/lisp) - -The site greeting file LOCAL-INIT is in current/ - -Everything is relevant to the medley dir, and that is set in the -command file so that it is exposed inside lisp. - -A function in the site greeting file (LOCAL-INIT) fixes meta key. - -Make sure that the site greeting file loads the patches (especially -USERNAMEPATCH), otherwise you won't get your personal greet. - -Work on rebuilding: - -Ron has been able to recreate a make-init and build an INIT.DLINIT, -and Nick has built an ldeinit. But it doesn't yet do what it is -supposed to do. There is a brief description of what to do in the -liscore/sunloadup that we got, but what looks like a more -comprehensive description is in a Tedit file written in Japanese. We -don't know how to get the text out to send to google translate. And -even if I could get the text, I'm not sure that the old character -encoding can be deciphered. - -Middle mouse button: - -if you don't have a 3-button mouse (wheel = middle mouse) -you can enable FN-left to be middle. run in terminal window - - defaults write org.macosforge.xquartz.X11 enable_fake_buttons -boolean true - defaults write org.macosforge.xquartz.X11 fake_button2 fn - defaults write org.macosforge.xquartz.X11 fake_button3 none - -To turn the settings back to the original default values do: - - defaults write org.macosforge.xquartz.X11 enable_fake_buttons -boolean false - defaults delete org.macosforge.xquartz.X11 fake_button2 - defaults delete org.macosforge.xquartz.X11 fake_button3 - - diff --git a/README-WINDOWS.txt b/README-WINDOWS.txt deleted file mode 100644 index 81ea36df..00000000 --- a/README-WINDOWS.txt +++ /dev/null @@ -1,23 +0,0 @@ - -To set up to run medley on Windows: - -You need either Docker for Desktop or WSL2. - -If you have Docker you can just docker run interlisp/medley -use a VNC client to connect to localhost - -If you want to run under WSL: - -Get a windows X server called Xming, the default options will do: - - https://sourceforge.net/projects/xming/ - -Make Maiko following the instructions there, and -copy lde ldex from linux.x86_64 into your path (/usr/local/bin) - -export MEDLEYDIR=/mnt/c/path-to-medley-directory -export HOME=/mnt/c/path-to-windows-home -export DISPLAY=:0 -export LDEINIT="$MEDLEYDIR"/greetfiles/local-init - -lde -screen 1440x800 -g 1440x800 -d your-machine-ip:0 -bw 0 -t "Medley Interlisp" medley/loadups/xfull35.sysout & diff --git a/README.md b/README.md index 10899fc5..b252c041 100644 --- a/README.md +++ b/README.md @@ -1,9 +1,9 @@ # medley This repo is for the overall Lisp environment for Medley Interlisp. -A sub-project is Interlisp/maiko which is the emulator of the Lisp virtual machine. +A sub-project is [Interlisp/maiko](https://github.com/Interlisp/maiko) which is the implementation of the Lisp virtual machine. If you want to run on some other platform that we haven't tried, you just need to port/build Maiko. -At the moment we're still in the process of sorting out what we have and insuring we start with a solid base. +We're still in the process of sorting out what we have and ensuring we start with a solid base. File Names and Extensions: Most Interlisp source file names are UPPERCASE and Interlisp didn't use file extensions for its source @@ -33,3 +33,60 @@ plus Dockerfile, and scripts for building and running medley +## Running Medley with Docker (all platforms) + +If this is your first time working with Docker, you'll want to [install it](https://docs.docker.com/get-docker/) before continuing. You'll also need a modern VNC client; [TightVNC](https://www.tightvnc.com/) works well. + +Next, you can either pull a prebuilt image or build from scratch: + +### Using a prebuilt image (recommended) + +1. `$ docker run -p 5900:5900 interlisp/medley` +2. Run a VNC viewer and connect to localhost. + +### Building from scratch + +1. Pull the latest Medley repo. +2. `$ cd medley` +3. Pull Maiko: `$ git submodule update --init --recursive` +4. `$ docker build . -t interlisp/medley` +5. And then as above. + + +## Running Medley with WSL (Windows) + +Get the Windows X server called [Xming](https://sourceforge.net/projects/xming/) (the default options will do). + +Make Maiko following the instructions [in that repo](https://github.com/Interlisp/maiko), and +copy `lde` and `ldex` from `linux.x86_64` into your path (/usr/local/bin). + +```sh +export MEDLEYDIR=/mnt/c/path-to-medley-directory +export HOME=/mnt/c/path-to-windows-home +export DISPLAY=:0 +export LDEINIT="$MEDLEYDIR"/greetfiles/LOCAL-INIT + +cd "$MEDLEYDIR" + +IP=1.2.3.4 # your Windows machine's local IP +./run-medley --dimensions 1440x800 --display "$IP":0 -bw 0 -full & +``` + +## Middle-mouse tweak (macOS) + +if you don't have a 3-button mouse (wheel = middle mouse) +you can enable FN-left to be middle. Run in a terminal: + +```sh +defaults write org.macosforge.xquartz.X11 enable_fake_buttons -boolean true +defaults write org.macosforge.xquartz.X11 fake_button2 fn +defaults write org.macosforge.xquartz.X11 fake_button3 none +``` + +To turn the settings back to the original default values do: + +```sh +defaults write org.macosforge.xquartz.X11 enable_fake_buttons -boolean false +defaults delete org.macosforge.xquartz.X11 fake_button2 +defaults delete org.macosforge.xquartz.X11 fake_button3 +``` diff --git a/README_docker.md b/README_docker.md deleted file mode 100644 index 71471047..00000000 --- a/README_docker.md +++ /dev/null @@ -1,18 +0,0 @@ -# Running Medley with Docker - -If this is your first time working with Docker, you'll want to [install it](https://docs.docker.com/get-docker/) before continuing. You'll also need a modern VNC client; [TightVNC](https://www.tightvnc.com/) works well. - -Next, you can either pull a prebuilt image or build from scratch: - -## Using a prebuilt image (recommended) - -1. `$ docker run -p 5900:5900 interlisp/medley` -2. Run a VNC viewer and connect to localhost. - -## Building from scratch - -1. Pull the latest Medley repo. -2. `$ cd medley` -3. Pull Maiko: `$ git submodule update --init --recursive` -4. `$ docker build . -t interlisp/medley` -5. And then as above.