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.
---
 modules/gltf/doc_classes/GLTFSkeleton.xml    |  30 ++----
 modules/gltf/doc_classes/GLTFSkin.xml        |  27 ++---
 modules/gltf/doc_classes/GLTFState.xml       | 153 +++++++++------------------
 modules/gltf/doc_classes/PackedSceneGLTF.xml |  45 +++-----
 4 files changed, 85 insertions(+), 170 deletions(-)

(limited to 'modules/gltf/doc_classes')

diff --git a/modules/gltf/doc_classes/GLTFSkeleton.xml b/modules/gltf/doc_classes/GLTFSkeleton.xml
index 40563c9ac6..6e83cec252 100644
--- a/modules/gltf/doc_classes/GLTFSkeleton.xml
+++ b/modules/gltf/doc_classes/GLTFSkeleton.xml
@@ -8,50 +8,40 @@
 	</tutorials>
 	<methods>
 		<method name="get_bone_attachment">
-			<return type="BoneAttachment3D">
-			</return>
-			<argument index="0" name="idx" type="int">
-			</argument>
+			<return type="BoneAttachment3D" />
+			<argument index="0" name="idx" type="int" />
 			<description>
 			</description>
 		</method>
 		<method name="get_bone_attachment_count">
-			<return type="int">
-			</return>
+			<return type="int" />
 			<description>
 			</description>
 		</method>
 		<method name="get_godot_bone_node">
-			<return type="Dictionary">
-			</return>
+			<return type="Dictionary" />
 			<description>
 			</description>
 		</method>
 		<method name="get_godot_skeleton">
-			<return type="Skeleton3D">
-			</return>
+			<return type="Skeleton3D" />
 			<description>
 			</description>
 		</method>
 		<method name="get_unique_names">
-			<return type="Array">
-			</return>
+			<return type="Array" />
 			<description>
 			</description>
 		</method>
 		<method name="set_godot_bone_node">
-			<return type="void">
-			</return>
-			<argument index="0" name="godot_bone_node" type="Dictionary">
-			</argument>
+			<return type="void" />
+			<argument index="0" name="godot_bone_node" type="Dictionary" />
 			<description>
 			</description>
 		</method>
 		<method name="set_unique_names">
-			<return type="void">
-			</return>
-			<argument index="0" name="unique_names" type="Array">
-			</argument>
+			<return type="void" />
+			<argument index="0" name="unique_names" type="Array" />
 			<description>
 			</description>
 		</method>
diff --git a/modules/gltf/doc_classes/GLTFSkin.xml b/modules/gltf/doc_classes/GLTFSkin.xml
index e20e127e52..107ca960cd 100644
--- a/modules/gltf/doc_classes/GLTFSkin.xml
+++ b/modules/gltf/doc_classes/GLTFSkin.xml
@@ -8,44 +8,35 @@
 	</tutorials>
 	<methods>
 		<method name="get_inverse_binds">
-			<return type="Array">
-			</return>
+			<return type="Array" />
 			<description>
 			</description>
 		</method>
 		<method name="get_joint_i_to_bone_i">
-			<return type="Dictionary">
-			</return>
+			<return type="Dictionary" />
 			<description>
 			</description>
 		</method>
 		<method name="get_joint_i_to_name">
-			<return type="Dictionary">
-			</return>
+			<return type="Dictionary" />
 			<description>
 			</description>
 		</method>
 		<method name="set_inverse_binds">
-			<return type="void">
-			</return>
-			<argument index="0" name="inverse_binds" type="Array">
-			</argument>
+			<return type="void" />
+			<argument index="0" name="inverse_binds" type="Array" />
 			<description>
 			</description>
 		</method>
 		<method name="set_joint_i_to_bone_i">
-			<return type="void">
-			</return>
-			<argument index="0" name="joint_i_to_bone_i" type="Dictionary">
-			</argument>
+			<return type="void" />
+			<argument index="0" name="joint_i_to_bone_i" type="Dictionary" />
 			<description>
 			</description>
 		</method>
 		<method name="set_joint_i_to_name">
-			<return type="void">
-			</return>
-			<argument index="0" name="joint_i_to_name" type="Dictionary">
-			</argument>
+			<return type="void" />
+			<argument index="0" name="joint_i_to_name" type="Dictionary" />
 			<description>
 			</description>
 		</method>
diff --git a/modules/gltf/doc_classes/GLTFState.xml b/modules/gltf/doc_classes/GLTFState.xml
index a7b5b7b43e..ae976fc04c 100644
--- a/modules/gltf/doc_classes/GLTFState.xml
+++ b/modules/gltf/doc_classes/GLTFState.xml
@@ -8,236 +8,185 @@
 	</tutorials>
 	<methods>
 		<method name="get_accessors">
