# HG changeset patch
# User Bruno Haible <bruno@clisp.org>
# Date 1212839350 -7200
# Node ID 7239ee79f3fa920ba3d48d1d22a52749cf12ff03
# Parent  4ab1101e252010130308a1993eb4be93dbaf1f0b
Fix doc about _setjmp.

diff -r 4ab1101e2520 -r 7239ee79f3fa ChangeLog
--- a/ChangeLog	Fri Jun 06 17:57:29 2008 -0600
+++ b/ChangeLog	Sat Jun 07 13:49:10 2008 +0200
@@ -1,7 +1,16 @@
+2008-06-07  Bruno Haible  <bruno@clisp.org>
+
+	* doc/posix-functions/_setjmp.texi: Explain the use of this function
+	regardless of POSIX.
+	* doc/posix-functions/_longjmp.texi: Likewise.
+	* doc/posix-functions/setjmp.texi: Mention HP-UX as not counting as a
+	SystemV platform in this case.
+
 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.
diff -r 4ab1101e2520 -r 7239ee79f3fa doc/posix-functions/_longjmp.texi
--- a/doc/posix-functions/_longjmp.texi	Fri Jun 06 17:57:29 2008 -0600
+++ b/doc/posix-functions/_longjmp.texi	Sat Jun 07 13:49:10 2008 +0200
@@ -15,7 +15,10 @@
 @item
 This function is missing on some platforms:
 Solaris 2.5.1, mingw.
+@end itemize
 
-@item
-This function is obsolete; use @code{siglongjmp} instead.
-@end itemize
+Note: A future revision of POSIX later than the 2008/2009 one may drop the
+functions @code{_setjmp} and @code{_longjmp}.  Still, in 2008, on all
+systems which have @code{_setjmp}, it is the fastest way to save the
+registers but not the signal mask (up to 30 times faster than @code{setjmp}
+on some systems).
diff -r 4ab1101e2520 -r 7239ee79f3fa doc/posix-functions/_setjmp.texi
--- a/doc/posix-functions/_setjmp.texi	Fri Jun 06 17:57:29 2008 -0600
+++ b/doc/posix-functions/_setjmp.texi	Sat Jun 07 13:49:10 2008 +0200
@@ -15,7 +15,10 @@
 @item
 This function is missing on some platforms:
 Solaris 2.5.1.
+@end itemize
 
-@item
-This function is obsolete; use @code{sigsetjmp} instead.
-@end itemize
+Note: A future revision of POSIX later than the 2008/2009 one may drop the
+functions @code{_setjmp} and @code{_longjmp}.  Still, in 2008, on all
+systems which have @code{_setjmp}, it is the fastest way to save the
+registers but not the signal mask (up to 30 times faster than @code{setjmp}
+on some systems).
diff -r 4ab1101e2520 -r 7239ee79f3fa doc/posix-functions/setjmp.texi
--- a/doc/posix-functions/setjmp.texi	Fri Jun 06 17:57:29 2008 -0600
+++ b/doc/posix-functions/setjmp.texi	Sat Jun 07 13:49:10 2008 +0200
@@ -16,7 +16,8 @@
 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
-@code{sigsetjmp}, and functions @code{_setjmp} and @code{_longjmp} are
-available that don't save or restore the signal mask.  On System V platforms,
-and on glibc platforms by default, @code{setjmp} doesn't save the signal mask.
+@code{sigsetjmp(.,1)}, and functions @code{_setjmp} and @code{_longjmp} are
+available that don't save or restore the signal mask.  On System V platforms
+(excluding HP-UX), and on glibc platforms by default, @code{setjmp} doesn't
+save the signal mask.
 @end itemize