# HG changeset patch
# User Eric Blake <ebb9@byu.net>
# Date 1212771017 21600
# Node ID ce916d729e431ab8db83b0aeb055f3f88789394f
# Parent  13e7e4dc2f34d4706462af5031cd868a96fcdf49
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>

diff --git a/ChangeLog b/ChangeLog
--- a/ChangeLog
+++ b/ChangeLog
@@ -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
diff --git a/doc/posix-functions/_longjmp.texi b/doc/posix-functions/_longjmp.texi
--- a/doc/posix-functions/_longjmp.texi
+++ b/doc/posix-functions/_longjmp.texi
@@ -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
diff --git a/doc/posix-functions/_setjmp.texi b/doc/posix-functions/_setjmp.texi
--- a/doc/posix-functions/_setjmp.texi
+++ b/doc/posix-functions/_setjmp.texi
@@ -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
diff --git a/doc/posix-functions/abort.texi b/doc/posix-functions/abort.texi
--- a/doc/posix-functions/abort.texi
+++ b/doc/posix-functions/abort.texi
@@ -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
diff --git a/doc/posix-functions/setjmp.texi b/doc/posix-functions/setjmp.texi
--- a/doc/posix-functions/setjmp.texi
+++ b/doc/posix-functions/setjmp.texi
@@ -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
diff --git a/doc/posix-functions/siglongjmp.texi b/doc/posix-functions/siglongjmp.texi
--- a/doc/posix-functions/siglongjmp.texi
+++ b/doc/posix-functions/siglongjmp.texi
@@ -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
diff --git a/doc/posix-functions/sigsetjmp.texi b/doc/posix-functions/sigsetjmp.texi
--- a/doc/posix-functions/sigsetjmp.texi
+++ b/doc/posix-functions/sigsetjmp.texi
@@ -14,5 +14,5 @@
 @itemize
 @item
 This function is missing on some platforms:
-Cygwin, mingw.
+mingw.
 @end itemize