document :boolean option flag