added documentation for the new options