Skip to content

redo intro #213

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 10 commits into from
Mar 13, 2024
Merged
Show file tree
Hide file tree
Changes from 2 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 3 additions & 0 deletions content/en/project/partners/SHFT.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# Software History Futures and Technologies (SHFT) group

This project, now part of the Media and Technology Studies department at University of Alberta, Canada, is partnering with the Interlisp group to help with making Interlisp accessible to those interested in learning its unique features as well as the context of innovation based on it.
15 changes: 7 additions & 8 deletions content/en/software/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,18 +4,17 @@ type: docs
aliases:

---
This section contains information on installing or setting up Medley and using it.
## Welcome to the Medley Interlisp Experience

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.
The [Medley Interlisp Project](/project) has focused on bringing the [historical software](/history) to life. This section contains information on setting up the Medley system and using it.

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.
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, or simplify the exchange of files with Medley.

These are the available options for running Medley:
* [Access Medley Online](access-online): how to access Medley running on our servers using your web browser.
* [Install and Run](install-and-run): how to set Medley up on your computer, and (re)start each time.

* [Access Medley Online](access-online): how to access Medley running on our servers using your web browser.
* [Install and Run](install-and-run): how to set Medley up on your computer, and restart each time.
* [Using Medley](using-medley): Once you are up and running, some basics and pointers to other documentation.
Once you are up and running, see "[Using Medley](using-medley)" for some basics and pointers to other documentation.

* *Coming*: [Running Medley in the browser!!](https://groups.google.com/g/lispcore/c/tiD2PUzBLCo/m/HuqWV63_AQAJ)


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 link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

... earlier versions of Interlisp-D...

From a user's perspective how is this any different than running Medley on our servers? Beyond, they may have access to earlier versions of Interlisp-D.

51 changes: 7 additions & 44 deletions content/en/software/access-online/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,12 +10,12 @@ aliases:
- /software/access-online
---

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.
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.

### Things to note when running online

* **Browser compatibility:** Older browsers may not support the VNC software we use; it should give you a warning if this is detected.
**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.
* **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.
* **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.
* **Reliable Internet:** You need a solid net connection to our AWS server (currently in Ohio).

Expand All @@ -25,59 +25,22 @@ Running Interlisp online is good for experimenting and introducing yourself to t
{{< imgproc Login_Screen Resize "400x450">}} Interlisp Online Login {{< /imgproc >}}
2. Login to Medley Interlisp Online:
* You can login as a guest by clicking <img src="Guest_Login_button.png" alt="Guest Login button"> on the login screen. However, guest sessions are not saved.
or
* We suggest you create your own account by clicking <img src="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.
or

* 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.

3. Select the Exec you want to run. For this exercise, select `Interlisp`
3. Select the Exec you want to start out with. For example, select `Interlisp`.

4. Leave the `Fill browser window` option set.
4. Leave the `Fill browser window` option set.

5. Select `Run Medley`.
Your browser will open a window that represents the Interlisp Desktop and looks much like this:

{{< imgproc Online_Initial_Medley Resize "800x450">}} Medley Interlisp{{< /imgproc >}}

The Interlisp Desktop at startup contains 4 windows of interest:

* Prompt Window: The black window at the top of the screen. It is used to display system or application prompts
* Exec (INTERLISP) window: The main window where you run functions and develop programs.
* Medley logo window: A window containing the Interlisp Medley logo as a bit map.
* Status Bar window

### Writing a sample Interlisp programs

In the Exec window, type the following:

```lisp
(PLUS 1 1)
```

When you complete typing the ending `)` the Interlisp interpreter will perform the calculation and return the result.

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.

<div class="mx-auto">
<a class="btn btn-lg btn-danger mr-3 mb-4" href="{{< relref "../.." >}}">
Guide to help you begin programming in Interlisp<i class="fas fa-arrow-alt-circle-right ml-2"></i>
<a class="btn btn-lg btn-danger mr-3 mb-4" href="{{< relref "/software/using-medley" >}}">
Guide to Using Medley i class="fas fa-arrow-alt-circle-right ml-2"></i>
</a>
</div>

### Managing memory images and sessions

(What is a memory image? How is it different from an image or memory?)

In Interlisp, there are two types of files relevant to managing memory images and updating them across sessions: `lisp.virtualmem` and `.sysout`.

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`).

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".

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.

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.

For guest logins, there is no `Resume previous session` because `lisp.virtualmem` is never preserved for guests.

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`).
4 changes: 2 additions & 2 deletions content/en/software/install-and-run/macos/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@ Medley releases on MacOS are distributed as a .zip file. The .zip file contains

To install Medley:

1. Download the latest release .zip from the [Medley downloads page](https://online.interlisp.org/downloads/medley_downloads.html) , under the heading "MacOS ...".
1. Download the latest release .zip from the [Medley downloads page](https://online.interlisp.org/downloads/medley_downloads.html), under the heading "MacOS ...".

<div align="center"><img alt="Medley Downloads Page" width=500 src="./images/downloads-page-macos.png"><p>&nbsp;</p></div>

Expand Down Expand Up @@ -88,7 +88,7 @@ This will bring up the Medley environment in a separate window on your desktop.
![Medley window open on MacOS desktop](./images/Medley-on-MacOS.png)

## **Use Medley**
Once Medley is up and running, see [here](../../using-medley/) for tips on how to navigate and use the Medley environment.
Once Medley is up and running, see [here](/software/using-medley/) for tips on how to navigate and use the Medley environment.

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:
Expand Down
4 changes: 2 additions & 2 deletions content/en/software/install-and-run/windows/native/_index.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
---
---
title: Install and Run on Windows "natively"
weight: 40
type: docs
Expand Down Expand Up @@ -73,7 +73,7 @@ This will bring up the Medley environment in a separate Window on your Windows d


## Use Medley
Once Medley is up and running, see [here](../../using-medley/) for tips on how to navigate and use the Medley environment.
Once Medley is up and running, see [here](/software/using-medley/) for tips on how to navigate and use the Medley environment.

To exit Medley, type ```(IL:LOGOUT)``` at any Exec window prompt.

Expand Down
Loading