Updated readme, Renamed Function

The bulk of this diff is an update to readme.md with some actual
documentation of the VM's workings.  I also rolled in a minor name
change.