Merge pull request amphp#110 from async-interop/issue-95

Define error handler behavior

src/Loop.php

@@ -342,10 +342,14 @@ public static function getState($key)
     /**
      * Set a callback to be executed when an error occurs.
      *
+     * The callback receives the error as the first and only parameter. The return value of the callback gets ignored.
+     * If it can't handle the error, it MUST throw the error. Errors thrown by the callback or during its invocation
+     * MUST be thrown into the `run` loop and stop the driver.
+     *
      * Subsequent calls to this method will overwrite the previous handler.
      *
-     * @param callable(\Throwable|\Exception $error)|null $callback The callback to execute; null will clear the current
-     *     handler.
+     * @param callable(\Throwable|\Exception $error)|null $callback The callback to execute. `null` will clear the
+     *     current handler.
      *
      * @return void
      */

src/Loop/Driver.php

@@ -227,6 +227,10 @@ final public function getState($key)
     /**
      * Set a callback to be executed when an error occurs.
      *
+     * The callback receives the error as the first and only parameter. The return value of the callback gets ignored.
+     * If it can't handle the error, it MUST throw the error. Errors thrown by the callback or during its invocation
+     * MUST be thrown into the `run` loop and stop the driver.
+     *
      * Subsequent calls to this method will overwrite the previous handler.
      *
      * @param callable(\Throwable|\Exception $error)|null $callback The callback to execute. `null` will clear the