add comments for flags array