readme

README.md

@@ -0,0 +1,30 @@
+libscary: An (scary) scalable array library in C 
+================================================
+
+```c
+int *a = scary_new(sizeof(int));
+```
+See the LHS; it looks like an ordinary C array, but
+
+```c
+printf("length: %zd\n", scary_length(a));
+```
+they knows their length by themselves.
+
+```c
+scary_push(a, -1);
+scary_push(a, 42);
+```
+You can push elements with automatic memory extension,
+as much as you want.
+
+```c
+int i = a[1];
+```
+And you'll see magic here; You can access them as an ordinary
+C array without any overhead.
+
+```c
+printf("content: %d\n", i);
+```
+Then it prints 42. Happy ending.