put entries in alphabetic order.
update comments on opaque options.