reformatted and updated options docs