From 15f9803d289a9f65d8704246c686c7e8532cc6c1 Mon Sep 17 00:00:00 2001
From: Micky <66727710+Mickeon@users.noreply.github.com>
Date: Thu, 5 May 2022 01:29:38 +0200
Subject: [PATCH] Specify return value of Transform3D.scaled() and more

Add more `[code]` (Transform3D)

Co-authored-by: kleonc <9283098+kleonc@users.noreply.github.com>

Add more `[code]` (Transform2D)

Co-authored-by: kleonc <9283098+kleonc@users.noreply.github.com>
(cherry picked from commit 87599054d26faa534e206959c12ef70f3a1e92f5)
---
 doc/classes/Transform.xml   | 6 +++---
 doc/classes/Transform2D.xml | 6 +++---
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/doc/classes/Transform.xml b/doc/classes/Transform.xml
index 673330fdf82..f4a4a8a5577 100644
--- a/doc/classes/Transform.xml
+++ b/doc/classes/Transform.xml
@@ -103,21 +103,21 @@
 			<argument index="0" name="axis" type="Vector3" />
 			<argument index="1" name="phi" type="float" />
 			<description>
-				Rotates the transform around the given axis by the given angle (in radians), using matrix multiplication. The axis must be a normalized vector.
+				Returns a copy of the transform rotated around the given [code]axis[/code] by the given [code]phi[/code] angle (in radians), using matrix multiplication. The [code]axis[/code] must be a normalized vector.
 			</description>
 		</method>
 		<method name="scaled">
 			<return type="Transform" />
 			<argument index="0" name="scale" type="Vector3" />
 			<description>
-				Scales basis and origin of the transform by the given scale factor, using matrix multiplication.
+				Returns a copy of the transform with its basis and origin scaled by the given [code]scale[/code] factor, using matrix multiplication.
 			</description>
 		</method>
 		<method name="translated">
 			<return type="Transform" />
 			<argument index="0" name="offset" type="Vector3" />
 			<description>
-				Translates the transform by the given offset, relative to the transform's basis vectors.
+				Returns a copy of the transform translated by the given [code]offset[/code], relative to the transform's basis vectors.
 				Unlike [method rotated] and [method scaled], this does not use matrix multiplication.
 			</description>
 		</method>
diff --git a/doc/classes/Transform2D.xml b/doc/classes/Transform2D.xml
index 73c988ec704..e0d737cacbd 100644
--- a/doc/classes/Transform2D.xml
+++ b/doc/classes/Transform2D.xml
@@ -109,21 +109,21 @@
 			<return type="Transform2D" />
 			<argument index="0" name="phi" type="float" />
 			<description>
-				Rotates the transform by the given angle (in radians), using matrix multiplication.
+				Returns a copy of the transform rotated by the given [code]phi[/code] angle (in radians), using matrix multiplication.
 			</description>
 		</method>
 		<method name="scaled">
 			<return type="Transform2D" />
 			<argument index="0" name="scale" type="Vector2" />
 			<description>
-				Scales the transform by the given scale factor, using matrix multiplication.
+				Returns a copy of the transform scaled by the given [code]scale[/code] factor, using matrix multiplication.
 			</description>
 		</method>
 		<method name="translated">
 			<return type="Transform2D" />
 			<argument index="0" name="offset" type="Vector2" />
 			<description>
-				Translates the transform by the given offset, relative to the transform's basis vectors.
+				Returns a copy of the transform translated by the given [code]offset[/code], relative to the transform's basis vectors.
 				Unlike [method rotated] and [method scaled], this does not use matrix multiplication.
 			</description>
 		</method>