[Bf-blender-cvs] [805f8f8230f] master: Comments: add comments for new transform struct members.

[Campbell Barton]

Commit: 805f8f8230f048e86d92f016588fb62af87857b5
Author: Campbell Barton
Date:   Fri Mar 1 10:12:26 2019 +1100
Branches: master
https://developer.blender.org/rB805f8f8230f048e86d92f016588fb62af87857b5

Comments: add comments for new transform struct members.

===================================================================

M	source/blender/editors/transform/transform.h

===================================================================

diff --git a/source/blender/editors/transform/transform.h b/source/blender/editors/transform/transform.h
index b9240c4ef3d..c8af018f7b9 100644
--- a/source/blender/editors/transform/transform.h
+++ b/source/blender/editors/transform/transform.h
@@ -632,9 +632,20 @@ typedef struct TransInfo {
 	float		values_modal_offset[4];
 	float		auto_values[4];
 
+	/* Axis members for modes that use an axis separate from the orientation (rotate & shear). */
+
+	/** Primary axis, rotate only uses this. */
 	int orient_axis;
+	/** Secondary axis, shear uses this. */
 	int orient_axis_ortho;
+
+	/** Often this matrix has similar usage to #TransInfo.spacemtx however this
+	 * is used to define extra axes to operate on, not necessarily a space.
+	 *
+	 * For example, by default rotation operates on the view (`orient_matrix[2]`),
+	 * even when the current space isn't set to the view. */
 	float orient_matrix[3][3];
+	/** Don't overwrite when set by operator redo defines the orientation axis. */
 	bool  orient_matrix_is_set;
 
 	/** remove elements if operator is canceled. */