From bd63402ed62b982b3e5f0e962584aed3f4c76137 Mon Sep 17 00:00:00 2001
From: Hugo Locurcio <hugo.locurcio@hugo.pro>
Date: Sun, 25 Jul 2021 22:43:02 +0200
Subject: [PATCH] Document caveats with Control's
 `mouse_entered`/`mouse_exited` signals

(cherry picked from commit 37c1cbdcb217ffe59444660dae11cbb76c6ac20f)
---
 doc/classes/Control.xml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/doc/classes/Control.xml b/doc/classes/Control.xml
index ce5a8ecd87..b3f2a203d1 100644
--- a/doc/classes/Control.xml
+++ b/doc/classes/Control.xml
@@ -969,11 +969,13 @@
 		<signal name="mouse_entered">
 			<description>
 				Emitted when the mouse enters the control's [code]Rect[/code] area, provided its [member mouse_filter] lets the event reach it.
+				[b]Note:[/b] [signal mouse_entered] will not be emitted if the mouse enters a child [Control] node before entering the parent's [code]Rect[/code] area, at least until the mouse is moved to reach the parent's [code]Rect[/code] area.
 			</description>
 		</signal>
 		<signal name="mouse_exited">
 			<description>
 				Emitted when the mouse leaves the control's [code]Rect[/code] area, provided its [member mouse_filter] lets the event reach it.
+				[b]Note:[/b] [signal mouse_exited] will be emitted if the mouse enters a child [Control] node, even if the mouse cursor is still inside the parent's [code]Rect[/code] area.
 			</description>
 		</signal>
 		<signal name="resized">