Document new idiom for using Flag.
Merge pull request #2741 from quickfur/flag

Document new idiom for using Flag.