From 0852226a4858536a0659cf2b2dfc487da902ecc8 Mon Sep 17 00:00:00 2001
From: Max Kellermann <max@musicpd.org>
Date: Mon, 12 Nov 2018 13:03:09 +0100
Subject: [PATCH] doc/protocol.rst: deprecated `close` and `kill`

---
 doc/protocol.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/doc/protocol.rst b/doc/protocol.rst
index 5d15426eb..8f1abacd8 100644
--- a/doc/protocol.rst
+++ b/doc/protocol.rst
@@ -1069,9 +1069,16 @@ Connection settings
     connection, but that cannot be guaranteed.  This command
     will not generate a response.
 
+    Clients should not use this command; instead, they should just
+    close the socket.
+
 :command:`kill`
     Kills :program:`MPD`.
 
+    Do not use this command.  Send ``SIGTERM`` to :program:`MPD`
+    instead, or better: let your service manager handle :program:`MPD`
+    shutdown (e.g. :command:`systemctl stop mpd`).
+
 :command:`password {PASSWORD}`
     This is used for authentication with the server.
     ``PASSWORD`` is simply the plaintext