Improve docs for return value and @microseconds out parameter. (Reported