bit of renaming , cleaning and documentation

lib/vm/README.markdown

@@ -0,0 +1,24 @@
+Parser
+================
+
+This includes the parser and generated ast.
+
+Parslet is really great in that it:
+- does not generate code but instean gives a clean dsl to define a grammar
+- uses ruby modules so one can split the grammars up
+- has a seperate tranform stage to generate an ast layer
+
+Especially the last point is great. Since it is seperate it does not clutter up the actual grammar.
+And it can generate a layer that has no links to the actual parser anymore, thus saving/automating
+a complete tranformation process. 
+
+
+Virtual Machine 
+===============
+
+This is the logic that uses the generated ast to produce code, using the asm layer.
+
+Apart from shuffeling things around from one layer to the other, it keeps track about registers and
+provides the stack glue. All the stuff a compiler would usually do.
+
+Also all syscalls are abstracted as functions.