Unify the READMEs
- axe the outdated parts of README-MAC.txt - let's present Docker as the easy default here; Maiko build instructions are in that repo
This commit is contained in:
Abe Jellinek
parent
c66fd9a4d8
commit
24e3e2acd3
@ -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
|
||||
|
||||
|
||||
@ -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 &
|
||||
61
README.md
61
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
|
||||
```
|
||||
|
||||
@ -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.
|
||||
Loading…
x
Reference in New Issue
Block a user