Release v0.5.1v0.5.1

19 files changed, 114 insertions, 20 deletions

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 06ff748..1c9e15e 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -27,6 +27,10 @@ The scope of what is covered by the version number excludes:
 
 ## Version history
 
+### version 0.5.1, released 12-Mar-2025
+
+- Fix: on older unixes with glibc < 2.25, fall back to `/dev/urandom`
+
 ### version 0.5.0, released 02-Mar-2025
 
 - Feat: when detecting character display width, also accept unicode codepoints (integers),
diff --git a/docs/classes/bitflags.html b/docs/classes/bitflags.html
index dc682f2..647cc62 100644
--- a/docs/classes/bitflags.html
+++ b/docs/classes/bitflags.html
@@ -298,7 +298,7 @@ return <code>false</code> if the flags are checked.
 </div> <!-- id="main" -->
 <div id="about">
 <i>generated by <a href="http://github.com/lunarmodules/LDoc">LDoc 1.5.0</a></i>
-<i style="float:right;">Last updated 2025-03-02 19:43:40 </i>
+<i style="float:right;">Last updated 2025-03-12 15:17:50 </i>
 </div> <!-- id="about" -->
 </div> <!-- id="container" -->
 </body>
diff --git a/docs/examples/compat.lua.html b/docs/examples/compat.lua.html
index 42928b0..e421044 100644
--- a/docs/examples/compat.lua.html
+++ b/docs/examples/compat.lua.html
@@ -112,7 +112,7 @@
 </div> <!-- id="main" -->
 <div id="about">
 <i>generated by <a href="http://github.com/lunarmodules/LDoc">LDoc 1.5.0</a></i>
-<i style="float:right;">Last updated 2025-03-02 19:43:40 </i>
+<i style="float:right;">Last updated 2025-03-12 15:17:50 </i>
 </div> <!-- id="about" -->
 </div> <!-- id="container" -->
 </body>
diff --git a/docs/examples/flag_debugging.lua.html b/docs/examples/flag_debugging.lua.html
index 862cd96..e8a75e3 100644
--- a/docs/examples/flag_debugging.lua.html
+++ b/docs/examples/flag_debugging.lua.html
@@ -80,7 +80,7 @@
 </div> <!-- id="main" -->
 <div id="about">
 <i>generated by <a href="http://github.com/lunarmodules/LDoc">LDoc 1.5.0</a></i>
-<i style="float:right;">Last updated 2025-03-02 19:43:40 </i>
+<i style="float:right;">Last updated 2025-03-12 15:17:50 </i>
 </div> <!-- id="about" -->
 </div> <!-- id="container" -->
 </body>
diff --git a/docs/examples/password_input.lua.html b/docs/examples/password_input.lua.html
index cf27497..a5eac4d 100644
--- a/docs/examples/password_input.lua.html
+++ b/docs/examples/password_input.lua.html
@@ -132,7 +132,7 @@ useful for reading secrets from the user.
 </div> <!-- id="main" -->
 <div id="about">
 <i>generated by <a href="http://github.com/lunarmodules/LDoc">LDoc 1.5.0</a></i>
-<i style="float:right;">Last updated 2025-03-02 19:43:40 </i>
+<i style="float:right;">Last updated 2025-03-12 15:17:50 </i>
 </div> <!-- id="about" -->
 </div> <!-- id="container" -->
 </body>
