document options, add tests for all options