add readme

1 files changed, 42 insertions, 0 deletions

diff --git a/Readme.md b/Readme.md
new file mode 100644
index 0000000..bacfea8
--- /dev/null
+++ b/Readme.md
@@ -0,0 +1,42 @@
+# Bamboo Lisp
+
+Embeddable & Hackable Lisp-2 Interpreter
+
+(Work in Progress)
+
+## Build
+
+Debug:
+
+```bash
+git submodule init --recursive
+make
+```
+
+Release:
+
+```bash
+git submodule init --recursive
+make profile=release
+```
+
+## Example
+
+```lisp
+(defun Y (f)
+  (funcall
+    (lambda (g) (funcall g g))
+    (lambda (h)
+       (funcall f (lambda args (apply (funcall h h) args))))))
+
+(defun fibo-impl (self)
+  (lambda (n)
+    (if (<= n 2)
+        1
+        (+ (funcall self (- n 1)) (funcall self (- n 2))))))
+
+(defvar fibo (Y #'fibo-impl))
+
+(funcall fibo 10)
+```
+