Skip to content

Commit 4272118

Browse files
Fix plural words rendering in docs
The document contains words written in plural form, so I think we can avoid the plural form by using double back-ticks instead of spaces. Signed-off-by: Tran Ngoc Nhan <[email protected]>
1 parent 88c45cc commit 4272118

File tree

5 files changed

+24
-24
lines changed

5 files changed

+24
-24
lines changed

spring-kafka-docs/src/main/antora/modules/ROOT/pages/appendix/change-history.adoc

+19-19
Original file line numberDiff line numberDiff line change
@@ -320,14 +320,14 @@ See xref:kafka/container-props.adoc[Listener Container Properties] for more info
320320
[[x30-template-changes]]
321321
=== `KafkaTemplate` Changes
322322

323-
The futures returned by this class are now `CompletableFuture` s instead of `ListenableFuture` s.
323+
The futures returned by this class are now ``CompletableFuture``s instead of ``ListenableFuture``s.
324324
See xref:kafka/sending-messages.adoc#kafka-template[Using `KafkaTemplate`].
325325

326326
[[x30-rkt-changes]]
327327
=== `ReplyingKafkaTemplate` Changes
328328

329-
The futures returned by this class are now `CompletableFuture` s instead of `ListenableFuture` s.
330-
See xref:kafka/sending-messages.adoc#replying-template[Using `ReplyingKafkaTemplate`] and xref:kafka/sending-messages.adoc#exchanging-messages[Request/Reply with `Message<?>` s].
329+
The futures returned by this class are now ``CompletableFuture``s instead of ``ListenableFuture``s.
330+
See xref:kafka/sending-messages.adoc#replying-template[Using `ReplyingKafkaTemplate`] and xref:kafka/sending-messages.adoc#exchanging-messages[Request/Reply with ``Message<?>``s].
331331

332332
[[x30-listener]]
333333
=== `@KafkaListener` Changes
@@ -395,7 +395,7 @@ See xref:kafka/headers.adoc[Message Headers] for more information.
395395
[[x29-template-changes]]
396396
=== `KafkaTemplate` Changes
397397

398-
In 3.0, the futures returned by this class will be `CompletableFuture` s instead of `ListenableFuture` s.
398+
In 3.0, the futures returned by this class will be ``CompletableFuture``s instead of ``ListenableFuture``s.
399399
See xref:kafka/sending-messages.adoc#kafka-template[Using `KafkaTemplate`] for assistance in transitioning when using this release.
400400

401401
[[x29-rkt-changes]]
@@ -405,8 +405,8 @@ The template now provides a method to wait for assignment on the reply container
405405
Also available in version 2.8.8 or later.
406406
See xref:kafka/sending-messages.adoc#replying-template[Using `ReplyingKafkaTemplate`].
407407

408-
In 3.0, the futures returned by this class will be `CompletableFuture` s instead of `ListenableFuture` s.
409-
See xref:kafka/sending-messages.adoc#replying-template[Using `ReplyingKafkaTemplate`] and xref:kafka/sending-messages.adoc#exchanging-messages[Request/Reply with `Message<?>` s] for assistance in transitioning when using this release.
408+
In 3.0, the futures returned by this class will be ``CompletableFuture``s instead of ``ListenableFuture``s.
409+
See xref:kafka/sending-messages.adoc#replying-template[Using `ReplyingKafkaTemplate`] and xref:kafka/sending-messages.adoc#exchanging-messages[Request/Reply with ``Message<?>``s] for assistance in transitioning when using this release.
410410

411411
[[what-s-new-in-2-8-since-2-7]]
412412
== What's New in 2.8 Since 2.7
@@ -474,7 +474,7 @@ See xref:kafka/annotation-error-handling.adoc#error-handlers[Container Error Han
474474

475475
The `interceptBeforeTx` container property is now `true` by default.
476476

477-
The `authorizationExceptionRetryInterval` property has been renamed to `authExceptionRetryInterval` and now applies to `AuthenticationException` s in addition to `AuthorizationException` s previously.
477+
The `authorizationExceptionRetryInterval` property has been renamed to `authExceptionRetryInterval` and now applies to ``AuthenticationException``s in addition to ``AuthorizationException``s previously.
478478
Both exceptions are considered fatal and the container will stop by default, unless this property is set.
479479

