--- a/doc/upmpdcli.txt
+++ b/doc/upmpdcli.txt
@@ -62,8 +62,12 @@
|Run a command (or shell script) when a play action is performed. The difference
to onplay is that onstart is called *before* playback is about to begin.|||
onstart
-|Run a command (or shell script) when playback is about to begin.|||onplay
-|Run a command (or shell script) when playback is about to end.|||onstop
+|Run a command (or shell script) when MPD playback is about to begin. Note that
+ onstart is also called if MPD is controlled from another tool, e.g. by mpc.|||
+ onplay
+|Run a command (or shell script) when MPD playback is about to end. Note that
+ onstart is also called if MPD is controlled from another tool, e.g. by mpc.|||
+ onstop
|Run a command (or shell script) when volume is changed.|||onvolumechange
|===========================