From a24748c49adf6c9992541fb1ea017bb3d09427ba Mon Sep 17 00:00:00 2001
From: Yuichi Nishiwaki <yuichi.nishiwaki@gmail.com>
Date: Sun, 14 Sep 2014 18:44:33 +0900
Subject: [PATCH] huge improvement of README

---
 README.md | 45 ++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 44 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 4c14ac09..37fc4165 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,49 @@
 # Benz
 
-Benz is core module of the Picrin Scheme interpreter. It includes all components necessary to run in a stand-alone environment.
+Benz is a super tiny scheme interpreter intended to be embedded in other applications such as game engine and network server. It provides a subset language of R7RS with several useful extensions. By default, Benz just contains some C files and headers and this README file. In embedding, you only need to copy the files into the project and add `include` dir to the include path.
+
+Originally, Benz used to be the core component of [Picrin Scheme](https://github.com/picrin-scheme/picrin). They are currently maintained at separate repositories.
+
+## Example
+
+```c
+#include <stdio.h>
+
+#include "picrin.h"
+
+/* Simple REPL program */
+
+int
+main(int argc, char *argv[])
+{
+  pic_state *pic;
+  pic_value expr;
+
+  pic = pic_open(argc, argv, NULL);
+
+  pic_import_library(pic, pic->PICRIN_BASE);
+
+  while (1) {
+    printf("> ");
+
+    expr = pic_read(pic, pic_stdin(pic));
+
+    if (pic_eof_p(expr)) {
+      break;
+    }
+
+    pic_printf(pic, "~s\n", pic_eval(pic, expr, pic->lib));
+  }
+
+  pic_close(pic);
+
+  return 0;
+}
+```
+
+## Language
+
+All procedures and syntaces are exported from a single library named `(picrin base)`. The complete list is found at https://gist.github.com/wasabiz/344d802a2340d1f734b7 .
 
 ## Authors