From 7c728f0ee4b4c6f890e5258055bec5dd9dba8c1e Mon Sep 17 00:00:00 2001
From: Hugo Locurcio <hugo.locurcio@hugo.pro>
Date: Wed, 15 Jul 2020 16:31:10 +0200
Subject: [PATCH] Add an example for creating a button in the Button class
 documentation

This closes https://github.com/godotengine/godot-docs/issues/3798.

(cherry picked from commit 8836c7203b1dd3a4a31db7a769cc656b87c240b4)
---
 doc/classes/Button.xml | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/doc/classes/Button.xml b/doc/classes/Button.xml
index ac2b77f40eb..ede9c387c92 100644
--- a/doc/classes/Button.xml
+++ b/doc/classes/Button.xml
@@ -5,6 +5,18 @@
 	</brief_description>
 	<description>
 		Button is the standard themed button. It can contain text and an icon, and will display them according to the current [Theme].
+		[b]Example of creating a button and assigning an action when pressed by code:[/b]
+		[codeblock]
+		func _ready():
+		    var button = Button.new()
+		    button.text = "Click me"
+		    button.connect("pressed", self, "_button_pressed")
+		    add_child(button)
+
+		func _button_pressed():
+		    print("Hello world!")
+		[/codeblock]
+		Buttons (like all Control nodes) can also be created in the editor, but some situations may require creating them from code.
 	</description>
 	<tutorials>
 	</tutorials>