document revent clearing scheme

Signed-off-by: Andy Green <andy.green@linaro.org>