fix minimal default and add roxygen docs