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

redo intro #213

merged 10 commits into from
Mar 13, 2024

Conversation

masinter
Copy link
Member

  • Add (not linked yet) new pages SHFT and il-using
  • Multiple updates to install-and-run to point online to intro docs etc


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 only in the way they process the startup options. You can (and most frequently do) start Medley from a sysout file. When Medley first starts from a sysout, it automatically runs initialization scripts — a site initialization script followed by a per-user initialization script (if available).
Copy link
Contributor

Choose a reason for hiding this comment

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

How do the sysouts produced by MAKESYS and SYSOUT differ in the way the process the startup options?

Copy link
Member Author

Choose a reason for hiding this comment

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

MAN MAKESYS vs MAN SYSOUT tells the original story.
In Medley, we've tried to keep the sense of the difference between MAKESYS, SYSOUT, and SAVEVM with respect to handling of open files, user GREETing.

Copy link
Member Author

Choose a reason for hiding this comment

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

does this need more explanation? or rewrite to not use the function names such as MAKESYS and explain the concept ?

Copy link
Contributor

Choose a reason for hiding this comment

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

To me the explanation is clear as is. It's useful to keep the function names so that interested users can look them up.


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

Copy link
Contributor

@pamoroso pamoroso left a comment

Choose a reason for hiding this comment

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

I clarified a sentence @stumbo commented on as I originally wrote that text. Other than that the changes look good to me.

@masinter masinter requested a review from stumbo March 12, 2024 16:18
Copy link
Member

@stumbo stumbo left a comment

Choose a reason for hiding this comment

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

A couple more cleanup requests.

title: Software History Futures and Technologies (SHFT) group
weight: 20
type: docs
--
Copy link
Member

Choose a reason for hiding this comment

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

Need one more dash, ---


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.
The [Software History Futures and Technologies (SHFT) group](https://shft.group), now hosted by the Media and Technology Studies department at University of Alberta, Canada, 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 link
Member

Choose a reason for hiding this comment

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

https://www.shft.group -- it needs the www, Just shft.group fails.

@@ -1,13 +1,13 @@
---
title: Install and Run on Linux
title: on Linux
Copy link
Member

Choose a reason for hiding this comment

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

Maybe drop the on? That way we get a title that is

Linux

instead of

on Linux

weight: 20
aliases:
- /software/install-and-run/running-on-linux/
type: docs
---
<style>.td-content blockquote { border-left: none; color: inherit; padding-left: 2rem;}</style>

*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).*
*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).*
Copy link
Member

Choose a reason for hiding this comment

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

Either ../windows/wsl or software/install-and-run/windows/wsl

@masinter masinter requested a review from phantomics March 12, 2024 20:24
@@ -1,13 +1,13 @@
---
title: Install and Run on Linux
title: Linux
Copy link
Member

Choose a reason for hiding this comment

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

This will give you a different title in the side bar:

title: Install and Run on Linux
linkTitle: on Linux

@@ -0,0 +1,11 @@
---
title: Software History Futures and Technologies SHFT
title: Educopia
Copy link
Member

Choose a reason for hiding this comment

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

Delete this line, we only want one title line.

@masinter masinter merged commit 6742c18 into main Mar 13, 2024
@masinter masinter deleted the redo-intro branch March 13, 2024 01:40
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants