From c6c5a213cd55481b77f87d7f118e223b4b119ba3 Mon Sep 17 00:00:00 2001
From: Hugo Locurcio <hugo.locurcio@hugo.pro>
Date: Tue, 3 Dec 2019 09:34:42 +0100
Subject: [PATCH] Add documentation for the Listener class

---
 doc/classes/Listener.xml | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/doc/classes/Listener.xml b/doc/classes/Listener.xml
index 130263a0692..cd47c758b49 100644
--- a/doc/classes/Listener.xml
+++ b/doc/classes/Listener.xml
@@ -1,8 +1,11 @@
 <?xml version="1.0" encoding="UTF-8" ?>
 <class name="Listener" inherits="Spatial" category="Core" version="3.2">
 	<brief_description>
+		Overrides the location sounds are heard from.
 	</brief_description>
 	<description>
+		Once added to the scene tree and enabled using [method make_current], this node will override the location sounds are heard from. This can be used to listen from a location different from the [member Camera].
+		[b]Note:[/b] There is no 2D equivalent for this node yet.
 	</description>
 	<tutorials>
 	</tutorials>
@@ -11,24 +14,29 @@
 			<return type="void">
 			</return>
 			<description>
+				Disables the listener to use the current camera's listener instead.
 			</description>
 		</method>
 		<method name="get_listener_transform" qualifiers="const">
 			<return type="Transform">
 			</return>
 			<description>
+				Returns the listener's global orthonormalized [Transform].
 			</description>
 		</method>
 		<method name="is_current" qualifiers="const">
 			<return type="bool">
 			</return>
 			<description>
+				Returns [code]true[/code] if the listener was made current using [method]make_current[/method), [code]false[/code] otherwise.
+				[b]Note:[/b] There may be more than one Listener marked as "current" in the scene tree, but only the one that was made current last will be used.
 			</description>
 		</method>
 		<method name="make_current">
 			<return type="void">
 			</return>
 			<description>
+				Enables the listener. This will override the current camera's listener.
 			</description>
 		</method>
 	</methods>