updated docs with new run options