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: improve "pause" documentation
71bf1a8a · Max Kellermann · bc47a169 · 71bf1a8a
Commit 71bf1a8a authored Sep 22, 2020 by Max Kellermann
Hide whitespace changes
Inline Side-by-side

Showing with 4 additions and 4 deletions

protocol.rst doc/protocol.rst +4 -4

No files found.
--- 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