Function Wait-Events

Part of:

package glfw
( wait-events )
Description
The function is used for waiting for events, such as user input and window resize events. Upon calling
this function, the calling thread will be put to sleep until any event appears in the event queue. When
events are ready, the events will be processed just as they are processed by glfwPollEvents.
If there are any events in the queue when the function is called, the function will behave exactly like
glfwPollEvents (i.e. process all messages and then return, without blocking the calling thread).

Notes
It is guaranteed that glfwWaitEvents will wake up on any event that can be processed by
glfwPollEvents. However, glfwWaitEvents may wake up on events that are not processed or reported
by glfwPollEvents too, and the function may behave differently on different systems. Do no make any
assumptions about when or why glfwWaitEvents will return.