more README cleanups
confer exit status from vm function
bride of readme cleanup