- * @warning If your program runs on Unix and makes use of signal handlers,
- * note that this function will repeat blocking system calls that
- * are interrupted by a signal and return with EINTR. If your program
- * needs to abort blocking reads when a signal is handled, you will
- * need to implement your own loop using sp_nonblocking_read()
+ * @warning If your program runs on Unix, defines its own signal handlers, and
+ * needs to abort blocking writes when these are called, then you
+ * should not use this function. It repeats system calls that return
+ * with EINTR. To be able to abort a write from a signal handler, you
+ * should implement your own blocking write using sp_nonblocking_write()