From 825252dfc8b18b76599ad1298915c7e0d0d5455c Mon Sep 17 00:00:00 2001
From: Warren Dukes <warren.dukes@gmail.com>
Date: Sun, 13 Jun 2004 21:13:30 +0000
Subject: [PATCH] comment on song id's vs playlist position commands

git-svn-id: https://svn.musicpd.org/mpd/trunk@1472 09075e82-0dd4-0310-85a5-a0d7c8717e4f
---
 doc/COMMANDS | 10 ++++++++++
 1 file changed, 10 insertions(+)

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:
 ---------