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
index b73cf2303721c6ea520028dff255ca087f7d729b..2c4297fdf4364f26b5e372200ed9e772f4742ce1 100644 (file)
--- 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
index 8f1dcc077ff1cc2ab01e668d3fecf06c12464757..7d571f88e408a67befb994817276f4f94d5e12db 100644 (file)
--- a/doc/posix-functions/_longjmp.texi
+++ b/doc/posix-functions/_longjmp.texi
@@ -15,4 +15,7 @@ Portability problems not fixed by Gnulib:
 @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
index ab69ca6a2999cf813a0c0d1ee718ef1017cf240c..7c1dc320f620c5fa859a52603acf151ea5a41e2f 100644 (file)
--- a/doc/posix-functions/_setjmp.texi
+++ b/doc/posix-functions/_setjmp.texi
@@ -15,4 +15,7 @@ Portability problems not fixed by Gnulib:
 @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
index 249b037fb6e2e2a3a8da26176a553c511dadb546..dfa832507680bdb9571138afeb396ab66f1f430c 100644 (file)
--- a/doc/posix-functions/abort.texi
+++ b/doc/posix-functions/abort.texi
@@ -12,4 +12,13 @@ Portability problems fixed by Gnulib:
 
 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
index eb012ae23bdf62f8f228a7b0c1bb413f3ffb9413..f6ecc0016e44b2e19c3634f0bc306de7391cd937 100644 (file)
--- a/doc/posix-functions/setjmp.texi
+++ b/doc/posix-functions/setjmp.texi
@@ -13,9 +13,6 @@ Portability problems fixed by Gnulib:
 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
index 2eb34deb1a347561ce6f32e0f8a8435db9fbd552..6d7adf574366102da1d68c24b4369ba5a2852210 100644 (file)
--- a/doc/posix-functions/siglongjmp.texi
+++ b/doc/posix-functions/siglongjmp.texi
@@ -14,5 +14,9 @@ Portability problems not fixed by Gnulib:
 @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
index 4b1aa10ea43800b9159b5f37579e908a97cf9210..3e6fe446f3cf2bd86d2bfaa1ec9b8e631605575c 100644 (file)
--- a/doc/posix-functions/sigsetjmp.texi
+++ b/doc/posix-functions/sigsetjmp.texi
@@ -14,5 +14,5 @@ Portability problems not fixed by Gnulib:
 @itemize
 @item
 This function is missing on some platforms:
-Cygwin, mingw.
+mingw.
 @end itemize