From 3128beba7faf124e7134b846f200bfba1db5acbd Mon Sep 17 00:00:00 2001
From: SmallJoker <mk939@ymail.com>
Date: Thu, 28 Nov 2024 18:54:32 +0100
Subject: [PATCH] attempt to improve docs

---
 doc/lua_api.md | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/doc/lua_api.md b/doc/lua_api.md
index 77e030fcd..faa051eb0 100644
--- a/doc/lua_api.md
+++ b/doc/lua_api.md
@@ -573,8 +573,11 @@ The aspect ratio is preserved.
 * `<xN>`: X offset of insertion, negative numbers allowed
 * `<yN>`: Y offset of insertion, negative numbers allowed
 * `<wN>` (optional): Expected texture width
-   * Scales the output image if `<wN> != input texture width` to perform lossless blit.
-   * Supported since protocol version 46.
+   * If the provided texture width is (e.g. 2 times) larger than `<wN>`, it will
+     result in an output texture that is also (2 times) larger.
+   * If the provided texture width is smaller, it will be upscaled proportionally
+     to match the width `<wN>`.
+   * Supported since protocol version 47. Old clients will ignore this parameter.
 * `<file>`: texture to combine