From 7eda8b1a8d5b724d7754c6fd0060f065d1e2401c Mon Sep 17 00:00:00 2001
From: Daniel Hammer <daniel@nexlink.cloud>
Date: Thu, 1 Oct 2026 08:38:10 +0200
Subject: [PATCH] docs - rename to status codes; complete page

---
 .../{return-codes.html => status-codes.html}  | 28 +++++++++++++++----
 docs/index.html                               |  2 +-
 2 files changed, 23 insertions(+), 7 deletions(-)
 rename docs/apm/{return-codes.html => status-codes.html} (68%)

diff --git a/docs/apm/return-codes.html b/docs/apm/status-codes.html
similarity index 68%
rename from docs/apm/return-codes.html
rename to docs/apm/status-codes.html
index c9d988d..272b918 100644
--- a/docs/apm/return-codes.html
+++ b/docs/apm/status-codes.html
@@ -3,8 +3,8 @@
 <head>
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <meta name="description" content="MontaukOS return codes">
-    <title>Return codes - MontaukOS</title>
+    <meta name="description" content="MontaukOS status codes">
+    <title>Status codes - MontaukOS</title>
     <link rel="preconnect" href="https://fonts.googleapis.com">
     <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
     <link href="https://fonts.googleapis.com/css2?family=Open+Sans:wght@400;600&display=swap" rel="stylesheet">
@@ -70,27 +70,43 @@
 <hr>
 <ul>
 <li><a href="index.html">Application Programming Manual</a></li>
-<li><a href="return-codes.html" class="current">Return codes</a></li>
+<li><a href="status-codes.html" class="current">Status codes</a></li>
 </ul>
 </div>
 
 <div class="main">
 <div class="center">
-<h1>Return codes</h1>
+<h1>Status codes</h1>
 </div>
 
 <hr>
 
+<p>The following table is a reference to the numerical status codes returned by the MontaukOS system and applications.</p>
+
 <table>
 <colgroup>
     <col style="width: 8em">
     <col>
 </colgroup>
 <thead>
-<tr><th>code</th><th>Description</th></tr>
+<tr><th>Code</th><th>Text</th><th>Explanation</th></tr>
 </thead>
 <tbody>
-<tr><td>0</td><td>Success</td></tr>
+<tr><td>0</td><td>Success</td><td></td></tr>
+<tr><td>(-)1</td><td>Generic failure</td><td></td></tr>
+<tr><td>(-)2</td><td>Permission denied</td><td></td></tr>
+<tr><td>(-)3</td><td>Capability denied</td><td></td></tr>
+<tr><td>(-)4</td><td>System integrity error</td><td>The path is protected by the system and can't be modified.</td></tr>
+<tr><td>(-)5</td><td>Bad pointer</td><td></td></tr>
+<tr><td>(-)6</td><td>Invalid argument</td><td></td></tr>
+<tr><td>(-)7</td><td>Unsupported operation</td><td></td></tr>
+<tr><td>(-)8</td><td>No device</td><td></td></tr>
+<tr><td>(-)9</td><td>I/O failure</td><td></td></tr>
+<tr><td>(-)10</td><td>Bad invocation</td><td></td></tr>
+<tr><td>(-)11</td><td>No such path</td><td></td></tr>
+<tr><td>(-)12</td><td>Busy</td><td></td></tr>
+<tr><td>(-)13</td><td>Buffer too small</td><td>The buffer supplied by the caller is too small.</td></tr>
+<tr><td>(-)14</td><td>Out of memory</td><td></td></tr>
 </tbody>
 </table>
 
diff --git a/docs/index.html b/docs/index.html
index 7147940..1d86802 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -133,7 +133,7 @@
         <a href="apm/dialogs.html">Dialogs library</a>
     </li>
     <li>
-        <a href="apm/return-codes.html">Return codes</a>
+        <a href="apm/status-codes.html">Status codes</a>
     </li>
 </ul>