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
This commit is contained in:
Max Kellermann 2020-09-22 20:05:06 +02:00
parent bc47a16943
commit 71bf1a8a3d
1 changed files with 4 additions and 4 deletions

View File

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