documented vdir, run, run.rev (provided by Olivier Poitrey)