3 files changed, 17 insertions, 1 deletions
diff --git a/doc/exitcodes.html b/doc/exitcodes.html
index 7463bd1..51902f1 100644
--- a/doc/exitcodes.html
+++ b/doc/exitcodes.html
@@ -94,5 +94,16 @@ a scion of <em>C</em> had problems. </li>
  <li> Exact information is reported in the common case. </li>
 </ul>
 
+<h2> Summary of common exit codes for execline programs </h2>
+
+<ul>
+ <li> 0: success. This code is rarely encountered, because most execline
+programs chainload into something else when they succeed, instead of exiting 0. </li>
+ <li> 100: wrong usage </li>
+ <li> 111: system call failed </li>
+ <li> 126: unable to chainload into another program (any other error than ENOENT) </li>
+ <li> 127: unable to chainload into another program (executable not found) </li>
+</ul>
+
 </body>
 </html>
diff --git a/doc/index.html b/doc/index.html
index d39e3bd..929dbab 100644
--- a/doc/index.html
+++ b/doc/index.html
@@ -110,8 +110,11 @@ to your installation: the shebang lines for your system might be something like
 
 <p>
  All these commands exit 111 if they encounter a temporary error, and
-100 if they encounter a permanent error - such as a misuse.
+100 if they encounter a permanent error - such as a misuse. They exit
+127 if they're trying to execute into a program and cannot find it, and
+126 if they fail to execute into a program for another reason.
 </p>
+
 <p>
  (Script parser / launcher)
 </p>
diff --git a/doc/upgrade.html b/doc/upgrade.html
index a954d63..d64d75d 100644
--- a/doc/upgrade.html
+++ b/doc/upgrade.html
@@ -22,6 +22,8 @@
 
 <ul>
  <li> skalibs dependency bumped to 2.6.0.0 </li>
+ <li> Commands now exit 127 (not found) or 126 (other error) if
+they cannot exec into a program they're supposed to. </li>
  <li> The <a href="import.html">import</a> command will likely
 disappear <em>very soon</em>. Please switch to
 <a href="importas.html">importas</a> as soon as possible! </li>