--- a/doc/upmpdcli.txt
+++ b/doc/upmpdcli.txt
@@ -59,7 +59,10 @@
note>>|||iconpath
|Path to HTML file to be used as presentation
page. <<upmpdcli.presentationnote,See note>>|||presentationhtml
-|Run a command (or shell script) when playback is about to begin.|||onstart
+|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 volume is changed.|||onvolumechange
|===========================