fix up flag docs
Merge pull request #705 from andymckay/flag-docs

fix up flag docs