-			<return type="Array">
-			</return>
+			<return type="Array" />
 			<description>
 			</description>
 		</method>
 		<method name="get_animation_player">
-			<return type="AnimationPlayer">
-			</return>
-			<argument index="0" name="idx" type="int">
-			</argument>
+			<return type="AnimationPlayer" />
+			<argument index="0" name="idx" type="int" />
 			<description>
 			</description>
 		</method>
 		<method name="get_animation_players_count">
-			<return type="int">
-			</return>
-			<argument index="0" name="idx" type="int">
-			</argument>
+			<return type="int" />
+			<argument index="0" name="idx" type="int" />
 			<description>
 			</description>
 		</method>
 		<method name="get_animations">
-			<return type="Array">
-			</return>
+			<return type="Array" />
 			<description>
 			</description>
 		</method>
 		<method name="get_buffer_views">
-			<return type="Array">
-			</return>
+			<return type="Array" />
 			<description>
 			</description>
 		</method>
 		<method name="get_cameras">
-			<return type="Array">
-			</return>
+			<return type="Array" />
 			<description>
 			</description>
 		</method>
 		<method name="get_images">
-			<return type="Array">
-			</return>
+			<return type="Array" />
 			<description>
 			</description>
 		</method>
 		<method name="get_lights">
-			<return type="Array">
-			</return>
+			<return type="Array" />
 			<description>
 			</description>
 		</method>
 		<method name="get_materials">
-			<return type="Array">
-			</return>
+			<return type="Array" />
 			<description>
 			</description>
 		</method>
 		<method name="get_meshes">
-			<return type="Array">
-			</return>
+			<return type="Array" />
 			<description>
 			</description>
 		</method>
 		<method name="get_nodes">
-			<return type="Array">
-			</return>
+			<return type="Array" />
 			<description>
 			</description>
 		</method>
 		<method name="get_scene_node">
-			<return type="Node">
-			</return>
-			<argument index="0" name="idx" type="int">
-			</argument>
+			<return type="Node" />
+			<argument index="0" name="idx" type="int" />
 			<description>
 			</description>
 		</method>
 		<method name="get_skeleton_to_node">
-			<return type="Dictionary">
-			</return>
+			<return type="Dictionary" />
 			<description>
 			</description>
 		</method>
 		<method name="get_skeletons">
-			<return type="Array">
-			</return>
+			<return type="Array" />
 			<description>
 			</description>
 		</method>
 		<method name="get_skins">
-			<return type="Array">
-			</return>
+			<return type="Array" />
 			<description>
 			</description>
 		</method>
 		<method name="get_textures">
-			<return type="Array">
-			</return>
+			<return type="Array" />
 			<description>
 			</description>
 		</method>
 		<method name="get_unique_animation_names">
-			<return type="Array">
-			</return>
+			<return type="Array" />
 			<description>
 			</description>
 		</method>
 		<method name="get_unique_names">
-			<return type="Array">
-			</return>
+			<return type="Array" />
 			<description>
 			</description>
 		</method>
 		<method name="set_accessors">
-			<return type="void">
-			</return>
-			<argument index="0" name="accessors" type="Array">
-			</argument>
+			<return type="void" />
+			<argument index="0" name="accessors" type="Array" />
 			<description>
 			</description>
 		</method>
 		<method name="set_animations">
-			<return type="void">
-			</return>
-			<argument index="0" name="animations" type="Array">
-			</argument>
+			<return type="void" />
+			<argument index="0" name="animations" type="Array" />
 			<description>
 			</description>
 		</method>
 		<method name="set_buffer_views">
-			<return type="void">
-			</return>
-			<argument index="0" name="buffer_views" type="Array">
-			</argument>
+			<return type="void" />
+			<argument index="0" name="buffer_views" type="Array" />
 			<description>
 			</description>
 		</method>
 		<method name="set_cameras">
-			<return type="void">
-			</return>
-			<argument index="0" name="cameras" type="Array">
-			</argument>
+			<return type="void" />
+			<argument index="0" name="cameras" type="Array" />
 			<description>
 			</description>
 		</method>
 		<method name="set_images">
-			<return type="void">
-			</return>
-			<argument index="0" name="images" type="Array">
-			</argument>
+			<return type="void" />
+			<argument index="0" name="images" type="Array" />
 			<description>
 			</description>
 		</method>
 		<method name="set_lights">
-			<return type="void">
-			</return>
-			<argument index="0" name="lights" type="Array">
-			</argument>
+			<return type="void" />
+			<argument index="0" name="lights" type="Array" />
 			<description>
 			</description>
 		</method>
 		<method name="set_materials">
-			<return type="void">
-			</return>
-			<argument index="0" name="materials" type="Array">
-			</argument>
+			<return type="void" />
+			<argument index="0" name="materials" type="Array" />
 			<description>
 			</description>
 		</method>
 		<method name="set_meshes">
