doc: Document required order of currentsong response

The parser implemented in libmpdclient requires the first key-value pair
of the server response to be the file pair. This is due to the fact that
libmpdclient scan pairs sequentially and first attempts to extract the
file pair before parsing the currentsong response further. See:

	5c751a761e/src/song.c (L559-L563)

Meta data encoded as pairs in the currentsong response will be ignored
if they are placed before the file pair in the response.
This commit is contained in:
Sören Tempel 2020-04-27 17:47:24 +02:00
parent bca9678683
commit 3c955639a7
1 changed files with 3 additions and 1 deletions

View File

@ -389,7 +389,9 @@ Querying :program:`MPD`'s status
:command:`currentsong`
Displays the song info of the current song (same song that
is identified in status).
is identified in status). Information about the current song
is represented by key-value pairs, one on each line. The first
pair must be the `file` key-value pair.
.. _command_idle: