changeset 10165:ce916d729e43

Document abort() bugs. * doc/posix-functions/abort.texi (abort): Mention anomalies. * doc/posix-functions/setjmp.texi (setjmp): Mingw has setjmp. * doc/posix-functions/sigsetjmp.texi (sigsetjmp): Cygwin has sigsetjmp. * doc/posix-functions/siglongjmp.texi (siglongjmp): Cygwin has siglongjmp, but only as a macro. * doc/posix-functions/_longjmp.texi (_longjmp): Mention that this is obsolete. * doc/posix-functions/_setjmp.texi (_setjmp): Likewise. Signed-off-by: Eric Blake <ebb9@byu.net>
author Eric Blake <ebb9@byu.net>
date Fri, 06 Jun 2008 10:50:17 -0600
parents 13e7e4dc2f34
children 4ab1101e2520
files ChangeLog doc/posix-functions/_longjmp.texi doc/posix-functions/_setjmp.texi doc/posix-functions/abort.texi doc/posix-functions/setjmp.texi doc/posix-functions/siglongjmp.texi doc/posix-functions/sigsetjmp.texi
diffstat 7 files changed, 32 insertions(+), 5 deletions(-) [+]
line wrap: on
line diff
--- a/ChangeLog	Fri Jun 06 08:51:48 2008 -0600
+++ b/ChangeLog	Fri Jun 06 10:50:17 2008 -0600
@@ -1,5 +1,16 @@
 2008-06-06  Eric Blake  <ebb9@byu.net>
 
+	Document abort() bugs.
+	* doc/posix-functions/abort.texi (abort): Mention anomalies.
+	* doc/posix-functions/setjmp.texi (setjmp): Mingw has setjmp.
+	* doc/posix-functions/sigsetjmp.texi (sigsetjmp): Cygwin has
+	sigsetjmp.
+	* doc/posix-functions/siglongjmp.texi (siglongjmp): Cygwin has
+	siglongjmp, but only as a macro.
+	* doc/posix-functions/_longjmp.texi (_longjmp): Mention that this
+	is obsolete.
+	* doc/posix-functions/_setjmp.texi (_setjmp): Likewise.
+
 	Tweak documentation to cover cygwin argz bugs.
 	* m4/argz.m4 (gl_FUNC_ARGZ): Mention date of last known cygwin
 	argz bug fix; no code change needed since no cygwin releases
--- a/doc/posix-functions/_longjmp.texi	Fri Jun 06 08:51:48 2008 -0600
+++ b/doc/posix-functions/_longjmp.texi	Fri Jun 06 10:50:17 2008 -0600
@@ -15,4 +15,7 @@
 @item
 This function is missing on some platforms:
 Solaris 2.5.1, mingw.
+
+@item
+This function is obsolete; use @code{siglongjmp} instead.
 @end itemize
--- a/doc/posix-functions/_setjmp.texi	Fri Jun 06 08:51:48 2008 -0600
+++ b/doc/posix-functions/_setjmp.texi	Fri Jun 06 10:50:17 2008 -0600
@@ -15,4 +15,7 @@
 @item
 This function is missing on some platforms:
 Solaris 2.5.1.
+
+@item
+This function is obsolete; use @code{sigsetjmp} instead.
 @end itemize
--- a/doc/posix-functions/abort.texi	Fri Jun 06 08:51:48 2008 -0600
+++ b/doc/posix-functions/abort.texi	Fri Jun 06 10:50:17 2008 -0600
@@ -12,4 +12,13 @@
 
 Portability problems not fixed by Gnulib:
 @itemize
+@item
+Some platforms mistakenly close all stdio streams prior to raising
+SIGABRT:
+Cygwin.
+
+@item
+Some platforms always print a message to stderr, even if a SIGABRT handler
+uses longjmp to resume execution at a safe point:
+mingw.
 @end itemize
--- a/doc/posix-functions/setjmp.texi	Fri Jun 06 08:51:48 2008 -0600
+++ b/doc/posix-functions/setjmp.texi	Fri Jun 06 10:50:17 2008 -0600
@@ -13,9 +13,6 @@
 Portability problems not fixed by Gnulib:
 @itemize
 @item
-This function is missing on some platforms:
-mingw.
-@item
 POSIX does not specify whether @code{setjmp} saves the signal mask in the
 @code{jmp_buf}.  It does on BSD platforms, and on glibc platforms when
 @code{_BSD_SOURCE} is defined; in this case @code{setjmp} behaves like
--- a/doc/posix-functions/siglongjmp.texi	Fri Jun 06 08:51:48 2008 -0600
+++ b/doc/posix-functions/siglongjmp.texi	Fri Jun 06 10:50:17 2008 -0600
@@ -14,5 +14,9 @@
 @itemize
 @item
 This function is missing on some platforms:
-Cygwin, mingw.
+mingw.
+
+@item
+This is only provided as a macro on some platforms:
+Cygwin.
 @end itemize
--- a/doc/posix-functions/sigsetjmp.texi	Fri Jun 06 08:51:48 2008 -0600
+++ b/doc/posix-functions/sigsetjmp.texi	Fri Jun 06 10:50:17 2008 -0600
@@ -14,5 +14,5 @@
 @itemize
 @item
 This function is missing on some platforms:
-Cygwin, mingw.
+mingw.
 @end itemize