wait_event_* and wake_up_*

Hello, Could someone point me to good documentation about the wait_event_* and wake_up_* event family APIs? I tried searching and nothing concrete shows up. In particular: When do we use wake_up_interruptible()? Does wake_up(wq) wake up all the threads which are waiting on that work queue? Is the waking up of threads sequential? That should suffice for now I guess :) Regards, -- Pranith