From d06ebe2251b2ac75ebc6b63b1580ed15adecd3cc Mon Sep 17 00:00:00 2001
From: wm4 <wm4@nowhere>
Date: Wed, 19 Feb 2020 22:16:26 +0100
Subject: client API: document requirement about PID management

Basically, UNIX sucks. (Not as much as the other POS of course.)
---
 libmpv/client.h | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/libmpv/client.h b/libmpv/client.h
index 2d108ca8d3..2700ad70d9 100644
--- a/libmpv/client.h
+++ b/libmpv/client.h
@@ -144,6 +144,9 @@ extern "C" {
  *   and set it to SIG_IGN.
  * - mpv will reseed the legacy C random number generator by calling srand() at
  *   some random point once.
+ * - mpv may start sub processes, so overriding SIGCHLD, or waiting on all PIDs
+ *   (such as calling wait()) by the parent process or any other library within
+ *   the process must be avoided. libmpv itself only waits for its own PIDs.
  *
  * Encoding of filenames
  * ---------------------
-- 
cgit v1.2.3