Various updates and corrections to SYNOPSIS, ERRORS, and STANDARDS

Mention that unlinkat() serves the role of rmdirat().

5 files changed, 23 insertions, 32 deletions

diff --git a/lib/libc/sys/sigaction.2 b/lib/libc/sys/sigaction.2
index 5854d415586..2c95e34d935 100644
--- a/lib/libc/sys/sigaction.2
+++ b/lib/libc/sys/sigaction.2
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: sigaction.2,v 1.61 2014/08/31 01:42:36 guenther Exp $
+.\"	$OpenBSD: sigaction.2,v 1.62 2014/09/09 08:17:59 guenther Exp $
 .\"	$NetBSD: sigaction.2,v 1.7 1995/10/12 15:41:16 jtc Exp $
 .\"
 .\" Copyright (c) 1980, 1990, 1993
@@ -30,14 +30,14 @@
 .\"
 .\"	@(#)sigaction.2	8.2 (Berkeley) 4/3/94
 .\"
-.Dd $Mdocdate: August 31 2014 $
+.Dd $Mdocdate: September 9 2014 $
 .Dt SIGACTION 2
 .Os
 .Sh NAME
 .Nm sigaction
 .Nd software signal facilities
 .Sh SYNOPSIS
-.Fd #include <signal.h>
+.In signal.h
 .Bd -literal
 struct sigaction {
 	union {		/* signal handler */
@@ -343,10 +343,7 @@ with names as in the include file
 .It Dv SIGTHR Ta "discard signal" Ta "thread AST"
 .El
 .Sh RETURN VALUES
-A 0 value indicates that the call succeeded.
-A \-1 return value indicates an error occurred and
-.Va errno
-is set to indicate the reason.
+.Rv -std
 .Sh EXAMPLES
 The handler routine can be declared:
 .Bd -literal -offset indent
diff --git a/lib/libc/sys/sigaltstack.2 b/lib/libc/sys/sigaltstack.2
index 25d8ccc518f..10776f7ac52 100644
--- a/lib/libc/sys/sigaltstack.2
+++ b/lib/libc/sys/sigaltstack.2
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: sigaltstack.2,v 1.16 2012/11/17 13:09:21 jmc Exp $
+.\"	$OpenBSD: sigaltstack.2,v 1.17 2014/09/09 08:17:59 guenther Exp $
 .\"	$NetBSD: sigaltstack.2,v 1.3 1995/02/27 10:41:52 cgd Exp $
 .\"
 .\" Copyright (c) 1983, 1991, 1992, 1993
@@ -30,15 +30,14 @@
 .\"
 .\"     @(#)sigaltstack.2	8.1 (Berkeley) 6/4/93
 .\"
-.Dd $Mdocdate: November 17 2012 $
+.Dd $Mdocdate: September 9 2014 $
 .Dt SIGALTSTACK 2
 .Os
 .Sh NAME
 .Nm sigaltstack
 .Nd set and/or get signal stack context
 .Sh SYNOPSIS
-.Fd #include <sys/types.h>
-.Fd #include <signal.h>
+.In signal.h
 .Bd -literal
 typedef struct sigaltstack {
 	void	*ss_sp;
@@ -126,10 +125,7 @@ are not ``grown'' automatically as is done for the normal stack.
 If the stack overflows and this space is not protected
 unpredictable results may occur.
 .Sh RETURN VALUES
-Upon successful completion, a value of 0 is returned.
-Otherwise, a value of \-1 is returned and
-.Va errno
-is set to indicate the error.
+.Rv -std
 .Sh ERRORS
 .Fn sigaltstack
 will fail and the signal stack context will remain unchanged
diff --git a/lib/libc/sys/sigpending.2 b/lib/libc/sys/sigpending.2
index 95c2608ce11..08f8b93fc43 100644
--- a/lib/libc/sys/sigpending.2
+++ b/lib/libc/sys/sigpending.2
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: sigpending.2,v 1.5 2007/05/31 19:19:34 jmc Exp $
+.\"	$OpenBSD: sigpending.2,v 1.6 2014/09/09 08:17:59 guenther Exp $
 .\"	$NetBSD: sigpending.2,v 1.2 1995/02/27 12:37:26 cgd Exp $
 .\"
 .\" Copyright (c) 1993
@@ -33,14 +33,14 @@
 .\"
 .\"	@(#)sigpending.2	8.3 (Berkeley) 1/12/94
 .\"
-.Dd $Mdocdate: May 31 2007 $
+.Dd $Mdocdate: September 9 2014 $
 .Dt SIGPENDING 2
 .Os
 .Sh NAME
 .Nm sigpending
 .Nd get pending signals
 .Sh SYNOPSIS
-.Fd #include <signal.h>
+.In signal.h
 .Ft int
 .Fn sigpending "sigset_t *set"
 .Sh DESCRIPTION
@@ -53,19 +53,17 @@ Signals may be pending because they are currently masked,
 or transiently before delivery (although the latter case is not
 normally detectable).
 .Sh RETURN VALUES
-A 0 value indicated that the call succeeded.
-A \-1 return value indicates an error occurred and
-.Va errno
-is set to indicated the reason.
+.Rv -std
 .Sh ERRORS
 The
 .Nm sigpending
 function does not currently detect any errors.
 .Sh SEE ALSO
 .Xr sigaction 2 ,
-.Xr sigprocmask 2
+.Xr sigprocmask 2 ,
+.Xr sigsetops 3
 .Sh STANDARDS
 The
 .Nm sigpending
 function is defined by
-.St -p1003.1-88 .
+.St -p1003.1-2008 .
diff --git a/lib/libc/sys/sigreturn.2 b/lib/libc/sys/sigreturn.2
index f908fe13385..b9eddc7e19c 100644
--- a/lib/libc/sys/sigreturn.2
+++ b/lib/libc/sys/sigreturn.2
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: sigreturn.2,v 1.10 2013/08/14 08:39:25 jmc Exp $
+.\"	$OpenBSD: sigreturn.2,v 1.11 2014/09/09 08:17:59 guenther Exp $
 .\"	$NetBSD: sigreturn.2,v 1.6 1995/02/27 12:37:40 cgd Exp $
 .\"
 .\" Copyright (c) 1985, 1991, 1993
@@ -30,14 +30,14 @@
 .\"
 .\"     @(#)sigreturn.2	8.1 (Berkeley) 6/4/93
 .\"
-.Dd $Mdocdate: August 14 2013 $
+.Dd $Mdocdate: September 9 2014 $
 .Dt SIGRETURN 2
 .Os
 .Sh NAME
 .Nm sigreturn
 .Nd return from signal
 .Sh SYNOPSIS
-.Fd #include <signal.h>
+.In signal.h
 .Ft int
 .Fn sigreturn "struct sigcontext *scp"
 .Sh DESCRIPTION
diff --git a/lib/libc/sys/sigsuspend.2 b/lib/libc/sys/sigsuspend.2
index 3d157916930..b3625eac028 100644
--- a/lib/libc/sys/sigsuspend.2
+++ b/lib/libc/sys/sigsuspend.2
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: sigsuspend.2,v 1.11 2007/05/31 19:19:34 jmc Exp $
+.\"	$OpenBSD: sigsuspend.2,v 1.12 2014/09/09 08:17:59 guenther Exp $
 .\"	$NetBSD: sigsuspend.2,v 1.4 1995/02/27 12:37:46 cgd Exp $
 .\"
 .\" Copyright (c) 1983, 1991, 1993
@@ -30,14 +30,14 @@
 .\"
 .\"	@(#)sigsuspend.2	8.1 (Berkeley) 6/4/93
 .\"
-.Dd $Mdocdate: May 31 2007 $
+.Dd $Mdocdate: September 9 2014 $
 .Dt SIGSUSPEND 2
 .Os
 .Sh NAME
 .Nm sigsuspend
-.Nd atomically release blocked signals and wait for interrupt
+.Nd atomically change the signal mask and wait for interrupt
 .Sh SYNOPSIS
-.Fd #include <signal.h>
+.In signal.h
 .Ft int
 .Fn sigsuspend "const sigset_t *sigmask"
 .Sh DESCRIPTION
@@ -75,4 +75,4 @@ The
 .Nm sigsuspend
 function call
 conforms to
-.St -p1003.1-88 .
+.St -p1003.1-2008 .