update documentation for options