[mutter/gbsneto/graphene-matrix: 5/39] cogl/matrix: Update outdated documentation and comments

[Georges Basile Stavracas Neto <gbsneto src gnome org>]

commit bf063d633660ec3af64a7690d453d3dc5ab81bd8
Author: Georges Basile Stavracas Neto <georges stavracas gmail com>
Date:   Fri Sep 11 08:24:24 2020 -0300

    cogl/matrix: Update outdated documentation and comments
    
    No direct access of matrix entries is allowed anymore; and we
    use graphene_matrix_t internally.
    
    https://gitlab.gnome.org/GNOME/mutter/-/merge_requests/1439

 cogl/cogl/cogl-matrix.h | 13 ++-----------
 1 file changed, 2 insertions(+), 11 deletions(-)
---
diff --git a/cogl/cogl/cogl-matrix.h b/cogl/cogl/cogl-matrix.h
index f3c1514352..31b5773245 100644
--- a/cogl/cogl/cogl-matrix.h
+++ b/cogl/cogl/cogl-matrix.h
@@ -59,8 +59,8 @@ G_BEGIN_DECLS
 /**
  * CoglMatrix:
  *
- * A CoglMatrix holds a 4x4 transform matrix. This is a single precision,
- * column-major matrix which means it is compatible with what OpenGL expects.
+ * A CoglMatrix holds a 4x4 transform matrix. It uses #graphene_matrix_t
+ * internally which means it is compatible with what OpenGL expects.
  *
  * A CoglMatrix can represent transforms such as, rotations, scaling,
  * translation, sheering, and linear projections. You can combine these
@@ -77,21 +77,12 @@ G_BEGIN_DECLS
  * ]|
  *
  * Where w is normally 1
- *
- * <note>You must consider the members of the CoglMatrix structure read only,
- * and all matrix modifications must be done via the cogl_matrix API. This
- * allows Cogl to annotate the matrices internally. Violation of this will give
- * undefined results. If you need to initialize a matrix with a constant other
- * than the identity matrix you can use cogl_matrix_init_from_array().</note>
  */
 struct _CoglMatrix
 {
   /*< private >*/
-
   graphene_matrix_t m;
 
-  /* Note: we may want to extend this later with private flags
-   * and a cache of the inverse transform matrix. */
   graphene_matrix_t COGL_PRIVATE (inv);
   unsigned long  COGL_PRIVATE (flags);
   unsigned long  COGL_PRIVATE (_padding3);