- * Set a notifier callback for the stream indicated by `stream' to be called
- * when some action takes place on the stream. This effectively means
- * scheduling the stream for various actions, that then eventually will
- * be delivered to caller in the `notifier' callback. It is called for
- * example when data is available for reading or writing, or if an error
- * occurs. This can be called at any time for valid stream.
+ * Schedule `stream' for stream events. Set the `notifier' callback to
+ * be called when some event takes place on the stream. The event will
+ * be delievered to the `notifier' callback with the `context'. It is
+ * called for example when data is available for reading or writing, or
+ * if an error occurs. This can be called at any time for valid stream.
+ * This call will also set the `stream' into non-blocking mode.
+ *