Improve documentation
Adding docs for when_some/wait_some, correcting other docs. Changing when_xxx_n functions to return a vector<future<T>> instead of a future<Iterator>.