Cleans up flush logic and documents some options