480480
See xref:kafka/receiving-messages/message-listener-container.adoc#kafka-container[Using `KafkaMessageListenerContainer`] and xref:kafka/container-props.adoc[Listener Container Properties] for more information.
@@ -537,7 +537,7 @@ See xref:kafka/container-props.adoc[Listener Container Properties] for more info
537537

538538
Error handlers that use a `BackOff` between delivery attempts (e.g. `SeekToCurrentErrorHandler` and `DefaultAfterRollbackProcessor`) will now exit the back off interval soon after the container is stopped, rather than delaying the stop.
539539

540-
Error handlers and after rollback processors that extend `FailedRecordProcessor` can now be configured with one or more `RetryListener` s to receive information about retry and recovery progress.
540+
Error handlers and after rollback processors that extend `FailedRecordProcessor` can now be configured with one or more ``RetryListener``s to receive information about retry and recovery progress.
541541

542542
The `RecordInterceptor` now has additional methods called after the listener returns (normally, or by throwing an exception).
543543
It also has a sub-interface `ConsumerAwareRecordInterceptor`.
@@ -578,7 +578,7 @@ See xref:kafka/transactions.adoc[Transactions] for more information.
578578

579579
There is now a mechanism to examine a reply and fail the future exceptionally if some condition exists.
580580

581-
Support for sending and receiving `spring-messaging` `Message<?>` s has been added.
581+
Support for sending and receiving `spring-messaging` ``Message<?>``s has been added.
582582

583583
See xref:kafka/sending-messages.adoc#replying-template[Using `ReplyingKafkaTemplate`] for more information.
584584

