include/hw: start documenting the vhost API