From 65f050bbbf69e2265b54825791b7266e6736f952 Mon Sep 17 00:00:00 2001 From: Paolo Amoroso Date: Wed, 13 Dec 2023 22:39:27 +0100 Subject: [PATCH 1/3] Add section Getting started Provide reading lists of documentation resources as discussed in Medley issue 1131. --- content/en/software/using-medley/_index.md | 24 +++++++++++++++++++++- 1 file changed, 23 insertions(+), 1 deletion(-) diff --git a/content/en/software/using-medley/_index.md b/content/en/software/using-medley/_index.md index 84fcd279c..983c61c58 100644 --- a/content/en/software/using-medley/_index.md +++ b/content/en/software/using-medley/_index.md @@ -15,11 +15,33 @@ Whether you're just getting started or refreshing your knowledge of Interlisp, w The following links lead to PDF files containing Interlisp documentation. We are in the process of organizing this documentation. +### Getting started + +To learn Medley we recommend that you go over the following reading lists and pursue the resources in the indicated order. + +The introductory list gets you started using Medley. The advanced list builds from there and covers programming the system and mastering its tools. + +Most of these resources were created decades ago when Medley was a research system and a commercial product, so they may be incomplete or out of date. We will eventually update them. + +#### Introductory material + +1. [The Basics of Interlisp](Using). Essential information on the Interlisp language and the differences with Common Lisp. +1. [Medley for the Novice](https://interlisp.org/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. +1. [LispCourse notes](https://interlisp.org/pub-pdfs/lispcourse/lispcourse.pdf). The notes of a beginner course on the Interlisp environment that goes from the basics of interacting with the system to programming in Lisp. Highly recommended. Skip the sections on printing and the network as modern Medley doesn't fully implement the described functionality. The formatting of the text is partially broken and some sections are missing. + +#### Advanced material + +1. [INTERLISP: The Language and Its Usage](https://interlisp.org/documentation/1986-interlisp-language-book-1.pdf). An extensive book on the Interlisp language, a prerequisite for accessing the full functionality of Medley from Lisp. Some of the material is about early Interlisp versions that differ from Medley. You may skip the chapters on the Interlisp TTY editor, DWIM, and Conversational Lisp (CLISP). +1. [Medley Language Reference](https://interlisp.org/documentation/IRM.pdf) (also known as Interlisp Reference Manual). The reference documentation on the Interlisp language, the application platform, and the development environment. The chapters on the Interlisp language are highly recommended. You may skip the chapters on DWIM and CLISP. Some chapters are duplicated, others are missing. +1. [Medley Interlisp: Interactive Programming Tools](https://interlisp.org/documentation/2021-interlisp-book-3.pdf). Using the development tools and applications. Skip the chapter on DEdit as the tool was replaced by SEdit, the current default Lisp code editor. +1. [Medley Interlisp: The Interactive Programming Environment](https://interlisp.org/documentation/20211225-interlisp-book-2.pdf). Accessing from Lisp the facilities and tools of the Medley environment such as windows, menus, fonts, and image streams. + ### Unsorted documentation content Most Interlisp/Medley documentation was written using the Medley Text Editor, one of the first WYSIWYG graphical user interface text editors, called TEdit. Written in and for Interlisp users, it features muliple fonts, embedded graphics including line drawings and raster images. -TEdit files are scattered through the the various Interlisp repositories. For the convenience of those who would rather read the files using more modern tools, see the files from different Medley Interlisp repositories, [converted to PDF](https://drive.google.com/drive/folders/10ZBQty5gEwdBnZHtEbXfe5f1dHGziGZG?usp=sharing). NOTE: This is not a permanent location! +TEdit files are scattered through the various Interlisp repositories. For the convenience of those who would rather read the files using more modern tools, see the files from different Medley Interlisp repositories, [converted to PDF](https://drive.google.com/drive/folders/10ZBQty5gEwdBnZHtEbXfe5f1dHGziGZG?usp=sharing). NOTE: This is not a permanent location! For the searcher's conveneience, these have also been combined into searchable PDFs named All-*-PDFs.pdf. From d72010ee704894403dff7082fa242f53e9c399da Mon Sep 17 00:00:00 2001 From: Paolo Amoroso Date: Fri, 15 Dec 2023 15:18:54 +0100 Subject: [PATCH 2/3] Fix broken links As per the discussion in PR 192. --- content/en/software/using-medley/_index.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/content/en/software/using-medley/_index.md b/content/en/software/using-medley/_index.md index 983c61c58..3d073eab9 100644 --- a/content/en/software/using-medley/_index.md +++ b/content/en/software/using-medley/_index.md @@ -25,7 +25,7 @@ Most of these resources were created decades ago when Medley was a research syst #### Introductory material -1. [The Basics of Interlisp](Using). Essential information on the Interlisp language and the differences with Common Lisp. +1. [The Basics of Interlisp](/software/Using.html). Essential information on the Interlisp language and the differences with Common Lisp. 1. [Medley for the Novice](https://interlisp.org/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. 1. [LispCourse notes](https://interlisp.org/pub-pdfs/lispcourse/lispcourse.pdf). The notes of a beginner course on the Interlisp environment that goes from the basics of interacting with the system to programming in Lisp. Highly recommended. Skip the sections on printing and the network as modern Medley doesn't fully implement the described functionality. The formatting of the text is partially broken and some sections are missing. @@ -54,9 +54,9 @@ For the searcher's conveneience, these have also been combined into searchable P #### Exported Medley Documentation These documents were converted from Medley's internal format into PDFs. Watch out for weird formatting, but these are firsthand sources on Medley features and applications. -- Medley Internal Documentation PDF -- Notecards Documentation PDF -- LOOPS Documentation PDF +- [Medley Internal Documentation PDF](https://interlisp.org/documentation/All-Medley-PDFs.pdf) +- [Notecards Documentation PDF](https://interlisp.org/documentation/All-Notecards-PDFs.pdf) +- [LOOPS Documentation PDF](https://interlisp.org/documentation/All-LOOPS-PDFs.pdf) ### Interlisp Books From 33364dfa19de6d2d322f1d4282d81330fa21f1e5 Mon Sep 17 00:00:00 2001 From: Paolo Amoroso Date: Fri, 15 Dec 2023 16:49:05 +0100 Subject: [PATCH 3/3] Fix broken link Fix broken link LOOPS Documentation PDF. --- content/en/software/using-medley/_index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/en/software/using-medley/_index.md b/content/en/software/using-medley/_index.md index 3d073eab9..ebbcf9ce6 100644 --- a/content/en/software/using-medley/_index.md +++ b/content/en/software/using-medley/_index.md @@ -56,7 +56,7 @@ These documents were converted from Medley's internal format into PDFs. Watch ou - [Medley Internal Documentation PDF](https://interlisp.org/documentation/All-Medley-PDFs.pdf) - [Notecards Documentation PDF](https://interlisp.org/documentation/All-Notecards-PDFs.pdf) -- [LOOPS Documentation PDF](https://interlisp.org/documentation/All-LOOPS-PDFs.pdf) +- [LOOPS Documentation PDF](https://interlisp.org/documentation/All-Loops-PDFs.pdf) ### Interlisp Books