diff --git a/libmpv/client.h b/libmpv/client.h
index 11b27b26df..85b1900068 100644
--- a/libmpv/client.h
+++ b/libmpv/client.h
@@ -117,6 +117,8 @@ extern "C" {
  *   (used through libass), ALSA, FFmpeg, and possibly more.
  * - The FPU precision must be set at least to double precision.
  * - On Windows, mpv will call timeBeginPeriod(1).
+ * - SIGPIPE should be blocked. Some parts rely on this signal not crashing the
+ *   process (such as ffmpeg OpenSSL support, or the mpv IPC code).
  * - On memory exhaustion, mpv will kill the process.
  *
  * Embedding the video window
diff --git a/osdep/terminal-unix.c b/osdep/terminal-unix.c
index 85908c551a..bc0dc8336b 100644
--- a/osdep/terminal-unix.c
+++ b/osdep/terminal-unix.c
@@ -488,7 +488,7 @@ int terminal_init(void)
     setsigaction(SIGTTIN, SIG_IGN, 0, true);
     setsigaction(SIGTTOU, SIG_IGN, 0, true);
 
-    // don't crash on SIGPIPE caused by semi-broken libraries
+    // get sane behavior, instead of hysteric UNIX-nonsense
     setsigaction(SIGPIPE, SIG_IGN, 0, true);
 
     getch2_poll();