adjusting docs to reflect new options