Cygwin: document new winjitdebug option

Signed-off-by: Corinna Vinschen <corinna@vinschen.de>

diff --git a/winsup/cygwin/release/3.5.1 b/winsup/cygwin/release/3.5.1
index 7776d120fbc206b24c1e6a14a7502be367db1304..81945dbda58a23c1ef998638e0f83cbe8b0d6ea4 100644 (file)
--- a/winsup/cygwin/release/3.5.1
+++ b/winsup/cygwin/release/3.5.1
@@ -1,8 +1,14 @@
-Bug Fixes
----------
+Fixes:
+------
 
 - Fix exit code for non-cygwin process running in console. The bug
   was introduced in 3.5.0.
 
 - Make the interface names handled by if_nametoindex() and if_indextoname()
   consistent with that of if_nameindex().
+
+- Revert error handling for non-Cygwin child processes to use Cygwin's
+  error mode by default.  Resetting the error mode to the OS default
+  error mode is now possible by using the new CYGWIN environment variable
+  option "winjitdebug".
+  Addresses: https://cygwin.com/pipermail/cygwin/2024-February/255305.html

diff --git a/winsup/doc/cygwinenv.xml b/winsup/doc/cygwinenv.xml
index 05672c404ef174645ffeed33bd41d345989e25a0..3c69d5e4541c6eb09326810b5460172b59c3ebb0 100644 (file)
--- a/winsup/doc/cygwinenv.xml
+++ b/winsup/doc/cygwinenv.xml
@@ -93,6 +93,16 @@ line (truncated to ~32K) will be passed on any processes that it creates
 in addition to the normal UNIX argv list.  Defaults to not set.</para>
 </listitem>
 
+<listitem>
+<para><envar>(no)winjitdebug</envar> - if set, non-Cygwin executables
+started from a Cygwin process will have their error mode reset to the
+system default.  That means, if they don't call SetErrorMode() explicitl,
+the OS will display error dialog boxes in the GUI if some fatal error
+occurs.  Defaults to not set, so fatal errors in a non-Cygwin child
+process will just result in an error code be propagated back to the
+parent process.</para>
+</listitem>
+
 <listitem>
 <para><envar>winsymlinks:{lnk,native,nativestrict,sys}</envar></para>