From 0ca8be1d4005eb536132fbb970565669a5787672 Mon Sep 17 00:00:00 2001
From: eltrac <hi@eltr.ac>
Date: Wed, 9 Sep 2026 22:54:28 +0800
Subject: makefile, readme: add repl make commands and instructions on Makefile

also removed use of Roswell, replaced with plain SBCL wrapped in rlwrap.
---
 Makefile  | 11 ++++++++++-
 README.md | 26 ++++++++++++++++++++------
 2 files changed, 30 insertions(+), 7 deletions(-)

diff --git a/Makefile b/Makefile
index 73aeb94..fd2eb9e 100644
--- a/Makefile
+++ b/Makefile
@@ -3,5 +3,14 @@ build:
 	     --eval '(ql:quickload :tempest)' \
          --eval "(sb-ext:save-lisp-and-die #p\"tempest\" :toplevel #'tempest:main :executable t)"
 
+repl: 
+	rlwrap sbcl \
+		--load tempest.asd \
+		--eval '(ql:quickload :tempest)'
+
 repl-server:
-	ros run --eval '(ql:quickload :swank)'  --eval '(swank:create-server :dont-close t)'
+	rlwrap sbcl \
+		--load tempest.asd \
+		--eval '(ql:quickload :swank)' \
+		--eval '(swank:create-server :dont-close t)' \
+		--eval '(ql:quickload :tempest)'
diff --git a/README.md b/README.md
index 356bd7f..3cbb194 100644
--- a/README.md
+++ b/README.md
@@ -25,11 +25,25 @@ Then a binary named `tempest` will be produced. Run it.
 
 Only `.lisp` file whose content starts with `;;;; TEMPEST` will be built.
 
-# Todos
+## Development
 
-- [ ] Integrate [Parenscript](https://parenscript.common-lisp.dev/), compile `.lisp` to `.js` or `<script>` embedded in `.html`.
-- [ ] `.lisp` to `.css`.
-- [ ] Parse metadata defined in header comments, e.g. `;;;; OUT = ...` specifies a destination.
-- [ ] Add macros for writing [Go templates](https://pkg.go.dev/text/template), e.g. `(mu ...)` to `{{ ... }}`, `(mu-if ...)` to `{{ if }}...{{ end }}`...
-- [ ] Add macros for writing [Vue](https://vuejs.org/) templates
+Make sure you have [SBCL](https://www.sbcl.org/), [GNU Make](https://www.gnu.org/software/make/) (or any other implementation) and [rlwrap](https://github.com/hanslub42/rlwrap) (not necessary, but used in some make commands) installed in your environment.
+
+Start an REPL with tempest loaded.
+
+```sh
+make repl
+```
+
+Start a [Swank](https://github.com/brown/swank-client) server for [SLIME](https://en.wikipedia.org/wiki/SLIME), [conjure](https://github.com/Olical/conjure) for Neovim or your editor of choice.
+
+```sh
+make repl-server
+```
+
+Build binary.
+
+```sh 
+make build
+```
 
-- 
cgit v1.2.3