improve documentation for why the focus is cleared