From 7adf4cc9b5de6701a41e27690a69b9892d5eed85 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?R=C3=A9mi=20Verschelde?= <rverschelde@gmail.com>
Date: Fri, 30 Jul 2021 15:28:05 +0200
Subject: doc: Use self-closing tags for `return` and `argument`

For the time being we don't support writing a description for those, preferring
having all details in the method's description.

Using self-closing tags saves half the lines, and prevents contributors from
thinking that they should write the argument or return documentation there.
---
 doc/classes/AnimationNodeStateMachine.xml | 153 ++++++++++--------------------
 1 file changed, 51 insertions(+), 102 deletions(-)

(limited to 'doc/classes/AnimationNodeStateMachine.xml')

diff --git a/doc/classes/AnimationNodeStateMachine.xml b/doc/classes/AnimationNodeStateMachine.xml
index 8e070142c4..9921e157f2 100644
--- a/doc/classes/AnimationNodeStateMachine.xml
+++ b/doc/classes/AnimationNodeStateMachine.xml
@@ -22,217 +22,166 @@
 	</tutorials>
 	<methods>
 		<method name="add_node">
-			<return type="void">
-			</return>
-			<argument index="0" name="name" type="StringName">
-			</argument>
-			<argument index="1" name="node" type="AnimationNode">
-			</argument>
-			<argument index="2" name="position" type="Vector2" default="Vector2(0, 0)">
-			</argument>
+			<return type="void" />
+			<argument index="0" name="name" type="StringName" />
+			<argument index="1" name="node" type="AnimationNode" />
+			<argument index="2" name="position" type="Vector2" default="Vector2(0, 0)" />
 			<description>
 				Adds a new node to the graph. The [code]position[/code] is used for display in the editor.
 			</description>
 		</method>
 		<method name="add_transition">
-			<return type="void">
-			</return>
-			<argument index="0" name="from" type="StringName">
-			</argument>
-			<argument index="1" name="to" type="StringName">
-			</argument>
-			<argument index="2" name="transition" type="AnimationNodeStateMachineTransition">
-			</argument>
+			<return type="void" />
+			<argument index="0" name="from" type="StringName" />
+			<argument index="1" name="to" type="StringName" />
+			<argument index="2" name="transition" type="AnimationNodeStateMachineTransition" />
 			<description>
 				Adds a transition between the given nodes.
 			</description>
 		</method>
 		<method name="get_end_node" qualifiers="const">
-			<return type="String">
-			</return>
+			<return type="String" />
 			<description>
 				Returns the graph's end node.
 			</description>
 		</method>
 		<method name="get_graph_offset" qualifiers="const">
-			<return type="Vector2">
-			</return>
+			<return type="Vector2" />
 			<description>
 				Returns the draw offset of the graph. Used for display in the editor.
 			</description>
 		</method>
 		<method name="get_node" qualifiers="const">
-			<return type="AnimationNode">
-			</return>
-			<argument index="0" name="name" type="StringName">
-			</argument>
+			<return type="AnimationNode" />
+			<argument index="0" name="name" type="StringName" />
 			<description>
 				Returns the animation node with the given name.
 			</description>
 		</method>
 		<method name="get_node_name" qualifiers="const">
-			<return type="StringName">
-			</return>
-			<argument index="0" name="node" type="AnimationNode">
-			</argument>
+			<return type="StringName" />
+			<argument index="0" name="node" type="AnimationNode" />
 			<description>
 				Returns the given animation node's name.
 			</description>
 		</method>
 		<method name="get_node_position" qualifiers="const">
-			<return type="Vector2">
-			</return>
-			<argument index="0" name="name" type="StringName">
-			</argument>
+			<return type="Vector2" />
+			<argument index="0" name="name" type="StringName" />
 			<description>
 				Returns the given node's coordinates. Used for display in the editor.
 			</description>
 		</method>
 		<method name="get_start_node" qualifiers="const">
-			<return type="String">
-			</return>
+			<return type="String" />
 			<description>
 				Returns the graph's end node.
 			</description>
 		</method>
 		<method name="get_transition" qualifiers="const">
-			<return type="AnimationNodeStateMachineTransition">
-			</return>
-			<argument index="0" name="idx" type="int">
-			</argument>
+			<return type="AnimationNodeStateMachineTransition" />
+			<argument index="0" name="idx" type="int" />
 			<description>
 				Returns the given transition.
 			</description>
 		</method>
 		<method name="get_transition_count" qualifiers="const">
-			<return type="int">
-			</return>
+			<return type="int" />
 			<description>
 				Returns the number of connections in the graph.
 			</description>
 		</method>
 		<method name="get_transition_from" qualifiers="const">
