From f31b935dc29efb3c4a7991481c4567ec43c8b71b Mon Sep 17 00:00:00 2001
From: vindarel <vindarel@mailz.org>
Date: Mon, 24 Apr 2023 16:26:48 +0200
Subject: [PATCH] README install instructions: ASDF for PLN

for #23
---
 README.md | 19 ++++++++++++++++++-
 1 file changed, 18 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index fc9dab7..3be1d93 100644
--- a/README.md
+++ b/README.md
@@ -100,7 +100,13 @@ On MacOS:
 
 You need a Lisp implementation and Quicklisp installed.
 
-CIEL is not yet on Quicklisp, but it is on [Ultralisp](https://ultralisp.org).
+You need the system dependencies above.
+
+You need a CL implementation with a recent enough version of ASDF to support package-local nicknames. As of March, 2023, this is not the case with SBCL 2.2.9. Here's a one-liner to update ASDF:
+
+    $ ( cd ~/common-lisp/ && wget https://asdf.common-lisp.dev/archives/asdf-3.3.5.tar.gz  && tar -xvf asdf-3.3.5.tar.gz && mv asdf-3.3.5 asdf )
+
+CIEL is not on Quicklisp yet, but it is on [Ultralisp](https://ultralisp.org).
 
 So, either clone this repository:
 
@@ -124,6 +130,17 @@ and enter the `ciel-user` package:
 (in-package :ciel-user)
 ```
 
+To build CIEL's binary and core image, use
+
+    $ make build
+
+This creates the `bin/` directory with the `ciel` binary.
+
+    $ make image
+
+This creates the `ciel-core` Lisp image.
+
+
 ## With a core image
 
 You need a Lisp implementation, but you don't need Quicklisp.