better documentation of option
comments