From ea96f6e1e37b4528668c084b036265354cf7d2c0 Mon Sep 17 00:00:00 2001
From: Zughy <63455151+Zughy@users.noreply.github.com>
Date: Fri, 16 Aug 2024 21:59:20 +0200
Subject: [PATCH] DOCS: state that `initial_properties` are shared between
 entity instances

---
 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 836044a34..eed63862a 100644
--- a/doc/lua_api.md
+++ b/doc/lua_api.md
@@ -8915,7 +8915,10 @@ Player properties need to be saved manually.
 Entity definition
 -----------------
 
-Used by `minetest.register_entity`.
+Used by `minetest.register_entity`.  
+The entity definition table becomes a metatable of a newly created per-entity
+luaentity table, meaning its fields (e.g. `initial_properties`) will be shared
+between all instances of an entity.
 
 ```lua
 {