Clarify that modify_ack_deadline resets the deadline (googleapis#4822)

opyate · Jon Wayne Parrott · commit 72445f130f1a · 2018-02-05T13:39:09.000-08:00
diff --git a/pubsub/google/cloud/pubsub_v1/subscriber/message.py b/pubsub/google/cloud/pubsub_v1/subscriber/message.py
@@ -223,18 +223,15 @@ def lease(self):
         )
 
     def modify_ack_deadline(self, seconds):
-        """Set the deadline for acknowledgement to the given value.
+        """Resets the deadline for acknowledgement.
+	
+	New deadline will be the given value of seconds from now.
 
         The default implementation handles this for you; you should not need
         to manually deal with setting ack deadlines. The exception case is
         if you are implementing your own custom subclass of
         :class:`~.pubsub_v1.subcriber._consumer.Consumer`.
 
-        .. note::
-            This is not an extension; it *sets* the deadline to the given
-            number of seconds from right now. It is even possible to use this
-            method to make a deadline shorter.
-
         Args:
             seconds (int): The number of seconds to set the lease deadline
                 to. This should be between 0 and 600. Due to network latency,
