documentation on the new options