Release v0.6.0 (#61)v0.6.0

19 files changed, 165 insertions, 24 deletions

diff --git a/CHANGELOG.md b/CHANGELOG.md
index c617db5..28e7272 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -27,7 +27,7 @@ The scope of what is covered by the version number excludes:
 
 ## Version history
 
-### version 0.6.0, unreleased
+### version 0.6.0, released 10-Apr-2025
 
 - Fix: when sleep returns an error, pass that on in `readkey`.
 - Feat: added `detachfds` which will create separate file descriptions for `stdout`
diff --git a/docs/classes/bitflags.html b/docs/classes/bitflags.html
index 647cc62..f7d2114 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-12 15:17:50 </i>
+<i style="float:right;">Last updated 2025-04-10 10:12:11 </i>
 </div> <!-- id="about" -->
 </div> <!-- id="container" -->
 </body>
diff --git a/docs/examples/compat.lua.html b/docs/examples/compat.lua.html
index e421044..dc42560 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-12 15:17:50 </i>
+<i style="float:right;">Last updated 2025-04-10 10:12:11 </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 e8a75e3..65614c6 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-12 15:17:50 </i>
+<i style="float:right;">Last updated 2025-04-10 10:12:11 </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 a5eac4d..283c4f0 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-12 15:17:50 </i>
+<i style="float:right;">Last updated 2025-04-10 10:12:11 </i>
 </div> <!-- id="about" -->
 </div> <!-- id="container" -->
 </body>
diff --git a/docs/examples/read.lua.html b/docs/examples/read.lua.html
index 3b53a8b..7dd8087 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-12 15:17:50 </i>
+<i style="float:right;">Last updated 2025-04-10 10:12:11 </i>
 </div> <!-- id="about" -->
 </div> <!-- id="container" -->
 </body>
diff --git a/docs/examples/readline.lua.html b/docs/examples/readline.lua.html
index dd63721..45a9d9b 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-12 15:17:50 </i>
+<i style="float:right;">Last updated 2025-04-10 10:12:11 </i>
 </div> <!-- id="about" -->
 </div> <!-- id="container" -->
 </body>
diff --git a/docs/examples/spinner.lua.html b/docs/examples/spinner.lua.html
index 99a1c91..ffa4ac9 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-12 15:17:50 </i>
+<i style="float:right;">Last updated 2025-04-10 10:12:11 </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 7be16e8..e250f99 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-12 15:17:50 </i>
+<i style="float:right;">Last updated 2025-04-10 10:12:11 </i>
 </div> <!-- id="about" -->
 </div> <!-- id="container" -->
 </body>
diff --git a/docs/examples/terminalsize.lua.html b/docs/examples/terminalsize.lua.html
index 6a6a93e..9aa4cc5 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-12 15:17:50 </i>
+<i style="float:right;">Last updated 2025-04-10 10:12:11 </i>
 </div> <!-- id="about" -->
 </div> <!-- id="container" -->
 </body>
diff --git a/docs/index.html b/docs/index.html
index 5d7b02f..bd3ad5c 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-12 15:17:50 </i>
+<i style="float:right;">Last updated 2025-04-10 10:12:11 </i>
 </div> <!-- id="about" -->
 </div> <!-- id="container" -->
 </body>
diff --git a/docs/modules/system.html b/docs/modules/system.html
index fa41458..28ccf5a 100644
--- a/docs/modules/system.html
+++ b/docs/modules/system.html
@@ -124,6 +124,10 @@
         <td class="summary">Backs up terminal settings and restores them on application exit.</td>
         </tr>
         <tr>
+        <td class="name" nowrap><a href="#detachfds">detachfds ()</a></td>
+        <td class="summary">Creates new file descriptions for <code>stdout</code> and <code>stderr</code>.</td>
+        </tr>
+        <tr>
         <td class="name" nowrap><a href="#getconsolecp">getconsolecp ()</a></td>
         <td class="summary">Gets the current console code page (Windows).</td>
         </tr>
@@ -498,6 +502,40 @@ sequences will be buffered internally and returned one byte at a time.
 
 </dd>
     <dt>
+    <a name = "detachfds"></a>
+    <strong>detachfds ()</strong>
+    </dt>
+    <dd>
+    Creates new file descriptions for <code>stdout</code> and <code>stderr</code>.
+Even if the file descriptors are unique, they still might point to the same
+file description, and hence share settings like <code>O_NONBLOCK</code>. This means that
+if one of them is set to non-blocking, the other will be as well. This can
+lead to unexpected behavior.</p>
+
+<p>This function is used to detach <code>stdout</code> and <code>stderr</code> from the original
+file descriptions, and create new file descriptions for them. This allows
+independent control of flags (e.g., <code>O_NONBLOCK</code>) on <code>stdout</code> and <code>stderr</code>,
+avoiding shared side effects.</p>
+
+<p>Does not modify <code>stdin</code> (fd 0), and does nothing on Windows.
+
+
+
+    <h3>Returns:</h3>
+    <ol>
+
+        boolean <code>true</code> on success, or throws an error on failure.
+    </ol>
+
+
+    <h3>See also:</h3>
+    <ul>
+         <a href="../modules/system.html#setnonblock">setnonblock</a>
+    </ul>
+
+
+</dd>
+    <dt>
     <a name = "getconsolecp"></a>
     <strong>getconsolecp ()</strong>
     </dt>
@@ -632,6 +670,10 @@ for more information on the flags.
     </ol>
 
 
+    <h3>See also:</h3>
+    <ul>
+         <a href="../modules/system.html#setnonblock">setnonblock</a>
+    </ul>
 
 
 </dd>
@@ -801,7 +843,7 @@ system.<span class="function-name">listconsoleflags</span>(<span class="global">
         </li>
         <li><span class="parameter">fsleep</span>
             <span class="types"><span class="type">function</span></span>
-         the function to call for sleeping.
+         the function to call for sleeping; <code>ok, err = fsleep(secs)</code>
          (<em>default</em> system.sleep)
         </li>
     </ul>
@@ -819,7 +861,7 @@ system.<span class="function-name">listconsoleflags</span>(<span class="global">
         if no key was read</li>
         <li>
            <span class="types"><a class="type" href="https://www.lua.org/manual/5.4/manual.html#6.4">string</a></span>
-        error message; <code>&quot;timeout&quot;</code> if the timeout was reached.</li>
+        error message when the timeout was reached (<code>&quot;timeout&quot;</code>), or if <a href="../modules/system.html#sleep">sleep</a> failed.</li>
     </ol>
 
 
@@ -947,6 +989,7 @@ system.<span class="function-name">listconsoleflags</span>(<span class="global">
     </dt>
     <dd>
     Enables or disables non-blocking mode for a file (Posix).
+Check <a href="../modules/system.html#detachfds">detachfds</a> in case there are shared file descriptions.
 
 
     <h3>Parameters:</h3>
@@ -985,13 +1028,15 @@ system.<span class="function-name">listconsoleflags</span>(<span class="global">
 
     <h3>See also:</h3>
     <ul>
-         <a href="../modules/system.html#getnonblock">getnonblock</a>
+         <li><a href="../modules/system.html#getnonblock">getnonblock</a></li>
+         <li><a href="../modules/system.html#detachfds">detachfds</a></li>
     </ul>
 
     <h3>Usage:</h3>
     <ul>
         <pre class="example"><span class="keyword">local</span> sys = <span class="global">require</span>(<span class="string">'system'</span>)
-
+sys.<span class="function-name">detachfds</span>() <span class="comment">-- detach stdout and stderr, so only stdin becomes non-blocking
+</span>
 <span class="comment">-- set io.stdin to non-blocking mode
 </span><span class="keyword">local</span> old_setting = sys.<span class="function-name">getnonblock</span>(<span class="global">io</span>.stdin)
 sys.<span class="function-name">setnonblock</span>(<span class="global">io</span>.stdin, <span class="keyword">true</span>)
@@ -1422,7 +1467,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-12 15:17:50 </i>
+<i style="float:right;">Last updated 2025-04-10 10:12:11 </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 f0f627d..f16d354 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-12 15:17:50 </i>
+<i style="float:right;">Last updated 2025-04-10 10:12:11 </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 315fa37..b83969b 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-12 15:17:50 </i>
+<i style="float:right;">Last updated 2025-04-10 10:12:11 </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 7ce28af..ebaa8bb 100644
--- a/docs/topics/03-terminal.md.html
+++ b/docs/topics/03-terminal.md.html
@@ -93,6 +93,7 @@ up both platforms to make it work.</p>
     <li><a href="../modules/system.html#setconsoleflags">system.setconsoleflags</a> (Windows)</li>
     <li><a href="../modules/system.html#setconsolecp">system.setconsolecp</a> (Windows)</li>
     <li><a href="../modules/system.html#setconsoleoutputcp">system.setconsoleoutputcp</a> (Windows)</li>
+    <li><a href="../modules/system.html#detachfds">system.detachfds</a> (Posix)</li>
     <li><a href="../modules/system.html#setnonblock">system.setnonblock</a> (Posix)</li>
     <li><a href="../modules/system.html#tcsetattr">system.tcsetattr</a> (Posix)</li>
 </ul>
@@ -195,6 +196,7 @@ also not being echoed to the terminal (independent of the echo settings used wit
 </span>sys.<span class="function-name">setconsoleflags</span>(<span class="global">io</span>.stdin, sys.<span class="function-name">getconsoleflags</span>(<span class="global">io</span>.stdin) - sys.CIF_ECHO_INPUT - sys.CIF_LINE_INPUT)
 
 <span class="comment">-- setup Posix by disabling echo, canonical mode, and making non-blocking
+</span>sys.<span class="function-name">detachfds</span>()  <span class="comment">-- ensure stdin/out/err have their own file descriptions
 </span><span class="keyword">local</span> of_attr = sys.<span class="function-name">tcgetattr</span>(<span class="global">io</span>.stdin)
 sys.<span class="function-name">tcsetattr</span>(<span class="global">io</span>.stdin, sys.TCSANOW, {
   lflag = of_attr.lflag - sys.L_ICANON - sys.L_ECHO,
@@ -218,7 +220,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-12 15:17:50 </i>
+<i style="float:right;">Last updated 2025-04-10 10:12:11 </i>
 </div> <!-- id="about" -->
 </div> <!-- id="container" -->
 </body>
diff --git a/docs/topics/CHANGELOG.md.html b/docs/topics/CHANGELOG.md.html
index fa2d706..796ae20 100644
--- a/docs/topics/CHANGELOG.md.html
+++ b/docs/topics/CHANGELOG.md.html
@@ -106,6 +106,15 @@
 <p><a name="Version_history"></a></p>
 <h2>Version history</h2>
 
+<h3>version 0.6.0, released 10-Apr-2025</h3>
+
+<ul>
+    <li>Fix: when sleep returns an error, pass that on in <code>readkey</code>.</li>
+    <li>Feat: added <code>detachfds</code> which will create separate file descriptions for <code>stdout</code>
+    and <code>stderr</code> to ensure that related settings (eg. non-blocking flag) will not be shared
+    amongst those streams and <code>stdin</code>.</li>
+</ul>
+
 <h3>version 0.5.1, released 12-Mar-2025</h3>
 
 <ul>
@@ -120,14 +129,14 @@
     <li>Feat: allow passing in a sleep function to <code>readkey</code> and <code>readansi</code></li>
     <li>Fix: NetBSD fix compilation, undeclared directives</li>
     <li>Refactor: random bytes; remove deprecated API usage on Windows, move to
-    binary api instead of /dev/urandom file on linux and bsd</li>
+    binary api instead of <code>/dev/urandom</code> file on linux and bsd</li>
 </ul>
 
 <h3>version 0.4.5, released 18-Dec-2024</h3>
 
 <ul>
     <li>Fix: suppress a warning when building with clang</li>
-    <li>Fix: do not rely on luaconf.h to include limits.h, fixes builds with latest LuaJIT (#38).</li>
+    <li>Fix: do not rely on <code>luaconf.h</code> to include <code>limits.h</code>, fixes builds with latest LuaJIT (#38).</li>
 </ul>
 
 <h3>version 0.4.4, released 03-Sep-2024</h3>
@@ -199,7 +208,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-12 15:17:50 </i>
+<i style="float:right;">Last updated 2025-04-10 10:12:11 </i>
 </div> <!-- id="about" -->
 </div> <!-- id="container" -->
 </body>
diff --git a/docs/topics/LICENSE.md.html b/docs/topics/LICENSE.md.html
index 612cdb9..b7f5ac1 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-12 15:17:50 </i>
+<i style="float:right;">Last updated 2025-04-10 10:12:11 </i>
 </div> <!-- id="about" -->
 </div> <!-- id="container" -->
 </body>
diff --git a/rockspecs/luasystem-0.6.0-1.rockspec b/rockspecs/luasystem-0.6.0-1.rockspec
new file mode 100644
index 0000000..21c2dc0
--- /dev/null
+++ b/rockspecs/luasystem-0.6.0-1.rockspec
@@ -0,0 +1,85 @@
+local package_name = "luasystem"
+local package_version = "0.6.0"
+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 b642074..1d23f8e 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.1"
+#define LUASYSTEM_VERSION   "LuaSystem 0.6.0"
 
 #ifdef _WIN32
 #define LUAEXPORT __declspec(dllexport)