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