Clarified .then() rejection handler in the API docs.

It was unclear to me whether the rejection handler in .then() would be called for exceptions, so I clarified it a bit in API.md