Merge pull request #78 from async-interop/watcher-activation

trowski · web-flow · commit b0435d221f60 · 2016-06-21T14:02:28.000-05:00
Specify when exactly a watchers callbacks may start to be called
diff --git a/src/Loop/Driver.php b/src/Loop/Driver.php
@@ -107,6 +107,8 @@ public function onSignal($signo, callable $callback, $data = null);
 
     /**
      * Enable a watcher.
+     * 
+     * Watchers (enabling or new watchers) MUST immediately be marked as enabled, but only be activated (i.e. callbacks can be called) right before the next tick. Callbacks of watchers MUST not be called in the tick they were enabled.
      *
      * @param string $watcherId The watcher identifier.
      *

Original file line number	Diff line number	Diff line change
`@@ -107,6 +107,8 @@ public function onSignal($signo, callable $callback, $data = null);`
`107`	`107`
`108`	`108`	`/**`
`109`	`109`	`* Enable a watcher.`
	`110`	`+ *`
	`111`	`+ * Watchers (enabling or new watchers) MUST immediately be marked as enabled, but only be activated (i.e. callbacks can be called) right before the next tick. Callbacks of watchers MUST not be called in the tick they were enabled.`
`110`	`112`	`*`
`111`	`113`	`* @param string $watcherId The watcher identifier.`
`112`	`114`	`*`