From 0657d439607c47f70bde10214c661eb79f8c7b1c Mon Sep 17 00:00:00 2001
From: George Marques <george@gmarqu.es>
Date: Fri, 17 Jun 2016 20:35:27 -0300
Subject: [PATCH] Better document the BaseButton signals

(cherry picked from commit 141360ed82c2eff634cdee3a7823465937876484)
---
 doc/base/classes.xml | 14 ++++++++++++--
 1 file changed, 12 insertions(+), 2 deletions(-)

diff --git a/doc/base/classes.xml b/doc/base/classes.xml
index 3701de1ec0b..56eeaf6acaf 100644
--- a/doc/base/classes.xml
+++ b/doc/base/classes.xml
@@ -5912,14 +5912,24 @@
 		</method>
 	</methods>
 	<signals>
+		<signal name="button_down">
+			<description>
+				Emitted when the button starts being held down.
+			</description>
+		</signal>
+		<signal name="button_up">
+			<description>
+				Emitted when the button stops being held down.
+			</description>
+		</signal>
 		<signal name="pressed">
 			<description>
-				This signal is emitted every time the button is pressed or toggled.
+				This signal is emitted every time the button is toggled or pressed (i.e. activated, so on [code]button_down[/code] if "Click on press" is active and on [code]button_up[/code] otherwise).
 			</description>
 		</signal>
 		<signal name="released">
 			<description>
-				This signal is emitted when the button was released.
+				Emitted when the button was released. This is only emitted by non-toggle buttons and if "Click on press" is active.
 			</description>
 		</signal>
 		<signal name="toggled">