improve some docs about options

See #387
4 jobs for master in 2 minutes and 4 seconds