Tx Javadoc Polishing

Author: garyrussell

spring-kafka/src/main/java/org/springframework/kafka/core/KafkaOperations.java

@@ -185,21 +185,23 @@ public interface KafkaOperations<K, V> {
 	void flush();
 
 	/**
-	 * When running in a transaction (usually synchronized with some other transaction),
-	 * send the consumer offset(s) to the transaction. The group id is obtained from
-	 * {@link ProducerFactoryUtils#getConsumerGroupId()}. It is not necessary to call
-	 * this method if the operations are invoked on a listener container thread since the
-	 * container will take care of sending the offsets to the transaction.
+	 * When running in a transaction, send the consumer offset(s) to the transaction. The
+	 * group id is obtained from {@link ProducerFactoryUtils#getConsumerGroupId()}. It is
+	 * not necessary to call this method if the operations are invoked on a listener
+	 * container thread (and the listener container is configured with a
+	 * {@link org.springframework.kafka.transaction.KafkaAwareTransactionManager}) since
+	 * the container will take care of sending the offsets to the transaction.
 	 * @param offsets The offsets.
 	 * @since 1.3
 	 */
 	void sendOffsetsToTransaction(Map<TopicPartition, OffsetAndMetadata> offsets);
 
 	/**
-	 * When running in a transaction (usually synchronized with some other transaction),
-	 * send the consumer offset(s) to the transaction. It is not necessary to call this
-	 * method if the operations are invoked on a listener container thread since the
-	 * container will take care of sending the offsets to the transaction.
+	 * When running in a transaction, send the consumer offset(s) to the transaction. It
+	 * is not necessary to call this method if the operations are invoked on a listener
+	 * container thread (and the listener container is configured with a
+	 * {@link org.springframework.kafka.transaction.KafkaAwareTransactionManager}) since
+	 * the container will take care of sending the offsets to the transaction.
 	 * @param offsets The offsets.
 	 * @param consumerGroupId the consumer's group.id.
 	 * @since 1.3