doc update; prepare 'clearFlash2' improvement