document the vm ops