Update docs around flush.