1 files changed, 19 insertions, 2 deletions
diff --git a/README.md b/README.md
index 9e2199f..11c76e9 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,23 @@
 # forspll
 
-forspll is an implementation of the [Forsp](https://github.com/xorvoid/forsp) language as an LLVM-based compiler.
+forspll is an implementation of [Forsp](https://xorvoid.com/forsp.html) as an LLVM-based compiler. Forsp is a tiny yet very versatile programming language that mixes features of Forth and Lisp. Through LLVM, Forsp can be compiled into efficient machine code for a wide array of platforms.
 
-TODO
+forspll features:
+
+* Lisp-style S-expression syntax
+* Forth-style data stack for parameters/values
+* Linking with C functions (see `support.c`)
+
+Missing features:
+
+* Quote operator: `quote`/`'`
+* Lists and atoms or any dynamic allocations
+
+## Building
+
+Requires Clang and LLVM development files.
+
+Run `make` to build the compiler.
+
+Run `make prog` to compile `test.fp` and `support.c`.