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:
parent
bca9678683
commit
3c955639a7
|
@ -389,7 +389,9 @@ Querying :program:`MPD`'s status
|
||||||
|
|
||||||
:command:`currentsong`
|
:command:`currentsong`
|
||||||
Displays the song info of the current song (same song that
|
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:
|
.. _command_idle:
|
||||||
|
|
||||||
|
|
Loading…
Reference in New Issue