started to document the flags buffer at last