-			<return type="StringName">
-			</return>
-			<argument index="0" name="idx" type="int">
-			</argument>
+			<return type="StringName" />
+			<argument index="0" name="idx" type="int" />
 			<description>
 				Returns the given transition's start node.
 			</description>
 		</method>
 		<method name="get_transition_to" qualifiers="const">
-			<return type="StringName">
-			</return>
-			<argument index="0" name="idx" type="int">
-			</argument>
+			<return type="StringName" />
+			<argument index="0" name="idx" type="int" />
 			<description>
 				Returns the given transition's end node.
 			</description>
 		</method>
 		<method name="has_node" qualifiers="const">
-			<return type="bool">
-			</return>
-			<argument index="0" name="name" type="StringName">
-			</argument>
+			<return type="bool" />
+			<argument index="0" name="name" type="StringName" />
 			<description>
 				Returns [code]true[/code] if the graph contains the given node.
 			</description>
 		</method>
 		<method name="has_transition" qualifiers="const">
-			<return type="bool">
-			</return>
-			<argument index="0" name="from" type="StringName">
-			</argument>
-			<argument index="1" name="to" type="StringName">
-			</argument>
+			<return type="bool" />
+			<argument index="0" name="from" type="StringName" />
+			<argument index="1" name="to" type="StringName" />
 			<description>
 				Returns [code]true[/code] if there is a transition between the given nodes.
 			</description>
 		</method>
 		<method name="remove_node">
-			<return type="void">
-			</return>
-			<argument index="0" name="name" type="StringName">
-			</argument>
+			<return type="void" />
+			<argument index="0" name="name" type="StringName" />
 			<description>
 				Deletes the given node from the graph.
 			</description>
 		</method>
 		<method name="remove_transition">
-			<return type="void">
-			</return>
-			<argument index="0" name="from" type="StringName">
-			</argument>
-			<argument index="1" name="to" type="StringName">
-			</argument>
+			<return type="void" />
+			<argument index="0" name="from" type="StringName" />
+			<argument index="1" name="to" type="StringName" />
 			<description>
 				Deletes the transition between the two specified nodes.
 			</description>
 		</method>
 		<method name="remove_transition_by_index">
-			<return type="void">
-			</return>
-			<argument index="0" name="idx" type="int">
-			</argument>
+			<return type="void" />
+			<argument index="0" name="idx" type="int" />
 			<description>
 				Deletes the given transition by index.
 			</description>
 		</method>
 		<method name="rename_node">
-			<return type="void">
-			</return>
-			<argument index="0" name="name" type="StringName">
-			</argument>
-			<argument index="1" name="new_name" type="StringName">
-			</argument>
+			<return type="void" />
+			<argument index="0" name="name" type="StringName" />
+			<argument index="1" name="new_name" type="StringName" />
 			<description>
 				Renames the given node.
 			</description>
 		</method>
 		<method name="replace_node">
-			<return type="void">
-			</return>
-			<argument index="0" name="name" type="StringName">
-			</argument>
-			<argument index="1" name="node" type="AnimationNode">
-			</argument>
+			<return type="void" />
+			<argument index="0" name="name" type="StringName" />
+			<argument index="1" name="node" type="AnimationNode" />
 			<description>
 			</description>
 		</method>
 		<method name="set_end_node">
-			<return type="void">
-			</return>
-			<argument index="0" name="name" type="StringName">
-			</argument>
+			<return type="void" />
+			<argument index="0" name="name" type="StringName" />
 			<description>
 				Sets the given node as the graph end point.
 			</description>
 		</method>
 		<method name="set_graph_offset">
-			<return type="void">
-			</return>
-			<argument index="0" name="offset" type="Vector2">
-			</argument>
+			<return type="void" />
+			<argument index="0" name="offset" type="Vector2" />
 			<description>
 				Sets the draw offset of the graph. Used for display in the editor.
 			</description>
 		</method>
 		<method name="set_node_position">
-			<return type="void">
-			</return>
-			<argument index="0" name="name" type="StringName">
-			</argument>
-			<argument index="1" name="position" type="Vector2">
-			</argument>
+			<return type="void" />
+			<argument index="0" name="name" type="StringName" />
+			<argument index="1" name="position" type="Vector2" />
 			<description>
 				Sets the node's coordinates. Used for display in the editor.
 			</description>
 		</method>
 		<method name="set_start_node">
-			<return type="void">
-			</return>
-			<argument index="0" name="name" type="StringName">
-			</argument>
+			<return type="void" />
+			<argument index="0" name="name" type="StringName" />
 			<description>
 				Sets the given node as the graph start point.
 			</description>
-- 
cgit v1.2.3