Improve reference doc for options parameters

For #1114 .

Part of #1684.