Docs make it clear that clear is the preferred method
Created by: eileenmcnaughton
Changing flush to clear as the preferred method. I think when it was added there was an assumption devs would be developing against < 5.4 so it made sense to give primacy to flush but times have changed