-			<return type="void">
-			</return>
-			<argument index="0" name="meshes" type="Array">
-			</argument>
+			<return type="void" />
+			<argument index="0" name="meshes" type="Array" />
 			<description>
 			</description>
 		</method>
 		<method name="set_nodes">
-			<return type="void">
-			</return>
-			<argument index="0" name="nodes" type="Array">
-			</argument>
+			<return type="void" />
+			<argument index="0" name="nodes" type="Array" />
 			<description>
 			</description>
 		</method>
 		<method name="set_skeleton_to_node">
-			<return type="void">
-			</return>
-			<argument index="0" name="skeleton_to_node" type="Dictionary">
-			</argument>
+			<return type="void" />
+			<argument index="0" name="skeleton_to_node" type="Dictionary" />
 			<description>
 			</description>
 		</method>
 		<method name="set_skeletons">
-			<return type="void">
-			</return>
-			<argument index="0" name="skeletons" type="Array">
-			</argument>
+			<return type="void" />
+			<argument index="0" name="skeletons" type="Array" />
 			<description>
 			</description>
 		</method>
 		<method name="set_skins">
-			<return type="void">
-			</return>
-			<argument index="0" name="skins" type="Array">
-			</argument>
+			<return type="void" />
+			<argument index="0" name="skins" type="Array" />
 			<description>
 			</description>
 		</method>
 		<method name="set_textures">
-			<return type="void">
-			</return>
-			<argument index="0" name="textures" type="Array">
-			</argument>
+			<return type="void" />
+			<argument index="0" name="textures" type="Array" />
 			<description>
 			</description>
 		</method>
 		<method name="set_unique_animation_names">
-			<return type="void">
-			</return>
-			<argument index="0" name="unique_animation_names" type="Array">
-			</argument>
+			<return type="void" />
+			<argument index="0" name="unique_animation_names" type="Array" />
 			<description>
 			</description>
 		</method>
 		<method name="set_unique_names">
-			<return type="void">
-			</return>
-			<argument index="0" name="unique_names" type="Array">
-			</argument>
+			<return type="void" />
+			<argument index="0" name="unique_names" type="Array" />
 			<description>
 			</description>
 		</method>
diff --git a/modules/gltf/doc_classes/PackedSceneGLTF.xml b/modules/gltf/doc_classes/PackedSceneGLTF.xml
index a22111e9b7..d0136c6402 100644
--- a/modules/gltf/doc_classes/PackedSceneGLTF.xml
+++ b/modules/gltf/doc_classes/PackedSceneGLTF.xml
@@ -8,44 +8,29 @@
 	</tutorials>
 	<methods>
 		<method name="export_gltf">
-			<return type="int" enum="Error">
-			</return>
-			<argument index="0" name="node" type="Node">
-			</argument>
-			<argument index="1" name="path" type="String">
-			</argument>
-			<argument index="2" name="flags" type="int" default="0">
-			</argument>
-			<argument index="3" name="bake_fps" type="float" default="1000.0">
-			</argument>
+			<return type="int" enum="Error" />
+			<argument index="0" name="node" type="Node" />
+			<argument index="1" name="path" type="String" />
+			<argument index="2" name="flags" type="int" default="0" />
+			<argument index="3" name="bake_fps" type="float" default="1000.0" />
 			<description>
 			</description>
 		</method>
 		<method name="import_gltf_scene">
-			<return type="Node">
-			</return>
-			<argument index="0" name="path" type="String">
-			</argument>
-			<argument index="1" name="flags" type="int" default="0">
-			</argument>
-			<argument index="2" name="bake_fps" type="float" default="1000.0">
-			</argument>
-			<argument index="3" name="state" type="GLTFState" default="null">
-			</argument>
+			<return type="Node" />
+			<argument index="0" name="path" type="String" />
+			<argument index="1" name="flags" type="int" default="0" />
+			<argument index="2" name="bake_fps" type="float" default="1000.0" />
+			<argument index="3" name="state" type="GLTFState" default="null" />
 			<description>
 			</description>
 		</method>
 		<method name="pack_gltf">
-			<return type="void">
-			</return>
-			<argument index="0" name="path" type="String">
-			</argument>
-			<argument index="1" name="flags" type="int" default="0">
-			</argument>
-			<argument index="2" name="bake_fps" type="float" default="1000.0">
-			</argument>
-			<argument index="3" name="state" type="GLTFState" default="null">
-			</argument>
+			<return type="void" />
+			<argument index="0" name="path" type="String" />
+			<argument index="1" name="flags" type="int" default="0" />
+			<argument index="2" name="bake_fps" type="float" default="1000.0" />
+			<argument index="3" name="state" type="GLTFState" default="null" />
 			<description>
 			</description>
 		</method>
-- 
cgit v1.2.3