@@ -602,9 +602,9 @@ It is now possible to add a `spring-messaging` `SmartMessageConverter` to the `M
602602
See xref:kafka/serdes.adoc#messaging-message-conversion[Spring Messaging Message Conversion] for more information.
603603

604604
[[x27-sequencing]]
605-
=== Sequencing `@KafkaListener` s
605+
=== Sequencing ``@KafkaListener``s
606606

607-
See xref:kafka/receiving-messages/sequencing.adoc[Starting `@KafkaListener` s in Sequence] for more information.
607+
See xref:kafka/receiving-messages/sequencing.adoc[Starting ``@KafkaListener``s in Sequence] for more information.
608608

609609
[[x27-exp-backoff]]
610610
=== `ExponentialBackOffWithMaxRetries`
@@ -638,7 +638,7 @@ In addition, you can now select the `BackOff` to use based on the failed record
638638
You can now configure an `adviceChain` in the container properties.
639639
See xref:kafka/container-props.adoc[Listener Container Properties] for more information.
640640

641-
When the container is configured to publish `ListenerContainerIdleEvent` s, it now publishes a `ListenerContainerNoLongerIdleEvent` when a record is received after publishing an idle event.
641+
When the container is configured to publish ``ListenerContainerIdleEvent``s, it now publishes a `ListenerContainerNoLongerIdleEvent` when a record is received after publishing an idle event.
642642
See xref:kafka/events.adoc[Application Events] and xref:kafka/events.adoc#idle-containers[Detecting Idle and Non-Responsive Consumers] for more information.
643643

644644
[[kafkalistener-changes]]
@@ -742,7 +742,7 @@ See xref:kafka/annotation-error-handling.adoc#error-handlers[Container Error Han
742742
The `getAssignmentsByClientId()` method has been added, making it easier to determine which consumers in a concurrent container are assigned which partition(s).
743743
See xref:kafka/container-props.adoc[Listener Container Properties] for more information.
744744

745-
You can now suppress logging entire `ConsumerRecord` s in error, debug logs etc.
745+
You can now suppress logging entire ``ConsumerRecord``s in error, debug logs etc.
746746
See `onlyLogRecordMetadata` in xref:kafka/container-props.adoc[Listener Container Properties].
747747

748748
[[x25-template]]
@@ -763,7 +763,7 @@ See xref:kafka/sending-messages.adoc#kafka-template[Using `KafkaTemplate`] for m
763763
[[x25-string-serializer]]
764764
=== Kafka String Serializer/Deserializer
765765

766-
New `ToStringSerializer`/`StringDeserializer` s as well as an associated `SerDe` are now provided.
766+
New `ToStringSerializer`/``StringDeserializer``s as well as an associated `SerDe` are now provided.
767767
See xref:kafka/serdes.adoc#string-serde[String serialization] for more information.
768768

769769
[[x25-json-deser]]
@@ -886,8 +886,8 @@ See xref:kafka/receiving-messages/message-listener-container.adoc#kafka-containe
886886
[[cb-2-2-and-2-3-listener-container-changes]]
887887
=== Listener Container Changes
888888

889-
Previously, error handlers received `ListenerExecutionFailedException` (with the actual listener exception as the `cause`) when the listener was invoked using a listener adapter (such as `@KafkaListener` s).
890-
Exceptions thrown by native `GenericMessageListener` s were passed to the error handler unchanged.
889+
Previously, error handlers received `ListenerExecutionFailedException` (with the actual listener exception as the `cause`) when the listener was invoked using a listener adapter (such as ``@KafkaListener``s).
890+
Exceptions thrown by native ``GenericMessageListener``s were passed to the error handler unchanged.
891891
Now a `ListenerExecutionFailedException` is always the argument (with the actual listener exception as the `cause`), which provides access to the container's `group.id` property.
892892

893893
Because the listener container has it's own mechanism for committing offsets, it prefers the Kafka `ConsumerConfig.ENABLE_AUTO_COMMIT_CONFIG` to be `false`.
@@ -914,7 +914,7 @@ See its JavaDocs and xref:kafka/receiving-messages/message-listener-container.ad
914914
When using `AckMode.MANUAL` (or `MANUAL_IMMEDIATE`) you can now cause a redelivery by calling `nack` on the `Acknowledgment`.
915915
See xref:kafka/receiving-messages/message-listener-container.adoc#committing-offsets[Committing Offsets] for more information.
916916

917-
Listener performance can now be monitored using Micrometer `Timer` s.
917+
Listener performance can now be monitored using Micrometer ``Timer``s.
918918
See xref:kafka/micrometer.adoc[Monitoring] for more information.
919919

920920
The containers now publish additional consumer lifecycle events relating to startup.
@@ -942,7 +942,7 @@ See xref:kafka/annotation-error-handling.adoc#dead-letters[Publishing Dead-lette
942942
[[cb-2-2-and-2-3-topicbuilder]]
943943
=== TopicBuilder
944944

945-
A new class `TopicBuilder` is provided for more convenient creation of `NewTopic` `@Bean` s for automatic topic provisioning.
945+
A new class `TopicBuilder` is provided for more convenient creation of `NewTopic` ``@Bean``s for automatic topic provisioning.
946946
See <<configuring-topics>> for more information.
947947

948948
[[cb-2-2-and-2-3-kafka-streams-changes]]
@@ -971,7 +971,7 @@ Also a `JacksonMimeTypeModule` has been introduced for serialization of `org.spr
971971
See its JavaDocs and xref:kafka/serdes.adoc[Serialization, Deserialization, and Message Conversion] for more information.
972972

973973
A `ByteArrayJsonMessageConverter` has been provided as well as a new super class for all Json converters, `JsonMessageConverter`.
974-
Also, a `StringOrBytesSerializer` is now available; it can serialize `byte[]`, `Bytes` and `String` values in `ProducerRecord` s.
974+
Also, a `StringOrBytesSerializer` is now available; it can serialize `byte[]`, `Bytes` and `String` values in ``ProducerRecord``s.
975975
See xref:kafka/serdes.adoc#messaging-message-conversion[Spring Messaging Message Conversion] for more information.
976976

977977
The `JsonSerializer`, `JsonDeserializer` and `JsonSerde` now have fluent APIs to make programmatic configuration simpler.

spring-kafka-docs/src/main/antora/modules/ROOT/pages/kafka/container-props.adoc

+1-1
Original file line numberDiff line numberDiff line change
@@ -158,7 +158,7 @@ The default executor creates threads named `<name>-C-n`; with the `KafkaMessageL
158158

159159
|[[monitorInterval]]<<monitorInterval,`monitorInterval`>>
160160
|30s
161-
|How often to check the state of the consumer threads for `NonResponsiveConsumerEvent` s.
161+
|How often to check the state of the consumer threads for ``NonResponsiveConsumerEvent``s.
162162
See `noPollThreshold` and `pollTimeout`.
163163

164164
|[[noPollThreshold]]<<noPollThreshold,`noPollThreshold`>>

spring-kafka-docs/src/main/antora/modules/ROOT/pages/kafka/micrometer.adoc

+1-1
Original file line numberDiff line numberDiff line change
@@ -117,5 +117,5 @@ To do so, add a custom `KafkaListenerObservationConvention` and/or `KafkaTemplat
117117
The `record` property in both observation contexts contains the `ConsumerRecord` or `ProducerRecord` respectively.
118118

