comment on song id's vs playlist position commands

git-svn-id: https://svn.musicpd.org/mpd/trunk@1472 09075e82-0dd4-0310-85a5-a0d7c8717e4f

1 files changed, 10 insertions, 0 deletions

diff --git a/doc/COMMANDS b/doc/COMMANDS
index b78735a31..48b1427da 100644
--- a/doc/COMMANDS
+++ b/doc/COMMANDS
@@ -25,6 +25,16 @@ Command Completion:
 A command returns "OK\n" on completion or "ACK some error\n" on failure.
 These denote the end of command execution.
 
+NOTE:
+-----
+
+For manipulating playlists and playing, there are two sets of commands.  One
+set uses the song id of a song in the playlist, while another set uses the
+playlist position of the song.  The commands using song id's should be used
+instead of the commands that manipulate and control playback based on playlist
+position.  Using song id's is a safer method when multiple clients are 
+interacting with MPD.
+
 Commands:
 ---------