doc: added a new TODO: "flush_all" method.