update documentation on options