docs(pubsub): fix comments on message for exactly once delivery (#6878)

Fixes #6877
googleapis · Oct 17, 2022 · a8109e2 · a8109e2
1 parent 43cc5bc
commit a8109e2
Showing 1 changed file with 4 additions and 2 deletions.
diff --git a/pubsub/message.go b/pubsub/message.go
@@ -37,8 +37,10 @@ import (
 //
 // If using exactly once delivery, you should call Message.AckWithResult and
 // Message.NackWithResult instead. These methods will return an AckResult,
-// which you should wait on to obtain the status of the Ack/Nack to ensure
-// these were properly processed by the server. If not,
+// which tracks the state of acknowledgement operation. If the AckResult returns
+// successful, the message is guaranteed NOT to be re-delivered. Otherwise,
+// the AckResult will return an error with more details about the failure
+// and the message may be re-delivered.
 type Message = ipubsub.Message
 
 // msgAckHandler performs a safe cast of the message's ack handler to psAckHandler.