Doc Polishing

Author: garyrussell

spring-kafka/src/main/java/org/springframework/kafka/listener/RetryingBatchErrorHandler.java

@@ -34,9 +34,9 @@
  * A batch error handler that invokes the listener according to the supplied
  * {@link BackOff}. The consumer is paused/polled/resumed before each retry in order to
  * avoid a rebalance. If/when retries are exhausted, the provided
- * {@link ConsumerRecordRecoverer} is invoked. If the recoverer throws an exception, or
- * the thread is interrupted while sleeping, seeks are performed so that the batch will be
- * redelivered on the next poll.
+ * {@link ConsumerRecordRecoverer} is invoked for each record in the batch. If the
+ * recoverer throws an exception, or the thread is interrupted while sleeping, seeks are
+ * performed so that the batch will be redelivered on the next poll.
  *
  * @author Gary Russell
  * @since 2.3.7

src/reference/asciidoc/kafka.adoc

@@ -4686,7 +4686,7 @@ As an alternative to the <<retrying-batch-eh>>, version 2.5 introduced the `Reco
 This is now the default error handler for batch listeners.
 The default configuration retries 9 times (10 delivery attempts) with no back off between deliveries.
 
-This error handler works in conjunction with the listener throwing a `BatchListenerFailedException` providing the index in the batch where the failure occurred.
+This error handler works in conjunction with the listener throwing a `BatchListenerFailedException` providing the index in the batch where the failure occurred (or the failed record itself).
 If the listener throws a different exception, or the index is out of range, the error handler falls back to invoking a `SeekToCurrentBatchErrorHandler` and the whole batch is retried, with no recovery available.
 The sequence of events is: