eina: document matrix3 multiplication routines

Reviewers: cedric

Reviewed By: cedric

Subscribers: cedric, jpeg

Differential Revision: https://phab.enlightenment.org/D5200

Change-Id: I995fdd822a8020aae236996509ab009d612abe57
Signed-off-by: Cedric BAIL <cedric@osg.samsung.com>

diff --git a/src/lib/eina/eina_matrix.h b/src/lib/eina/eina_matrix.h
index 29ec3dc..15e73ef 100644 (file)
--- a/src/lib/eina/eina_matrix.h
+++ b/src/lib/eina/eina_matrix.h
@@ -389,6 +389,17 @@ EAPI void eina_matrix3_matrix3_f16p16_to(const Eina_Matrix3 *m,
 EAPI Eina_Bool eina_matrix3_equal(const Eina_Matrix3 *m1, const Eina_Matrix3 *m2);
 
 /**
+ * @brief Sets dst as the matrix multiplication (composition) of two matrices.
+ *
+ * In matrix multiplication, AB, the resultant matrix is created from
+ * the rows of A multiplied against the columns of B and summed.  This
+ * is not a cummutative; i.e.  AB != BA, so the ordering of arguments
+ * @p m1 and @p m2 matters.
+ *
+ * @param[in] m1 The first matrix.  Must be non-NULL.
+ * @param[in] m2 The second matrix.  Must be non-NULL.
+ * @param[out] dst The matrix for the results to be placed.
+ *
  * @since 1.14
  *
  * @if MOBILE @since_tizen 3.0