Add lots of docs

First step towards #114
It doesn't wait for *this* frame, it waits for *some* frame in the past.