diff --git a/docs/examples/read.lua.html b/docs/examples/read.lua.html
index 2ffcf1b..3b53a8b 100644
--- a/docs/examples/read.lua.html
+++ b/docs/examples/read.lua.html
@@ -143,7 +143,7 @@ sys.<span class="function-name">setnonblock</span>(<span class="global">io</span
 </div> <!-- id="main" -->
 <div id="about">
 <i>generated by <a href="http://github.com/lunarmodules/LDoc">LDoc 1.5.0</a></i>
-<i style="float:right;">Last updated 2025-03-02 19:43:40 </i>
+<i style="float:right;">Last updated 2025-03-12 15:17:50 </i>
 </div> <!-- id="about" -->
 </div> <!-- id="container" -->
 </body>
diff --git a/docs/examples/readline.lua.html b/docs/examples/readline.lua.html
index ba453ad..dd63721 100644
--- a/docs/examples/readline.lua.html
+++ b/docs/examples/readline.lua.html
@@ -549,7 +549,7 @@ sys.<span class="function-name">setconsoleflags</span>(<span class="global">io</
 </div> <!-- id="main" -->
 <div id="about">
 <i>generated by <a href="http://github.com/lunarmodules/LDoc">LDoc 1.5.0</a></i>
-<i style="float:right;">Last updated 2025-03-02 19:43:40 </i>
+<i style="float:right;">Last updated 2025-03-12 15:17:50 </i>
 </div> <!-- id="about" -->
 </div> <!-- id="container" -->
 </body>
diff --git a/docs/examples/spinner.lua.html b/docs/examples/spinner.lua.html
index ea992e3..99a1c91 100644
--- a/docs/examples/spinner.lua.html
+++ b/docs/examples/spinner.lua.html
@@ -137,7 +137,7 @@ sys.<span class="function-name">setnonblock</span>(<span class="global">io</span
 </div> <!-- id="main" -->
 <div id="about">
 <i>generated by <a href="http://github.com/lunarmodules/LDoc">LDoc 1.5.0</a></i>
-<i style="float:right;">Last updated 2025-03-02 19:43:40 </i>
+<i style="float:right;">Last updated 2025-03-12 15:17:50 </i>
 </div> <!-- id="about" -->
 </div> <!-- id="container" -->
 </body>
diff --git a/docs/examples/spiral_snake.lua.html b/docs/examples/spiral_snake.lua.html
index 1f0d582..7be16e8 100644
--- a/docs/examples/spiral_snake.lua.html
+++ b/docs/examples/spiral_snake.lua.html
@@ -145,7 +145,7 @@ codes for moving the cursor around.
 </div> <!-- id="main" -->
 <div id="about">
 <i>generated by <a href="http://github.com/lunarmodules/LDoc">LDoc 1.5.0</a></i>
-<i style="float:right;">Last updated 2025-03-02 19:43:40 </i>
+<i style="float:right;">Last updated 2025-03-12 15:17:50 </i>
 </div> <!-- id="about" -->
 </div> <!-- id="container" -->
 </body>
diff --git a/docs/examples/terminalsize.lua.html b/docs/examples/terminalsize.lua.html
index a8bb42b..6a6a93e 100644
--- a/docs/examples/terminalsize.lua.html
+++ b/docs/examples/terminalsize.lua.html
@@ -110,7 +110,7 @@ sys.<span class="function-name">tcsetattr</span>(<span class="global">io</span>.
 </div> <!-- id="main" -->
 <div id="about">
 <i>generated by <a href="http://github.com/lunarmodules/LDoc">LDoc 1.5.0</a></i>
-<i style="float:right;">Last updated 2025-03-02 19:43:40 </i>
+<i style="float:right;">Last updated 2025-03-12 15:17:50 </i>
 </div> <!-- id="about" -->
 </div> <!-- id="container" -->
 </body>
diff --git a/docs/index.html b/docs/index.html
index 9ca0c42..5d7b02f 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -142,7 +142,7 @@
 </div> <!-- id="main" -->
 <div id="about">
 <i>generated by <a href="http://github.com/lunarmodules/LDoc">LDoc 1.5.0</a></i>
-<i style="float:right;">Last updated 2025-03-02 19:43:40 </i>
+<i style="float:right;">Last updated 2025-03-12 15:17:50 </i>
 </div> <!-- id="about" -->
 </div> <!-- id="container" -->
 </body>
diff --git a/docs/modules/system.html b/docs/modules/system.html
index 093fd8b..fa41458 100644
--- a/docs/modules/system.html
+++ b/docs/modules/system.html
@@ -1422,7 +1422,7 @@ This function will sleep, without doing a busy-loop and wasting CPU cycles.
 </div> <!-- id="main" -->
 <div id="about">
 <i>generated by <a href="http://github.com/lunarmodules/LDoc">LDoc 1.5.0</a></i>
-<i style="float:right;">Last updated 2025-03-02 19:43:40 </i>
+<i style="float:right;">Last updated 2025-03-12 15:17:50 </i>
 </div> <!-- id="about" -->
 </div> <!-- id="container" -->
 </body>
diff --git a/docs/topics/01-introduction.md.html b/docs/topics/01-introduction.md.html
index cf8a21f..f0f627d 100644
--- a/docs/topics/01-introduction.md.html
+++ b/docs/topics/01-introduction.md.html
@@ -84,7 +84,7 @@ independence.</p>
 </div> <!-- id="main" -->
 <div id="about">
 <i>generated by <a href="http://github.com/lunarmodules/LDoc">LDoc 1.5.0</a></i>
-<i style="float:right;">Last updated 2025-03-02 19:43:40 </i>
+<i style="float:right;">Last updated 2025-03-12 15:17:50 </i>
 </div> <!-- id="about" -->
 </div> <!-- id="container" -->
 </body>
diff --git a/docs/topics/02-development.md.html b/docs/topics/02-development.md.html
index b9f79fd..315fa37 100644
--- a/docs/topics/02-development.md.html
+++ b/docs/topics/02-development.md.html
@@ -84,7 +84,7 @@ pass locally, and do not rely on CI only.</p>
 </div> <!-- id="main" -->
 <div id="about">
 <i>generated by <a href="http://github.com/lunarmodules/LDoc">LDoc 1.5.0</a></i>
-<i style="float:right;">Last updated 2025-03-02 19:43:40 </i>
+<i style="float:right;">Last updated 2025-03-12 15:17:50 </i>
 </div> <!-- id="about" -->
 </div> <!-- id="container" -->
 </body>
diff --git a/docs/topics/03-terminal.md.html b/docs/topics/03-terminal.md.html
index 8c45d6e..7ce28af 100644
--- a/docs/topics/03-terminal.md.html
+++ b/docs/topics/03-terminal.md.html
@@ -218,7 +218,7 @@ For an example see <a href="../examples/password_input.lua.html"><code>examples/
 </div> <!-- id="main" -->
 <div id="about">
 <i>generated by <a href="http://github.com/lunarmodules/LDoc">LDoc 1.5.0</a></i>
-<i style="float:right;">Last updated 2025-03-02 19:43:40 </i>
+<i style="float:right;">Last updated 2025-03-12 15:17:50 </i>
 </div> <!-- id="about" -->
 </div> <!-- id="container" -->
 </body>
diff --git a/docs/topics/CHANGELOG.md.html b/docs/topics/CHANGELOG.md.html
index fd3ba59..fa2d706 100644
--- a/docs/topics/CHANGELOG.md.html
+++ b/docs/topics/CHANGELOG.md.html
@@ -98,8 +98,7 @@
     <li>commit the changes as <code>Release vX.Y.Z</code></li>
     <li>push the commit, and create a release PR</li>
     <li>after merging tag the release commit with <code>vX.Y.Z</code></li>
-    <li>upload to LuaRocks:<br/>
-    <code>luarocks upload ./rockspecs/luasystem-X.Y.Z-1.rockspec --api-key=ABCDEFGH</code></li>
+    <li>upload to LuaRocks will be automatic by the CI runners</li>
     <li>test the newly created rock:<br/>
     <code>luarocks install luasystem</code></li>
 </ul>
@@ -107,7 +106,13 @@
 <p><a name="Version_history"></a></p>
 <h2>Version history</h2>
 
-<h3>unreleased</h3>
+<h3>version 0.5.1, released 12-Mar-2025</h3>
+
+<ul>
+    <li>Fix: on older unixes with glibc &lt; 2.25, fall back to <code>/dev/urandom</code></li>
+</ul>
+
+<h3>version 0.5.0, released 02-Mar-2025</h3>
 
 <ul>
     <li>Feat: when detecting character display width, also accept unicode codepoints (integers),
@@ -194,7 +199,7 @@
 </div> <!-- id="main" -->
 <div id="about">
 <i>generated by <a href="http://github.com/lunarmodules/LDoc">LDoc 1.5.0</a></i>
-<i style="float:right;">Last updated 2025-03-02 19:43:40 </i>
+<i style="float:right;">Last updated 2025-03-12 15:17:50 </i>
 </div> <!-- id="about" -->
 </div> <!-- id="container" -->
 </body>
diff --git a/docs/topics/LICENSE.md.html b/docs/topics/LICENSE.md.html
index bbe229e..612cdb9 100644
--- a/docs/topics/LICENSE.md.html
+++ b/docs/topics/LICENSE.md.html
@@ -94,7 +94,7 @@ SOFTWARE.</p>
 </div> <!-- id="main" -->
 <div id="about">
 <i>generated by <a href="http://github.com/lunarmodules/LDoc">LDoc 1.5.0</a></i>
-<i style="float:right;">Last updated 2025-03-02 19:43:40 </i>
+<i style="float:right;">Last updated 2025-03-12 15:17:50 </i>
 </div> <!-- id="about" -->
 </div> <!-- id="container" -->
 </body>
diff --git a/rockspecs/luasystem-0.5.1-1.rockspec b/rockspecs/luasystem-0.5.1-1.rockspec
new file mode 100644
index 0000000..b9d13ea
--- /dev/null
+++ b/rockspecs/luasystem-0.5.1-1.rockspec
@@ -0,0 +1,85 @@
+local package_name = "luasystem"
+local package_version = "0.5.1"
+local rockspec_revision = "1"
+local github_account_name = "lunarmodules"
+local github_repo_name = "luasystem"
+
+
+package = package_name
+version = package_version.."-"..rockspec_revision
+
+source = {
+  url = "git+https://github.com/"..github_account_name.."/"..github_repo_name..".git",
+  branch = (package_version == "scm") and "master" or nil,
+  tag = (package_version ~= "scm") and "v"..package_version or nil,
+}
+
+description = {
+  summary = 'Platform independent system calls for Lua.',
+  detailed = [[
+    Adds a Lua API for making platform independent system calls.
+  ]],
+  license = 'MIT <http://opensource.org/licenses/MIT>',
+  homepage = "https://github.com/"..github_account_name.."/"..github_repo_name,
+}
+
+dependencies = {
+  'lua >= 5.1',
+}
+
+local function make_platform(plat)
+  local defines = {
+    linux = { },
+    unix = { },
+    macosx = { },
+    win32 = { "WINVER=0x0600", "_WIN32_WINNT=0x0600" },
+    mingw32 = { "WINVER=0x0600", "_WIN32_WINNT=0x0600" },
+  }
+  local libraries = {
+    linux = { "rt" },
+    unix = { },
+    macosx = { },
+    win32 = { "advapi32", "winmm", "bcrypt" },
+    mingw32 = { },
+  }
+  local libdirs = {
+    linux = nil,
+    unix = nil,
+    macosx = nil,
+    win32 = nil,
+    mingw32 = { },
+  }
+  return {
+    modules = {
+      ['system.core'] = {
+        sources = {
+          'src/core.c',
+          'src/compat.c',
+          'src/time.c',
+          'src/environment.c',
+          'src/random.c',
+          'src/term.c',
+          'src/bitflags.c',
+          'src/wcwidth.c',
+        },
+        defines = defines[plat],
+        libraries = libraries[plat],
+        libdirs = libdirs[plat],
+      },
+    },
+  }
+end
+
+build = {
+  type = 'builtin',
+  platforms = {
+    linux = make_platform('linux'),
+    unix = make_platform('unix'),
+    macosx = make_platform('macosx'),
+    win32 = make_platform('win32'),
+    mingw32 = make_platform('mingw32'),
+  },
+  modules = {
+    ['system.init'] = 'system/init.lua',
+  },
+}
diff --git a/src/core.c b/src/core.c
index 4eaa448..b642074 100644
--- a/src/core.c
+++ b/src/core.c
@@ -4,7 +4,7 @@
 #include <lua.h>
 #include <lauxlib.h>
 
-#define LUASYSTEM_VERSION   "LuaSystem 0.5.0"
+#define LUASYSTEM_VERSION   "LuaSystem 0.5.1"
 
 #ifdef _WIN32
 #define LUAEXPORT __declspec(dllexport)