updated docs with new option