diff --git a/content/en/history/_index.md b/content/en/history/_index.md index 9b88fd9e5..d5f8962fe 100644 --- a/content/en/history/_index.md +++ b/content/en/history/_index.md @@ -1,5 +1,6 @@ --- -title: History +title: The History of Interlisp +linkTitle: History weight: 500 type: docs aliases: diff --git a/content/en/project/partners/_index.md b/content/en/project/partners/_index.md index 62fd3e5d6..0dc17e34c 100644 --- a/content/en/project/partners/_index.md +++ b/content/en/project/partners/_index.md @@ -13,17 +13,17 @@ We joined SPN in 2021 as an "Implementation Sponsor". * SPN membership of (mainly academic and non-profit) organizations * We might partner with one or more of their members * Membership is $4k/year -* Hosts [Emulation as a Service infrastructure](https://www.softwarepreservationnetwork.org/emulation-as-a-service-infrastructure/) +* SPN is Hosted by Educopia, which also hosts [Emulation as a Service infrastructure](https://www.softwarepreservationnetwork.org/emulation-as-a-service-infrastructure/) -### Universities: CSUCI +### Universities: [SHFT group](SHFT) at University of Alberta -California State University Channel Islands +This group was reviously located in southern California, at the California State University Channel Islands, now is centered at the University of Alberta, in Canada. * Professor Eric Kaltman ### [LFG (Lexical Functional Grammar) group](https://ling.sprachwiss.uni-konstanz.de/pages/home/lfg/ilfga/constitution.html) -* Set up to allow tax-deductable donations for student travel to conferences +* LFG incorporated to allow tax-deductable donations for student travel to conferences * LFG is a current Medley application maintained by Ron Kaplan ### [Computer History Museum](https://computerhistory.org/) @@ -34,9 +34,7 @@ California State University Channel Islands ### Internet Archive -We have no formal relationship with IA, but we would be happy to have one. - -* MAME +We have been working with the Internet Archive to help preserve important artifacts associated with Interlisp-D and systems built using it. ### [Software Heritage](https://www.softwareheritage.org/) diff --git a/content/en/software/_index.md b/content/en/software/_index.md index ccd091858..2bedf3738 100644 --- a/content/en/software/_index.md +++ b/content/en/software/_index.md @@ -1,12 +1,11 @@ --- -title: Software +title: The Medley Software +linkTitle: Software type: docs -aliases: - --- ## Welcome to the Medley Interlisp Experience -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. +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. 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. diff --git a/content/en/software/access-online/_index.md b/content/en/software/access-online/_index.md index ba658ea0f..7de9c4579 100644 --- a/content/en/software/access-online/_index.md +++ b/content/en/software/access-online/_index.md @@ -1,5 +1,6 @@ --- title: Access Medley Online +linkTitle: Online weight: 10 type: docs aliases: diff --git a/content/en/software/install-and-run/_index.md b/content/en/software/install-and-run/_index.md index 31dbcb406..9db9ef399 100644 --- a/content/en/software/install-and-run/_index.md +++ b/content/en/software/install-and-run/_index.md @@ -11,9 +11,17 @@ weight: 10 type: docs --- -Packaged releases of Medley are available for Linux (most recent distros), MacOS and Windows 10/11. Both x86_64 and Arm64 systems are supported (as well as Arm7 - e.g., Raspberry Pi - for Linux). Instructions for installing and running Medley on these platforms are linked below. +Packaged releases of Medley are available for Linux (most recent distros), MacOS and Windows 10/11. Both x86_64 and Arm64 systems are supported (as well as Arm7 - e.g., Raspberry Pi - for Linux). Instructions for installing and running Medley on these platforms can be found: + +* [Mac OS](macos) +* [WIndows](windows) +* [Linux](linux) + +Medley is capable of running on a variety of other OSes including FreeBSD and Solaris as well as on other CPU architectures including i386, SPARC, PowerPC, and Risc-V. To install and run Medley on these platforms, you will need to build Maiko (the underlying virtual machine for Medley) from the sources available in the Interlisp/maiko repository on github.com. Instructions for building Maiko can be be found in the [*README* for Maiko](https://github.com/interlisp/maiko#readme). + +To make new Medley sysouts or build your own applications, see the [Building instructions and explanations](https://github.com/Interlisp/medley/blob/master/BUILDING.md). + -Medley is capable of running on a variety of other OSes including FreeBSD and Solaris as well as on other CPU architectures including i386, SPARC, PowerPC, and Risc-V. To install and run Medley on these platforms, you will need to build Medley (and its underlying virtual machine, *Maiko*) from the sources available in the Interlisp repos on github.com. Instructions for building Medley and Maiko can be be found on github in the [*readme* for Maiko](https://github.com/interlisp/maiko) and the [*readme* for Medley](https://github.com/interlisp/medley). diff --git a/content/en/software/install-and-run/linux/_index.md b/content/en/software/install-and-run/linux/_index.md index 10aabd959..116b52a13 100644 --- a/content/en/software/install-and-run/linux/_index.md +++ b/content/en/software/install-and-run/linux/_index.md @@ -8,7 +8,12 @@ type: docs --- -*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).* +<<<<<<< Updated upstream +*Note that these instructions do not apply to Linux distros running within Windows System For Linux (WSL). Separate instructions are available for WSL +[here](/software/install-and-run/windows/wsl/).* +======= +*Note that these instructions do not apply to Linux distros running within Windows System For Linux (WSL). [Separate instructions are available for WSL herea(/software/install-and-run/windows/wsl).* +>>>>>>> Stashed changes 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. @@ -102,7 +107,7 @@ This will bring up the Medley environment in a separate Window on your Linux des ## **Use Medley** -Once Medley is up and running, see [here](software/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: diff --git a/content/en/software/install-and-run/windows/_index.md b/content/en/software/install-and-run/windows/_index.md index b844796aa..04763790b 100644 --- a/content/en/software/install-and-run/windows/_index.md +++ b/content/en/software/install-and-run/windows/_index.md @@ -7,9 +7,11 @@ type: docs 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. -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. +1. [Using WSL](wsl) (Windows Syswem for Linux). Medley on WSL requires the WSL subsystem to be installed on your Windows system. 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. -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. +Medley on WSL requires the WSL subsystem to be installed on your Windows system. 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. See [WSL instructions](wsl). + +2. [Medley 'native'](native). Medley 'native' works within the ordinary Windows environment. Installation uses a standard Windows installer; 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.See [Native instructions](native). Medley on WSL and 'native' Medley both require 64-bit Windows 10/11. - +>>>>>>> Stashed changes diff --git a/content/en/software/install-and-run/windows/native/_index.md b/content/en/software/install-and-run/windows/native/_index.md index 747b02b7a..61358800c 100644 --- a/content/en/software/install-and-run/windows/native/_index.md +++ b/content/en/software/install-and-run/windows/native/_index.md @@ -71,9 +71,6 @@ This will bring up the Medley environment in a separate Window on your Windows d ![Medley window open on Windows desktop](../images/Medley-on-Windows.png) - - - ## Use Medley Once Medley is up and running, see [here](/software/using-medley/) for tips on how to navigate and use the Medley environment. diff --git a/content/en/software/using-medley/_index.md b/content/en/software/using-medley/_index.md index 5bc424807..b0ff67f37 100644 --- a/content/en/software/using-medley/_index.md +++ b/content/en/software/using-medley/_index.md @@ -1,5 +1,6 @@ --- title: Using Medley +linkTitle: Using weight: 10 type: docs aliases: @@ -38,6 +39,7 @@ Note: locations of documents are likely to change. Best to bookmark this page, w 2. [Medley Basics for Common Lisp users](cl-using). If you are familiar with Common Lisp, this guide points out some differences. 3. [Using Medley Online](online-using) -- additional introduction primarily for online users +4. [Key bindings](keystrokes) -- a short list of useful but unfamiliar keystrokes. 1. [Medley for the Novice](/documentation/Medley-Primer.pdf) (also known as Medley Primer). An introductory guide to the basics of Medley such as executing commands, using menus and files, manipulating windows, editing and saving Lisp code, using the development tools, and more. Read it in full. The code in chapter 20 "Free Menus" doesn't work and some illustrations are missing. 1. [SEdit — The Lisp Editor](https://drive.google.com/file/d/12LW5zCZauJvC63NRMJhjNv5qJkuuCflb/view?usp=sharing). The manual of SEdit, the default Lisp code editor. diff --git a/content/en/software/using-medley/cl-using.md b/content/en/software/using-medley/cl-using.md index c5748c977..70d97ded2 100644 --- a/content/en/software/using-medley/cl-using.md +++ b/content/en/software/using-medley/cl-using.md @@ -1,5 +1,6 @@ --- -title: Interlisp Basics for Common Lisp users +title: Interlisp Basics for CommonLispers +linkTitle: For CommonLispers url: /software/using-medley/cl-using/ type: docs weight: 30 @@ -7,13 +8,13 @@ weight: 30 If you are familiar with Common Lisp, this guide helps with some unexpected features. -### Advice for newcomers +## Advice for newcomers A coding project is a great learning experience. But porting existing Common Lisp software to Medley may be challenging as a first project. -Modern Common Lisps are similar and implement most of ANSI Common Lisp. Adapting software to these environments usually involves minor modifications you can carry out with familiar tools. But the Medley environment is very different and its Common Lisp farther from ANSI. +Modern Common Lisps are similar to each other, and implement most of ANSI Common Lisp. Adapting software to these environments usually involves minor modifications you can carry out with familiar tools. But the Medley environment is quite different. -Porting to Medley is a substantial task for a newcomer who has to deal at the same time with an incomplete Common Lisp implementation, unfamiliar tools, and an unknown workflow. +Porting Common Lisp libraries to Medley can be a substantial task for a newcomer who has to deal at the same time with an incomplete Common Lisp implementation, unfamiliar tools, and an unknown workflow. It's like hustling the move to a new country you barely speak the language and know the culture of. Within hours of landing at the airport you attempt to open a bank account, apply for a loan, file for health care, register with the tax system, negotiate renting an apartment, and do the paperwork for requesting the services of utility companies. Doing all this immediately after your arrival is overwhelming at best. diff --git a/content/en/software/using-medley/il-using.md b/content/en/software/using-medley/il-using.md index 3bc0f1d1e..ac5664a4f 100644 --- a/content/en/software/using-medley/il-using.md +++ b/content/en/software/using-medley/il-using.md @@ -1,5 +1,6 @@ --- title: Using Medley Interlisp Basics +linkTItle: Basics weight: 20 type: docs --- diff --git a/content/en/software/using-medley/keystrokes.md b/content/en/software/using-medley/keystrokes.md index 60231cb40..d02608aae 100644 --- a/content/en/software/using-medley/keystrokes.md +++ b/content/en/software/using-medley/keystrokes.md @@ -1,13 +1,15 @@ --- -title: Keystrokes, Mouse menus and Gestures +title: Keystrokes, Menus, and More url: /software/using-medley/keystrokes/ weight: 40 -aliases: - - /doc/info/Keystrokes.html +type: docs --- -The handling of keyboard and mouse clicks and gestures is different and varied within the Medley environment. This chart shows common keystrokes. -[Table of Keystrokes](https://docs.google.com/spreadsheets/d/1FOkrr62TtEhhY49m9U0T_6bvqSGRQt9fBRtMDw0YKtY/edit?usp=sharing) more data. +The handling of keyboard and mouse clicks and gestures is different from what modern users expect, and varied within the Medley environment. Most of the GUI of Medley had been built haphazardly by different developers. As part of "modernizing" Medley, we're hoping to change some of the non-obvious differences with modern expecation. In the meanwhile, here are some things you might not guess. + +This chart shows some commony used keystrokes. + +[Table of Keystrokes](https://docs.google.com/spreadsheets/d/1FOkrr62TtEhhY49m9U0T_6bvqSGRQt9fBRtMDw0YKtY/edit?usp=sharing) has even more data. We'd like to improve keyboard handling but haven't yet found a path. diff --git a/content/en/software/using-medley/online-using.md b/content/en/software/using-medley/online-using.md index 5e2f341b7..5e26c04f5 100644 --- a/content/en/software/using-medley/online-using.md +++ b/content/en/software/using-medley/online-using.md @@ -1,24 +1,25 @@ --- title: Using Medley Online -weight: 40 +weight: 79 type: docs --- - -## Starting up +### Starting up The Medley 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 or XCL) window: The main window where you run functions and develop programs. +* Exec (INTERLISP or XCL) window: The main window where you run functions and develop programs. It's a kind of "REPL" (read, eval, print loop) with more options and commands. * Medley logo window: A window containing the Interlisp Medley logo as a bit map. * Status Bar window +(also known as the "who line" shows status of various controls. + Medley Online users get some additional buttons on the right-hand side of the screen. ### Managing memory images and sessions -Medley has a byte-coded virtual machine architecture with a VM designed for Lisp. This is a common practice, used by Javascript, Flash and Java and other systems to aid in portability: to support a new architecture, you just port the "virtual machine emulator" rather than the whole system. +Medley has a byte-coded virtual machine architecture with a VM designed for Lisp. This is now a common practice, used by Javascript, Flash and Java and other systems to aid in portability: to support a new architecture, you just port the "virtual machine emulator" rather than the whole system. With Medley, there are two types of files relevant to managing memory images and updating them across sessions: `lisp.virtualmem` and `.sysout`. diff --git a/hugo.toml b/hugo.toml index b45d04e86..26584dd27 100644 --- a/hugo.toml +++ b/hugo.toml @@ -1,6 +1,6 @@ baseURL = "https://interlisp.org" -relativeURLs = true +relativeURLs = false canonifyURLs = true enableRobotsTXT = true