minor flag2 doc update

* reflect the minor api change
* other minor modifications and fixes