updated docs and added new option