From 71bf1a8a3d762f916d2a7ca77545581afd91db5f Mon Sep 17 00:00:00 2001
From: Max Kellermann <max@musicpd.org>
Date: Tue, 22 Sep 2020 20:05:06 +0200
Subject: [PATCH] doc/protocol.rst: improve "pause" documentation

And un-deprecate "pause" without parameter (toggles pause).  I have no
idea why it was deprecated long ago; the deprecation notice was copied
from the ancient MPD wiki.

Closes https://github.com/MusicPlayerDaemon/MPD/issues/944
---
 doc/protocol.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/doc/protocol.rst b/doc/protocol.rst
index 200d5dcf6..bcbe16155 100644
--- a/doc/protocol.rst
+++ b/doc/protocol.rst
@@ -556,10 +556,10 @@ Controlling playback
 :command:`next`
     Plays next song in the playlist.
 
-:command:`pause {PAUSE}`
-    Toggles pause/resumes playing, ``PAUSE`` is 0 or 1.
-
-    The use of pause command without the PAUSE argument is deprecated.
+:command:`pause {STATE}`
+    Pause or resume playback.  Pass :samp:`1` to pause playback or
+    :samp:`0` to resume playback.  Without the parameter, the pause
+    state is toggled.
 
 :command:`play [SONGPOS]`
     Begins playing the playlist at song number