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 b73cf23..2c4297f 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 8f1dcc0..7d571f8 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 ab69ca6..7c1dc32 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 249b037..dfa8325 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 eb012ae..f6ecc00 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 2eb34de..6d7adf5 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 4b1aa10..3e6fe44 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