From 7e9a51cdd5b8eb14c51250ddf6207ad315c46620 Mon Sep 17 00:00:00 2001
From: Hugo Locurcio <hugo.locurcio@hugo.pro>
Date: Fri, 17 Jul 2020 00:01:24 +0200
Subject: [PATCH] Mention `toggled` signal for pressed state in BaseButton
 documentation

This closes #40455.

(cherry picked from commit 43dae28e9db1d3e6355ee1105075dd4a7d963dd2)
---
 doc/classes/BaseButton.xml | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/doc/classes/BaseButton.xml b/doc/classes/BaseButton.xml
index 7d6281efbba..85178146d71 100644
--- a/doc/classes/BaseButton.xml
+++ b/doc/classes/BaseButton.xml
@@ -13,7 +13,7 @@
 			<return type="void">
 			</return>
 			<description>
-				Called when the button is pressed.
+				Called when the button is pressed. If you need to know the button's pressed state (and [member toggle_mode] is active), use [method _toggled] instead.
 			</description>
 		</method>
 		<method name="_toggled" qualifiers="virtual">
@@ -89,6 +89,7 @@
 		<signal name="pressed">
 			<description>
 				Emitted when the button is toggled or pressed. This is on [signal button_down] if [member action_mode] is [constant ACTION_MODE_BUTTON_PRESS] and on [signal button_up] otherwise.
+				If you need to know the button's pressed state (and [member toggle_mode] is active), use [signal toggled] instead.
 			</description>
 		</signal>
 		<signal name="toggled">