From b4dbda3eb7322bcb9c15d918b173cf1506e5d8a8 Mon Sep 17 00:00:00 2001
From: Lars Mueller <appgurulars@gmx.de>
Date: Mon, 2 Jun 2025 14:58:52 +0200
Subject: [PATCH] Document that matrix composition is RTL

---
 doc/lua_api.md | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/doc/lua_api.md b/doc/lua_api.md
index 7080050c3..8340ede42 100644
--- a/doc/lua_api.md
+++ b/doc/lua_api.md
@@ -4277,8 +4277,11 @@ Linear algebra:
   * `Matrix4:transform_direction(dir)`:
     * Apply the matrix to a vector representing a direction.
     * Ignores the fourth row and column; does not apply the translation (w = 0).
-* `Matrix4.compose(...)`: Returns the composition of the given matrices.
+* `Matrix4.compose(...)`: Returns the composition of the given matrices
+  in right-to-left order: `second:compose(first):apply(v)`
+  is equivalent to `second:apply(first:apply(v))`.
   If `...` is empty, this is just the identity.
+  `Matrix4:compose()` copies the matrix.
 * `Matrix4:determinant()`: Returns the determinant.
 * `Matrix4:invert()`: Returns a newly created inverse, or `nil` if the matrix is (close to being) singular.
 * `Matrix4:transpose()`: Returns a transposed copy of the matrix.