commit 7b8f01bbe925507e65561596507d9b8c42eb90a7
author Alexander Brusher <abrusher@google.com> Tue May 17 00:35:44 2022 +0000
committer Fuchsia Internal LUCI <fuchsia-internal-scoped@luci-project-accounts.iam.gserviceaccount.com> Tue May 17 00:35:44 2022 +0000
tree cb00fdab69018f61bcc4be6535e41a8104cb9ddd
parent 6c88f12e63fd786c7b9de7ccc91fedfa84e7087b

[scenic] Update documentation for fuchsia.ui.touch.TouchSource.

This change adds a comment to the TouchSource API to clarify when the
client needs to start responding to events.

Test: n/a
Change-Id: I3b5c7a06dd05971387b017b9a02d15c66c43479b
Reviewed-on: https://fuchsia-review.googlesource.com/c/fuchsia/+/680000
Reviewed-by: Jaeheon Yi <jaeheon@google.com>
API-Review: Jaeheon Yi <jaeheon@google.com>
Commit-Queue: Alexander Brusher <abrusher@google.com>

sdk/fidl/fuchsia.ui.pointer/touch.fidl

diff --git a/sdk/fidl/fuchsia.ui.pointer/touch.fidl b/sdk/fidl/fuchsia.ui.pointer/touch.fidl
index 1f35460..e479bc7 100644
--- a/sdk/fidl/fuchsia.ui.pointer/touch.fidl
+++ b/sdk/fidl/fuchsia.ui.pointer/touch.fidl
@@ -45,7 +45,9 @@
     /// server. Responses for *previous* events are fed to the server on the
     /// *next* call of |Watch| [1]. Each element in the |responses| vector is
     /// interpreted as the pairwise response to the event in the previous
-    /// |events| vector; the vector lengths must match.
+    /// |events| vector; the vector lengths must match. Note that the client's
+    /// contract to respond to events starts as soon as it registers its
+    /// endpoint with scenic, NOT when it first calls `Watch()`.
     ///
     /// Initial response. The first call to |Watch| must be an empty vector.
     ///