added notes to repl
more correct VM docs