Clarify add_event_handler in docs

doc/source/classes/class_limbostate.rst

@@ -274,9 +274,9 @@ Registers a ``handler`` to be called when ``event`` is dispatched. The handler f
 
 ::
 
-    func my_event_handler(cargo=null) -> void:
+    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
 

doc_classes/LimboState.xml

@@ -43,9 +43,9 @@
 			<description>
 				Registers a [param handler] to be called when [param event] is dispatched. The handler function should have the following signature:
 				[codeblock]
-				func my_event_handler(cargo=null) -> void:
+				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">