From: Paul Eggert <eggert@cs.ucla.edu>
Date: Fri, 13 Dec 2024 07:01:14 +0000 (-0800)
Subject: atexit: document z/OS bug
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=2e8033f55cbe31f49db6e78f2b9d15f2677bde90;p=thirdparty%2Fgnulib.git

atexit: document z/OS bug

* doc/posix-functions/atexit.texi: Mention z/OS issue
raised by Sachin <https://bugs.gnu.org/74788>.
---

diff --git a/ChangeLog b/ChangeLog
index 47b518100f..0298812ea2 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+2024-12-12  Paul Eggert  <eggert@cs.ucla.edu>
+
+	atexit: document z/OS bug
+	* doc/posix-functions/atexit.texi: Mention z/OS issue
+	raised by Sachin <https://bugs.gnu.org/74788>.
+
 2024-12-12  Bruno Haible  <bruno@clisp.org>
 
 	bcp47: Silence a gcc 14 -Wanalyzer-infinite-loop warning.
diff --git a/doc/posix-functions/atexit.texi b/doc/posix-functions/atexit.texi
index 2f0c504c6d..2e6a1d1cac 100644
--- a/doc/posix-functions/atexit.texi
+++ b/doc/posix-functions/atexit.texi
@@ -15,4 +15,12 @@ This function is missing on some old platforms.
 
 Portability problems not fixed by Gnulib:
 @itemize
+@item
+The exit status can be incorrect for a process terminated by a signal
+during a call to a function registered by @code{atexit}.  This is
+because if a signal terminates a process after @code{exit} is called
+or @code{main} returns, the process's exit status is that specified by
+@code{exit}'s argument or by @code{main}'s return value, instead of
+being the exit status corresponding to the signal:
+z/OS 3.1.
 @end itemize