- * \return On success, the number of the received signal is returned. If the
- * read returned zero or was interrupted by another signal the function returns
- * 0. Otherwise, a negative error value is returned.
+ * \return On success, the number of the received signal is returned. If there
+ * is no signal currently pending, the function returns zero. On read errors
+ * from the signal pipe, the process is terminated.