Although the semantics of RetryException regarding suppressed exceptions are documented in the Javadoc for execute(Retryable) in RetryOperations and RetryTemplate, that documentation is outdated and does not state that the cause is the last exception thrown from the Retryable operation.

We should therefore properly document those semantics in RetryOperations, RetryTemplate, and RetryException.