From 25662b428e30f06385386e7f840e45fac13e7f4e Mon Sep 17 00:00:00 2001 From: Grant Wu Date: Thu, 25 Apr 2019 08:14:34 +0300 Subject: [PATCH] Clarify initial subscription positioning (#4126) --- site2/docs/concepts-clients.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/site2/docs/concepts-clients.md b/site2/docs/concepts-clients.md index 4048708c3f6ac..ec767470b5567 100644 --- a/site2/docs/concepts-clients.md +++ b/site2/docs/concepts-clients.md @@ -23,7 +23,7 @@ Whenever the TCP connection breaks, the client will immediately re-initiate this ## Reader interface -In Pulsar, the "standard" [consumer interface](concepts-messaging.md#consumers) involves using consumers to listen on [topics](reference-terminology.md#topic), process incoming messages, and finally acknowledge those messages when they've been processed. Whenever a consumer connects to a topic, it automatically begins reading from the earliest un-acked message onward because the topic's cursor is automatically managed by Pulsar. +In Pulsar, the "standard" [consumer interface](concepts-messaging.md#consumers) involves using consumers to listen on [topics](reference-terminology.md#topic), process incoming messages, and finally acknowledge those messages when they've been processed. Whenever a new subscription is created, it is initially positioned at the end of the topic (by default), and consumers associated with that subscription will begin reading with the first message created afterwards. Whenever a consumer connects to a topic using a pre-existing subscription, it begins reading from the earliest message un-acked within that subscription. In summary, with the consumer interface, subscription cursors are automatically managed by Pulsar in response to [message acknowledgements](concepts-messaging.md#acknowledgement). The **reader interface** for Pulsar enables applications to manually manage cursors. When you use a reader to connect to a topic---rather than a consumer---you need to specify *which* message the reader begins reading from when it connects to a topic. When connecting to a topic, the reader interface enables you to begin with: