add documentation for new options & fix typos