Improve documentation about boolean options

Refs #186