diff --git a/PBot/EventDispatcher.pm b/PBot/EventDispatcher.pm
index a24c9cde..2387ae77 100644
--- a/PBot/EventDispatcher.pm
+++ b/PBot/EventDispatcher.pm
@@ -105,7 +105,10 @@ sub dispatch_event {
         }
     }
 
-    # return event handler result
+    # return dispatch result. if at least one event handler returned a defined
+    # value, then this event is considered handled. if there were no handlers
+    # or if all of the available handers returned undef then this value will
+    # be undef.
     return $dispatch_result;
 }