[src/trunk]: src/lib/libc/gen Document bsd_signal (From GSoC 2016 by Charles ...

[christos <christos%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/4e6325bf2725
branches:  trunk
changeset: 345724:4e6325bf2725
user:      christos <christos%NetBSD.org@localhost>
date:      Sun Jun 05 17:16:44 2016 +0000

description:
Document bsd_signal (From GSoC 2016 by Charles Cui)

diffstat:

 lib/libc/gen/Makefile.inc |   6 ++--
 lib/libc/gen/bsd_signal.3 |  68 +++++++++++++++++++++++++++++++++++++++++++++++
 lib/libc/gen/signal.3     |   7 +++-
 3 files changed, 76 insertions(+), 5 deletions(-)

diffs (127 lines):

diff -r d293d1106530 -r 4e6325bf2725 lib/libc/gen/Makefile.inc
--- a/lib/libc/gen/Makefile.inc Sun Jun 05 16:43:10 2016 +0000
+++ b/lib/libc/gen/Makefile.inc Sun Jun 05 17:16:44 2016 +0000
@@ -1,4 +1,4 @@
-#      $NetBSD: Makefile.inc,v 1.194 2016/04/03 00:19:42 christos Exp $
+#      $NetBSD: Makefile.inc,v 1.195 2016/06/05 17:16:44 christos Exp $
 #      from: @(#)Makefile.inc  8.6 (Berkeley) 5/4/95
 
 # gen sources
@@ -53,8 +53,8 @@
 
 .include "${ARCHDIR}/gen/Makefile.inc"
 
-MAN+=  alarm.3 arc4random.3 basename.3 bswap.3 clock.3 closefrom.3 \
-       confstr.3 \
+MAN+=  alarm.3 arc4random.3 basename.3 bsd_signal.3 bswap.3 \
+       clock.3 closefrom.3 confstr.3 \
        cpuset.3 ctermid.3 ctype.3 daemon.3 devname.3 directory.3 dirname.3 \
        endutxent.3 err.3 exec.3 extattr_copy_file.3 extattr_namespace_to_string.3 \
        fmtcheck.3 fmtmsg.3 fnmatch.3 fpclassify.3 fpgetmask.3 \
diff -r d293d1106530 -r 4e6325bf2725 lib/libc/gen/bsd_signal.3
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/lib/libc/gen/bsd_signal.3 Sun Jun 05 17:16:44 2016 +0000
@@ -0,0 +1,68 @@
+.\"    $NetBSD: bsd_signal.3,v 1.1 2016/06/05 17:16:44 christos Exp $
+.\"
+.\" Copyright (c) 1980, 1991, 1993
+.\"    The Regents of the University of California.  All rights reserved.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\" 3. Neither the name of the University nor the names of its contributors
+.\"    may be used to endorse or promote products derived from this software
+.\"    without specific prior written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
+.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
+.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+.\" SUCH DAMAGE.
+.\"
+.\"     @(#)bsd_signal.3       8.3 (Berkeley) 4/19/94
+.\"
+.Dd June 04, 2016
+.Dt BSD_SIGNAL 3
+.Os
+.Sh NAME
+.Nm bsd_signal
+.Nd BSD version of
+.Xr signal
+.Sh LIBRARY
+.Lb libc
+.Sh SYNOPSIS
+.In signal.h
+.\" The following is Quite Ugly, but syntactically correct.  Don't try to
+.\" fix it.
+.Ft void \*(lp*
+.Fn bsd_signal "int sig" "void \*(lp*func\*(rp\*(lpint\*(rp\*(rp\*(rp\*(lpint"
+.Sh DESCRIPTION
+The
+.Fn bsd_signal
+function provides a partially compatible interface for programs written to
+historical system interfaces.
+.Sh RETURN VALUES
+The previous action is returned on a successful call.
+Otherwise,
+.Dv SIG_ERR
+is returned and the global variable
+.Va errno
+is set to indicate the error.
+.Sh SEE ALSO
+.Xr signal 3
+.Sh STANDARDS
+The 
+.Fn bsd_signal
+function conforms to
+.St -p1003.1-2004 .
+It was moved from X/Open to zbase in Issue 4 version 2.
+It first appeared in
+.Nx 8 .
diff -r d293d1106530 -r 4e6325bf2725 lib/libc/gen/signal.3
--- a/lib/libc/gen/signal.3     Sun Jun 05 16:43:10 2016 +0000
+++ b/lib/libc/gen/signal.3     Sun Jun 05 17:16:44 2016 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: signal.3,v 1.24 2004/06/13 19:17:06 lha Exp $
+.\"    $NetBSD: signal.3,v 1.25 2016/06/05 17:16:44 christos Exp $
 .\"
 .\" Copyright (c) 1980, 1991, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -29,7 +29,7 @@
 .\"
 .\"     @(#)signal.3   8.3 (Berkeley) 4/19/94
 .\"
-.Dd June 11, 2004
+.Dd June 5, 2016
 .Dt SIGNAL 3
 .Os
 .Sh NAME
@@ -43,6 +43,8 @@
 .\" fix it.
 .Ft void \*(lp*
 .Fn signal "int sig" "void \*(lp*func\*(rp\*(lpint\*(rp\*(rp\*(rp\*(lpint"
+.Ft void \*(lp*
+.Fn bsd_signal "int sig" "void \*(lp*func\*(rp\*(lpint\*(rp\*(rp\*(rp\*(lpint"
 .Sh DESCRIPTION
 This
 .Fn signal
@@ -179,6 +181,7 @@
 .Xr sigaltstack 2 ,
 .Xr sigprocmask 2 ,
 .Xr sigsuspend 2 ,
+.Xr bsd_signal 3 ,
 .Xr psignal 3 ,
 .Xr setjmp 3 ,
 .Xr strsignal 3 ,