applied coding standard fixes to comments in Flag directory

Was reviewing the Flags, for my own education and  thought I would like to give back

I moved  some function comments into the body of the code, in places, and  replaced them with @inherticdoc

Hope this helps.