update doc sand make range option more consistent with the rest of the api