docs: notes on LUA record splitting

diff --git a/docs/lua-records/index.rst b/docs/lua-records/index.rst
index 08dab784054fd98a3de849c153617a515d3f281c..7845010f291f39a09dbe6f32514179d32c501e94 100644 (file)
--- a/docs/lua-records/index.rst
+++ b/docs/lua-records/index.rst
@@ -27,6 +27,11 @@ or set the 'ENABLE-LUA-RECORDS' per-zone metadata item to 1.
 In addition, to benefit from the geographical features, make sure the PowerDNS
 launch statement includes the ``geoip`` backend.
 
+.. warning::
+  When using AXFR to transfer long LUA records, ensure that the record content split into segments no longer than 255 bytes.
+  Due to the nature of the transfer method (as TXT content), the content will be split into 255 byte chunks.
+  This can lead to the code being split in the wrong places on the secondary.
+
 Examples
 --------