diff --git a/doc/source/classes/class_limbostate.rst b/doc/source/classes/class_limbostate.rst
index ab66183..39ab51d 100644
--- a/doc/source/classes/class_limbostate.rst
+++ b/doc/source/classes/class_limbostate.rst
@@ -276,7 +276,7 @@ Registers a ``handler`` to be called when ``event`` is dispatched. The handler f
 
     func my_event_handler(cargo=null) -> bool:
 
-Cargo is an optional parameter that can be passed to the handler. See also :ref:`dispatch<class_LimboState_method_dispatch>`.
+If the handler returns ``true``, the event will be consumed. Cargo is an optional parameter that can be passed to the handler. See also :ref:`dispatch<class_LimboState_method_dispatch>`.
 
 .. rst-class:: classref-item-separator
 
diff --git a/doc_classes/LimboState.xml b/doc_classes/LimboState.xml
index a215d31..dee6f47 100644
--- a/doc_classes/LimboState.xml
+++ b/doc_classes/LimboState.xml
@@ -45,7 +45,7 @@
 				[codeblock]
 				func my_event_handler(cargo=null) -> bool:
 				[/codeblock]
-				Cargo is an optional parameter that can be passed to the handler. See also [method dispatch].
+				If the handler returns [code]true[/code], the event will be consumed. Cargo is an optional parameter that can be passed to the handler. See also [method dispatch].
 			</description>
 		</method>
 		<method name="call_on_enter">