You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
* Add (not linked yet) new pages SHFT and il-using
* Multiple updates to install-and-run to point online to intro docs etc
* more editing of relative paths.
* respond to review comments
* Additional fixups per @stumbo
* more cleanup
* More problems fixed
* Change titles / headings to make title full, linktitle shortened
* getinvolved link was wrong, now fixed
* remove extra title from SHFT group
Copy file name to clipboardExpand all lines: content/en/project/_index.md
+1-1
Original file line number
Diff line number
Diff line change
@@ -29,7 +29,7 @@ We are trying to address this conflict by also making older versions of Interlis
29
29
We are [some of the original developers and users of Interlisp](/project/credits) 30 years ago, joined by newcomers interested in software history and preservation, along with members of the Lisp community. We work with [organizational partners](partners). And with you!
title: Software History Futures and Technologies SHFT
3
+
weight: 20
4
+
type: docs
5
+
---
6
+
7
+
The [Software History Futures and Technologies](https://www.shft.group) (SHFT) group] is now hosted by the Media and Technology Studies department at University of Alberta, Canada. SHFT is partnering with the Medley Interlisp project to help with making the Interlisp Experience accessible to those interested in learning its unique features as well as the context of innovation based on it.
Copy file name to clipboardExpand all lines: content/en/software/_index.md
+7-8
Original file line number
Diff line number
Diff line change
@@ -4,18 +4,17 @@ type: docs
4
4
aliases:
5
5
6
6
---
7
-
This section contains information on installing or setting up Medley and using it.
7
+
## Welcome to the Medley Interlisp Experience
8
8
9
-
There are two main ways of running Medley: accessing it online in a web browser or installing and running the system on your computer. Online access is best for trying out Medley without installing anything, as well as for basic usage. Install the system on your computer if you want to run Medley offline, customize the environment, or simplify the exchange of files with Medley.
9
+
The [Medley Interlisp Project](/project) has focused on bringing this [historical software](/history) to life. This section contains information on setting up the Medley system and using it.
10
10
11
-
We are working on making an early version of Medley run in the browser. This example of software preservation will let you access a technology artifact of historical significance.
11
+
There are two main ways of running Medley: accessing it online in a web browser or installing and running the system on your computer. Online access is good for trying out Medley without installing anything, as well as for basic usage. Install the system on your computer if you want to run Medley offline, customize the environment, and have direct access to local files.
12
12
13
-
These are the available options for running Medley:
13
+
*[Access Medley Online](access-online): how to access Medley running on our servers using your web browser.
14
+
*[Install and Run](install-and-run): how to set Medley up on your computer, and (re)start each time.
14
15
15
-
*[Access Medley Online](access-online): how to access Medley running on our servers using your web browser.
16
-
*[Install and Run](install-and-run): how to set Medley up on your computer, and restart each time.
17
-
*[Using Medley](using-medley): Once you are up and running, some basics and pointers to other documentation.
16
+
Once you are up and running, see "[Using Medley](using-medley)" for some basics and pointers to other documentation.
18
17
19
18
**Coming*: [Running Medley in the browser!!](https://groups.google.com/g/lispcore/c/tiD2PUzBLCo/m/HuqWV63_AQAJ)
20
19
21
-
20
+
We are working on making earlier version of Interlisp-D run in the browser. This example of software preservation will let you access a technology artifact of historical significance.
Copy file name to clipboardExpand all lines: content/en/software/access-online/_index.md
+7-44
Original file line number
Diff line number
Diff line change
@@ -10,12 +10,12 @@ aliases:
10
10
- /software/access-online
11
11
---
12
12
13
-
Running Interlisp online is good for experimenting and introducing yourself to the environment. However, anything you create in the online environment should be treated as transient. If you're interested in developing and experimenting with Lisp programs, you will want to investigate other options. For a first foray, it is a good starting point.
13
+
Running Medley online is good for experimenting and introducing yourself to the environment. However, anything you create in the online environment should be treated as transient. If you're interested in developing and experimenting with Lisp programs, you will want to investigate other options. For a first foray, it is a good starting point.
14
14
15
15
### Things to note when running online
16
16
17
17
***Browser compatibility:** Older browsers may not support the VNC software we use; it should give you a warning if this is detected.
18
-
**control-character conflicts:** Different browsers may intercept user typing control-characters; for example, control-W might close the entire Medley window, rather than backward-delete a word. There is no standard fix: Using Chrome in "full screen" mode; using a browser extension which captures the control-character for its own operations might help.
18
+
***Control-character conflicts:** Different browsers may intercept user typing control-characters; for example, control-W might close the entire Medley window, rather than backward-delete a word. There is no standard fix: Using Chrome in "full screen" mode; using a browser extension which captures the control-character for its own operations might help.
19
19
***No guarantees:** In general, Medley has NO WARRANTY, but in particular we make no guarantees that private information will not be revealed, or that your files uploaded to your account will be held securely.
20
20
***Reliable Internet:** You need a solid net connection to our AWS server (currently in Ohio).
21
21
@@ -25,59 +25,22 @@ Running Interlisp online is good for experimenting and introducing yourself to t
* You can login as a guest by clicking <imgsrc="Guest_Login_button.png"alt="Guest Login button"> on the login screen. However, guest sessions are not saved.
28
-
or
29
28
* We suggest you create your own account by clicking <imgsrc="New_User_Register_here_button.png"alt="New User Register here button"> on the login screen. Having an account enables you to save your sessions. To create an account, you just need an email address and password. Click Register here on the login screen to create your own account.
30
-
or
29
+
31
30
* If you are already registered (created an account), log in and start a Medley Interlisp session. Sessions are preserved for users that login with their own account. However, user account sessions may be deleted after 30 days of inactivity.
32
31
33
-
3. Select the Exec you want to run. For this exercise, select `Interlisp`
32
+
3. Select the Exec you want to start out with. For example, select `Interlisp`.
34
33
35
-
4. Leave the `Fill browser window` option set.
34
+
4. Leave the `Fill browser window` option set.
36
35
37
36
5. Select `Run Medley`.
38
37
Your browser will open a window that represents the Interlisp Desktop and looks much like this:
The Interlisp Desktop at startup contains 4 windows of interest:
43
-
44
-
* Prompt Window: The black window at the top of the screen. It is used to display system or application prompts
45
-
* Exec (INTERLISP) window: The main window where you run functions and develop programs.
46
-
* Medley logo window: A window containing the Interlisp Medley logo as a bit map.
47
-
* Status Bar window
48
-
49
-
### Writing a sample Interlisp programs
50
-
51
-
In the Exec window, type the following:
52
-
53
-
```lisp
54
-
(PLUS 1 1)
55
-
```
56
-
57
-
When you complete typing the ending `)` the Interlisp interpreter will perform the calculation and return the result.
58
-
59
-
One thing you probably noticed, the command `PLUS` is capitalized. It’s not that the developers of Interlisp were always shouting at each other. Rather, when Interlisp was developed computer programming was in its infancy and standards for naming commands were still evolving.
Guide to Using Medley<iclass="fas fa-arrow-alt-circle-right ml-2"></i>
64
44
</a>
65
45
</div>
66
46
67
-
### Managing memory images and sessions
68
-
69
-
(What is a memory image? How is it different from an image or memory?)
70
-
71
-
In Interlisp, there are two types of files relevant to managing memory images and updating them across sessions: `lisp.virtualmem` and `.sysout`.
72
-
73
-
The `lisp.virtualmem` file is a capture of the "current" state of the system (i.e., it is a copy of the virtual memory at a point in time). `lisp.virtualmem` is written whenever you execute `(IL:LOGOUT)` and also whenever executing `(IL:SAVEVM)`. You can restart Medley using a `lisp.virtualmem` and it will pick up essentially where it left off before the `LOGOUT` or `SAVEVM` (with the exception that the user can set `BEFORE`/`AFTER` and `LOGOUT`/`SAVEVM` code that runs before you get control of the restarted `lisp.virtualmem`).
74
-
75
-
A `.sysout` is a virtual memory image produced by `MAKESYS` (for writing an image for distribution) and `SYSOUT` (for saving a named checkpoint, e.g. to revert to a previous state if needed), which differ in the way they process the startup options. You can (and most frequently do) start Medley from a sysout file. When Medley starts from a sysout, it automatically runs initialization scripts — a site initialization script followed by a per-user initialization script (if available). A sysout is what you might call "a clean image".
76
-
77
-
As for Interlisp Online: except as noted below, every time you `Run Medley` you are starting up from a sysout file (i.e., from a clean image). The exception is if you check the `Resume previous session` box. In that case, you will be starting up from the `lisp.virtualmem` stored for you online (if any) and that was created by the `(IL:LOGOUT)` at the end of your previous session.
78
-
79
-
As a registered Interlisp Online user you get the choice of resuming your previous image or starting from a clean image — with the default being starting from a clean image.
80
-
81
-
For guest logins, there is no `Resume previous session` because `lisp.virtualmem` is never preserved for guests.
82
-
83
-
For registered users, any files that you create (e.g., with `IL:MAKEFILE`) will also be preserved across sessions online. But these files will never be automatically loaded into the system when you re-start with a clean image — you need to `LOAD` them explicitly (or add a `LOAD` to your personal `INIT` file stored online at `{DSK}/home/medley/il/INIT`).
*Note that these instructions do not apply to Linux distros running within Windows System For Linux (WSL). [Separate instructions are available for WSL here.](../windows/wsl).*
11
+
*Note that these instructions do not apply to Linux distros running within Windows System For Linux (WSL). Separate instructions are available for WSL [here](../windows/wsl).*
11
12
12
13
Medley installs and runs on most recent Linux distros (Alpine Linux is one exception). All that is strictly required is that the distro include an X Windows server. Most of the testing for Medley has been done on Ubuntu 20.04 and 22.04.
13
14
@@ -95,14 +96,13 @@ Documentation for the `<flags and options>` to the `medley` command can be found
95
96
96
97
For first-time users: `medley --vnc --apps --interlisp --noscroll` or, equivalently, `medley -v -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.
97
98
98
-
This will bring up the Medley environment in a separate Window on your Windows desktop. The Medley desktop and windows will all be contained within this Window as shown below.
99
-
100
-
99
+
This will bring up the Medley environment in a separate Window on your Linux desktop. The Medley desktop and windows will all be contained within this Window as shown below.
101
100
101
+
102
102
103
103
104
104
## **Use Medley**
105
-
Once Medley is up and running, see [here](../../using-medley/) for tips on how to navigate and use the Medley environment.
105
+
Once Medley is up and running, see [here](software/using-medley/) for tips on how to navigate and use the Medley environment.
106
106
107
107
By default, Medley will use (creating, if necessary) a directory called *$HOME/il*. This will be used by the Medley system as its *LOGINDIR* as follows:
1. Go to the [Releases page for Interlisp/Medley on github.com](https://github.com/interlisp/medley/releases). Here you will see a list of releases in reverse chronological order.
1. Go to the [Releases page for Interlisp/Medley on github.com](https://github.com/interlisp/medley/releases). Here you will see a list of releases in reverse chronological order.
@@ -22,11 +24,11 @@ Medley releases on MacOS are distributed as a .zip file. The .zip file contains
22
24
23
25
To install Medley:
24
26
25
-
1. Download the latest release .zip from the [Medley downloads page](https://online.interlisp.org/downloads/medley_downloads.html), under the heading "MacOS ...".
27
+
1. Download the latest release .zip from the [Medley downloads page](https://online.interlisp.org/downloads/medley_downloads.html), under the heading "MacOS ...".
>> You can also download the installation .zip file for the latest as well as any prior releases from the Medley Releases page on the Interlisp GitHub site. [Instructions for this can be found here](./macos-from-github).
31
+
>> You can also download the installation .zip file for the latest as well as any prior releases from the Medley Releases page on the Interlisp GitHub site. Instructions for this can be found [here](macos-from-github).
30
32
31
33
2. Copy 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. Optionally, rename the target folder of the copy from *medley-full-macos-universal...* to something more manageable - e.g., *medley-latest*. For the purposes of these instructions, we will call this (renamed) folder the *\<medley_folder>*.
32
34
@@ -88,7 +90,7 @@ This will bring up the Medley environment in a separate window on your desktop.
88
90
89
91
90
92
## **Use Medley**
91
-
Once Medley is up and running, see [here](../../using-medley/) for tips on how to navigate and use the Medley environment.
93
+
Once Medley is up and running, see [here](/software/using-medley/) for tips on how to navigate and use the Medley environment.
92
94
93
95
By default, Medley will use (creating, if necessary) a directory called *$HOME/il*. This will be used by the Medley
There are two ways to install and run Medley on Windows:
8
-
1. Run Medley on Windows System for Linux (WSL)
9
-
2. Run the 'native' Medley Windows app
8
+
There are two ways to install and run Medley on Windows. These two ways result in (nearly) identical Medley experiences, but differ in how Medley is installed and started.
10
9
11
-
These two ways result in (nearly) identical Medley experiences, but differ in how Medley is installed and started.
10
+
1.[Using WSL](wsl) (Windows Syswem for Linux). Medley on WSL requires the WSL subsystem to be installed on your Windows system. And when installing and using Medley on WSL you are working within a Linux environment. Some familiarity with Linux and the Linux command line is helpful. Medley on WSL is best for users who are running WSL anyway and/or prefer working in a Linux environment.
12
11
13
-
Medley on WSL requires the WSL subsystem to be installed on your Windows system. And when installing and using Medley on WSL you are working within a Linux environment. Some familiarity with Linux and the Linux command line is helpful. Medley on WSL is best for users who are running WSL anyway and/or prefer working in a Linux environment.
14
-
15
-
Medley 'native' works within the ordinary Windows environment. Installation uses a standard Windows installer and you start Medley from a standard Command (or Powershell) window. Medley 'native' is best for users who prefer to stay (almost) exclusively in the Windows environment.
12
+
2.[Run Medley 'native'](native). Medley 'native' works within the ordinary Windows environment. Installation uses a standard Windows installer and you start Medley from a standard Command (or Powershell) window. Medley 'native' is best for users who prefer to stay (almost) exclusively in the Windows environment.
16
13
17
14
Medley on WSL and 'native' Medley both require 64-bit Windows 10/11.
When running on Windows natively, Medley will be installed into a directory of your choice. This directory will contain an isolated copy of the Cygwin environment (an adaptation of Linux tools and apps to Windows) and a version of Medley that runs within that specific Cygwin environment. This presence of Cygwin, however, is largely hidden from the user and Medley behaves as if it is a native Windows app.
@@ -16,7 +18,7 @@ When running on Windows natively, Medley will be installed into a directory of y
16
18
17
19
18
20
19
-
> >Alternatively, you can download the Medley Windows installer for the current or any previous release from the Medley Releases page on the Interlisp GitHub site. [Instructions for this can be found here](./windows-native-from-github).
21
+
> >Alternatively, you can download the Medley Windows installer for the current or any previous release from the Medley Releases page on the Interlisp GitHub site. [Instructions for this can be found here](windows-native-from-github).
20
22
21
23
2. Start the Medley installation app (e.g., by double clicking on the .exe just downloaded).
22
24
@@ -73,7 +75,7 @@ This will bring up the Medley environment in a separate Window on your Windows d
73
75
74
76
75
77
## Use Medley
76
-
Once Medley is up and running, see [here](../../using-medley/) for tips on how to navigate and use the Medley environment.
78
+
Once Medley is up and running, see [here](/software/using-medley/) for tips on how to navigate and use the Medley environment.
77
79
78
80
To exit Medley, type ```(IL:LOGOUT)``` at any Exec window prompt.
0 commit comments