From e9f4886253aa007fbae18791c328d91864cddbb7 Mon Sep 17 00:00:00 2001
From: Marco Costa <mmarcottulio@gmail.com>
Date: Thu, 4 Jul 2019 22:10:47 -0400
Subject: [PATCH] Document constants in Transform/Transform2D

(cherry picked from commit f99e84d18087db4aece49608270caf7d313f8704)
---
 doc/classes/Transform.xml   | 4 ++++
 doc/classes/Transform2D.xml | 3 +++
 2 files changed, 7 insertions(+)

diff --git a/doc/classes/Transform.xml b/doc/classes/Transform.xml
index 29831abd76c..6b774b6b237 100644
--- a/doc/classes/Transform.xml
+++ b/doc/classes/Transform.xml
@@ -167,12 +167,16 @@
 	</members>
 	<constants>
 		<constant name="IDENTITY" value="Transform( 1, 0, 0, 0, 1, 0, 0, 0, 1, 0, 0, 0 )">
+			[Transform] with no translation, rotation or scaling applied. When applied to other data structures, [constant IDENTITY] performs no transformation.
 		</constant>
 		<constant name="FLIP_X" value="Transform( -1, 0, 0, 0, 1, 0, 0, 0, 1, 0, 0, 0 )">
+			[Transform] with mirroring applied perpendicular to the YZ plane.
 		</constant>
 		<constant name="FLIP_Y" value="Transform( 1, 0, 0, 0, -1, 0, 0, 0, 1, 0, 0, 0 )">
+			[Transform] with mirroring applied perpendicular to the XZ plane.
 		</constant>
 		<constant name="FLIP_Z" value="Transform( 1, 0, 0, 0, 1, 0, 0, 0, -1, 0, 0, 0 )">
+			[Transform] with mirroring applied perpendicular to the XY plane.
 		</constant>
 	</constants>
 </class>
diff --git a/doc/classes/Transform2D.xml b/doc/classes/Transform2D.xml
index 0e959412e67..8df9d02b719 100644
--- a/doc/classes/Transform2D.xml
+++ b/doc/classes/Transform2D.xml
@@ -172,10 +172,13 @@
 	</members>
 	<constants>
 		<constant name="IDENTITY" value="Transform2D( 1, 0, 0, 1, 0, 0 )">
+			[Transform2D] with no translation, rotation or scaling applied. When applied to other data structures, [constant IDENTITY] performs no transformation.
 		</constant>
 		<constant name="FLIP_X" value="Transform2D( -1, 0, 0, 1, 0, 0 )">
+			[Transform2D] with mirroring applied parallel to the X axis.
 		</constant>
 		<constant name="FLIP_Y" value="Transform2D( 1, 0, 0, -1, 0, 0 )">
+			[Transform2D] with mirroring applied parallel to the Y axis.
 		</constant>
 	</constants>
 </class>