From 254928624f2bd83efa8c2a928c525c1f718d9aa1 Mon Sep 17 00:00:00 2001 From: David Schmenk Date: Tue, 9 Jul 2024 12:53:48 -0700 Subject: [PATCH] Docs... --- src/lisp/README.md | 11 +++++++++++ 1 file changed, 11 insertions(+) create mode 100644 src/lisp/README.md diff --git a/src/lisp/README.md b/src/lisp/README.md new file mode 100644 index 0000000..2144ffc --- /dev/null +++ b/src/lisp/README.md @@ -0,0 +1,11 @@ +# DRAWL (LISP 1.5) S-expression processor + +These are the files to implement a LISP 1.5 s-expression parser and evaluator. The PLASMA code is broken up into two modules: the core s-expression processor and the REPL environment. + +s-expr.pla is the guts of the system. Some features missing from the LISP 1.5 manual include floating point numbers and PROG functions. + +drawl.pla because this is a sslloowwww implementation of LISP, so named DRAWL in keeping with the speech impediment theme. The file reading and REPL functions are contained here. DRAWL is meant to be extensible so adding PROG and floating point is easily possible. + +The sample LISP files come from the LISP 1.5 manual. These are the only LISP programs that have been run on DRAWL, so other LISP programs may uncover bugs or limitations of DRAWL. + +More information and links can be found here: https://github.com/dschmenk/PLASMA/blob/master/doc/DRAWL.md