lib/sdl: improve implementation and doc of `SDLDisplay::events`