From d10e578a5da67bb61f9c1684cd017f8043e37632 Mon Sep 17 00:00:00 2001
From: RedMser <redmser.jj2@gmail.com>
Date: Sun, 23 Mar 2025 22:20:19 +0100
Subject: [PATCH] Clarify that custom_action is only triggered if action is
 non-empty

---
 doc/classes/AcceptDialog.xml | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/doc/classes/AcceptDialog.xml b/doc/classes/AcceptDialog.xml
index 198429831ea..179bd7ac05b 100644
--- a/doc/classes/AcceptDialog.xml
+++ b/doc/classes/AcceptDialog.xml
@@ -15,7 +15,8 @@
 			<param index="1" name="right" type="bool" default="false" />
 			<param index="2" name="action" type="String" default="&quot;&quot;" />
 			<description>
-				Adds a button with label [param text] and a custom [param action] to the dialog and returns the created button. [param action] will be passed to the [signal custom_action] signal when pressed.
+				Adds a button with label [param text] and a custom [param action] to the dialog and returns the created button.
+				If [param action] is not empty, pressing the button will emit the [signal custom_action] signal with the specified action string.
 				If [code]true[/code], [param right] will place the button to the right of any sibling buttons.
 				You can use [method remove_button] method to remove a button created with this method from the dialog.
 			</description>
@@ -95,7 +96,7 @@
 		<signal name="custom_action">
 			<param index="0" name="action" type="StringName" />
 			<description>
-				Emitted when a custom button is pressed. See [method add_button].
+				Emitted when a custom button with an action is pressed. See [method add_button].
 			</description>
 		</signal>
 	</signals>