From 6c66c78cf660406b603dd24772afab13f6e885c9 Mon Sep 17 00:00:00 2001 From: Bruno Haible Date: Sat, 7 Jun 2008 13:49:10 +0200 Subject: [PATCH] Fix doc about _setjmp. --- ChangeLog | 9 +++++++++ doc/posix-functions/_longjmp.texi | 9 ++++++--- doc/posix-functions/_setjmp.texi | 9 ++++++--- doc/posix-functions/setjmp.texi | 7 ++++--- 4 files changed, 25 insertions(+), 9 deletions(-) diff --git a/ChangeLog b/ChangeLog index 2c4297fdf4..d7219dd039 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,7 +1,16 @@ +2008-06-07 Bruno Haible + + * 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 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 --git a/doc/posix-functions/_longjmp.texi b/doc/posix-functions/_longjmp.texi index 7d571f88e4..271239560e 100644 --- a/doc/posix-functions/_longjmp.texi +++ b/doc/posix-functions/_longjmp.texi @@ -15,7 +15,10 @@ 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 + +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 --git a/doc/posix-functions/_setjmp.texi b/doc/posix-functions/_setjmp.texi index 7c1dc320f6..abf1825224 100644 --- a/doc/posix-functions/_setjmp.texi +++ b/doc/posix-functions/_setjmp.texi @@ -15,7 +15,10 @@ 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 + +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 --git a/doc/posix-functions/setjmp.texi b/doc/posix-functions/setjmp.texi index f6ecc0016e..3d7860b834 100644 --- a/doc/posix-functions/setjmp.texi +++ b/doc/posix-functions/setjmp.texi @@ -16,7 +16,8 @@ Portability problems not fixed by Gnulib: 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 -- 2.30.2