From 8abac46fe3cee836039f64152a72601a3e26de28 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Lars=20M=C3=BCller?=
 <34514239+appgurueu@users.noreply.github.com>
Date: Wed, 17 Jan 2024 22:37:55 +0100
Subject: [PATCH] Add warning concerning `math.random` portability

---
 doc/random.adoc | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/doc/random.adoc b/doc/random.adoc
index b8ccc91..ce7016e 100644
--- a/doc/random.adoc
+++ b/doc/random.adoc
@@ -58,6 +58,11 @@ make sure that both the upper & lower bound
 as well as their difference are within the C `int` range -
 otherwise you may get overflows & errors.
 
+WARNING: This is not portable; different builds on different platforms will produce different random numbers.
+PUC Lua 5.1 builds use a system-provided random generator.
+LuaJIT builds use LuaJIT's PRNG implementation.
+Do not use `math.random` in mapgen, for example.
+
 TIP: Use `math.random` as your go-to versatile "non-deterministic" random source.
 
 == Random Number Generators