119119
The sender and receiver contexts `remoteServiceName` properties are set to the Kafka `clusterId` property; this is retrieved by a `KafkaAdmin`.
120-
If, for some reason - perhaps lack of admin permissions, you cannot retrieve the cluster id, starting with version 3.1, you can set a manual `clusterId` on the `KafkaAdmin` and inject it into `KafkaTemplate` s and listener containers.
120+
If, for some reason - perhaps lack of admin permissions, you cannot retrieve the cluster id, starting with version 3.1, you can set a manual `clusterId` on the `KafkaAdmin` and inject it into ``KafkaTemplate``s and listener containers.
121121
When it is `null` (default), the admin will invoke the `describeCluster` admin operation to retrieve it from the broker.

spring-kafka-docs/src/main/antora/modules/ROOT/pages/kafka/receiving-messages/message-listener-container.adoc

+1-1
Original file line numberDiff line numberDiff line change
@@ -82,7 +82,7 @@ return container;
8282

8383
Note that when creating a `DefaultKafkaConsumerFactory`, using the constructor that just takes in the properties as above means that key and value `Deserializer` classes are picked up from configuration.
8484
Alternatively, `Deserializer` instances may be passed to the `DefaultKafkaConsumerFactory` constructor for key and/or value, in which case all Consumers share the same instances.
85-
Another option is to provide `Supplier<Deserializer>` s (starting with version 2.3) that will be used to obtain separate `Deserializer` instances for each `Consumer`:
85+
Another option is to provide ``Supplier<Deserializer>``s (starting with version 2.3) that will be used to obtain separate `Deserializer` instances for each `Consumer`:
8686

8787
[source, java]
8888
----

spring-kafka-docs/src/main/antora/modules/ROOT/pages/kafka/sending-messages.adoc

+2-2
Original file line numberDiff line numberDiff line change
@@ -286,7 +286,7 @@ Calling `reset()` or `destroy()` will not clean up these producers.
286286

287287
Also see xref:kafka/transactions.adoc#tx-template-mixed[`KafkaTemplate` Transactional and non-Transactional Publishing].
288288

289-
When creating a `DefaultKafkaProducerFactory`, key and/or value `Serializer` classes can be picked up from configuration by calling the constructor that only takes in a Map of properties (see example in xref:kafka/sending-messages.adoc#kafka-template[Using `KafkaTemplate`]), or `Serializer` instances may be passed to the `DefaultKafkaProducerFactory` constructor (in which case all `Producer` s share the same instances).
289+
When creating a `DefaultKafkaProducerFactory`, key and/or value `Serializer` classes can be picked up from configuration by calling the constructor that only takes in a Map of properties (see example in xref:kafka/sending-messages.adoc#kafka-template[Using `KafkaTemplate`]), or `Serializer` instances may be passed to the `DefaultKafkaProducerFactory` constructor (in which case all ``Producer``s share the same instances).
290290
Alternatively you can provide `Supplier<Serializer>`+++s+++ (starting with version 2.3) that will be used to obtain separate `Serializer` instances for each `Producer`:
291291

292292
[source, java]
@@ -335,7 +335,7 @@ RequestReplyFuture<K, V, R> sendAndReceive(ProducerRecord<K, V> record,
335335
Duration replyTimeout);
336336
----
337337

338-
(Also see xref:kafka/sending-messages.adoc#exchanging-messages[Request/Reply with `Message<?>` s]).
338+
(Also see xref:kafka/sending-messages.adoc#exchanging-messages[Request/Reply with ``Message<?>``s]).
339339

340340
The result is a `CompletableFuture` that is asynchronously populated with the result (or an exception, for a timeout).
341341
The result also has a `sendFuture` property, which is the result of calling `KafkaTemplate.send()`.

0 commit comments

Comments
 (0)