LDP: Update original to LDP v3.79

[linuxjm/LDP_man-pages.git] / original / man3 / strsignal.3

diff --git a/original/man3/strsignal.3 b/original/man3/strsignal.3
index 53954da..00e372a 100644 (file)
--- a/original/man3/strsignal.3
+++ b/original/man3/strsignal.3
@@ -1,5 +1,6 @@
 .\" Copyright 1993 David Metcalfe (david@prism.demon.co.uk)
 .\"
+.\" %%%LICENSE_START(VERBATIM)
 .\" Permission is granted to make and distribute verbatim copies of this
 .\" manual provided the copyright notice and this permission notice are
 .\" preserved on all copies.
@@ -19,51 +20,79 @@
 .\"
 .\" Formatted or processed versions of this manual, if unaccompanied by
 .\" the source, must acknowledge the copyright and authors of this work.
+.\" %%%LICENSE_END
 .\"
 .\" References consulted:
 .\"     Linux libc source code
 .\"     Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991)
 .\"     386BSD man pages
 .\" Modified Sat Jul 24 17:59:03 1993 by Rik Faith (faith@cs.unc.edu)
-.TH STRSIGNAL 3  2008-08-21 "GNU" "Linux Programmer's Manual"
+.TH STRSIGNAL 3  2010-09-15 "GNU" "Linux Programmer's Manual"
 .SH NAME
 strsignal \- return string describing signal
 .SH SYNOPSIS
 .nf
-.B #define _GNU_SOURCE
-.br
 .B #include <string.h>
 .sp
 .BI "char *strsignal(int " sig );
 .sp
 .BI "extern const char * const " sys_siglist [];
 .fi
+.sp
+.in -4n
+Feature Test Macro Requirements for glibc (see
+.BR feature_test_macros (7)):
+.in
+.sp
+.BR strsignal ():
+.PD 0
+.ad l
+.RS 4
+.TP 4
+Since glibc 2.10:
+_XOPEN_SOURCE\ >=\ 700 || _POSIX_C_SOURCE\ >=\ 200809L
+.TP
+Before glibc 2.10:
+_GNU_SOURCE
+.RE
+.ad
+.PD
 .SH DESCRIPTION
 The
 .BR strsignal ()
 function returns a string describing the signal
-number passed in the argument \fIsig\fP.
-The string can only be used
-until the next call to
+number passed in the argument
+.IR sig .
+The string can be used only until the next call to
 .BR strsignal ().
 .PP
-The array \fIsys_siglist\fP holds the signal description strings
+The array
+.I sys_siglist
+holds the signal description strings
 indexed by signal number.
 The
 .BR strsignal ()
 function should be
 used if possible instead of this array.
-.SH "RETURN VALUE"
+.SH RETURN VALUE
 The
 .BR strsignal ()
 function returns the appropriate description
 string, or an unknown signal message if the signal number is invalid.
-On some systems (but not on Linux), a NULL pointer may be
-returned instead for an invalid signal number.
-.SH "CONFORMING TO"
+On some systems (but not on Linux), NULL may instead be
+returned for an invalid signal number.
+.SH CONFORMING TO
 POSIX.1-2008.
 Present on Solaris and the BSDs.
-.SH "SEE ALSO"
+.SH SEE ALSO
 .BR psignal (3),
-.BR strerror (3),
-.BR feature_test_macros (7)
+.BR strerror (3)
+.SH COLOPHON
+This page is part of release 3.79 of the Linux
+.I man-pages
+project.
+A description of the project,
+information about reporting bugs,
+and the latest version of this page,
+can be found at
+\%http://www.kernel.org/doc/man\-pages/.