From: Eric Blake <ebb9@byu.net>
Date: Fri, 6 Jun 2008 16:50:17 +0000 (-0600)
Subject: Document abort() bugs.
X-Git-Url: https://pintos-os.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=8018d5eb28aa074c6e93b9840e533eb8d6c5ceca;p=pspp

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 b73cf23037..2c4297fdf4 100644
--- 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 8f1dcc077f..7d571f88e4 100644
--- 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 ab69ca6a29..7c1dc320f6 100644
--- 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 249b037fb6..dfa8325076 100644
--- 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 eb012ae23b..f6ecc0016e 100644
--- 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 2eb34deb1a..6d7adf5743 100644
--- 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 4b1aa10ea4..3e6fe446f3 100644
--- 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