Mojo: Armed Watchers

mojo/public/c/system/types.h

Index: mojo/public/c/system/types.h
diff --git a/mojo/public/c/system/types.h b/mojo/public/c/system/types.h
index 3482d4e17f23713330fd55d9a63677b127cb2f7f..6aa6187fa979ba49f95817f9a8305f27ab80a7a4 100644
--- a/mojo/public/c/system/types.h
+++ b/mojo/public/c/system/types.h
@@ -182,9 +182,9 @@ struct MOJO_ALIGNAS(4) MojoHandleSignalsState {
 MOJO_STATIC_ASSERT(sizeof(MojoHandleSignalsState) == 8,
                    "MojoHandleSignalsState has wrong size");
 
-// |MojoWatchNotificationFlags|: Passed to a callback invoked as a result of
-// signals being raised on a handle watched by |MojoWatch()|. May take the
-// following values:
+// |MojoWatchNotificationFlags|: Passed to a callback invoked by an armed

[yzshen1, 2017/03/03 00:03:50]

nit: strictly speaking the callback may be called while the watcher is unarmed.

[Ken Rockot(use gerrit already), 2017/03/03 00:37:05]

done

+// watcher when its observed signals are raised. May take the following values:
+//
 //   |MOJO_WATCH_NOTIFICATION_FLAG_FROM_SYSTEM| - The callback is being invoked
 //       as a result of a system-level event rather than a direct API call from
 //       user code. This may be used as an indication that user code is safe to