conversion to rst, add documentation for new options