From owner-svn-src-all@freebsd.org Thu Jun 28 18:17:21 2018 Return-Path: Delivered-To: svn-src-all@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id EEA511022E4A; Thu, 28 Jun 2018 18:17:20 +0000 (UTC) (envelope-from cem@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client CN "mxrelay.nyi.freebsd.org", Issuer "Let's Encrypt Authority X3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id A006A87248; Thu, 28 Jun 2018 18:17:20 +0000 (UTC) (envelope-from cem@FreeBSD.org) Received: from repo.freebsd.org (repo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 8146715BA6; Thu, 28 Jun 2018 18:17:20 +0000 (UTC) (envelope-from cem@FreeBSD.org) Received: from repo.freebsd.org ([127.0.1.37]) by repo.freebsd.org (8.15.2/8.15.2) with ESMTP id w5SIHKAa068779; Thu, 28 Jun 2018 18:17:20 GMT (envelope-from cem@FreeBSD.org) Received: (from cem@localhost) by repo.freebsd.org (8.15.2/8.15.2/Submit) id w5SIHK6V068778; Thu, 28 Jun 2018 18:17:20 GMT (envelope-from cem@FreeBSD.org) Message-Id: <201806281817.w5SIHK6V068778@repo.freebsd.org> X-Authentication-Warning: repo.freebsd.org: cem set sender to cem@FreeBSD.org using -f From: Conrad Meyer Date: Thu, 28 Jun 2018 18:17:20 +0000 (UTC) To: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org Subject: svn commit: r335768 - head/lib/libc/sys X-SVN-Group: head X-SVN-Commit-Author: cem X-SVN-Commit-Paths: head/lib/libc/sys X-SVN-Commit-Revision: 335768 X-SVN-Commit-Repository: base MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-src-all@freebsd.org X-Mailman-Version: 2.1.26 Precedence: list List-Id: "SVN commit messages for the entire src tree \(except for " user" and " projects" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 28 Jun 2018 18:17:21 -0000 Author: cem Date: Thu Jun 28 18:17:20 2018 New Revision: 335768 URL: https://svnweb.freebsd.org/changeset/base/335768 Log: sigaction.2: Minor cleanups Add vertical space between struct definition and function prototype. Use "NULL" to describe zero pointers, instead of "zero." Remove perhaps unclear "can not" and replace. Tag struct member names used with appropriate tags. Modified: head/lib/libc/sys/sigaction.2 Modified: head/lib/libc/sys/sigaction.2 ============================================================================== --- head/lib/libc/sys/sigaction.2 Thu Jun 28 17:52:06 2018 (r335767) +++ head/lib/libc/sys/sigaction.2 Thu Jun 28 18:17:20 2018 (r335768) @@ -28,7 +28,7 @@ .\" From: @(#)sigaction.2 8.2 (Berkeley) 4/3/94 .\" $FreeBSD$ .\" -.Dd September 30, 2016 +.Dd June 28, 2018 .Dt SIGACTION 2 .Os .Sh NAME @@ -46,6 +46,7 @@ struct sigaction { sigset_t sa_mask; /* signal mask to apply */ }; .Ed +.Pp .Ft int .Fo sigaction .Fa "int sig" @@ -143,15 +144,13 @@ assigns an action for a signal specified by .Fa sig . If .Fa act -is non-zero, it -specifies an action +is non-NULL, it specifies an action .Dv ( SIG_DFL , .Dv SIG_IGN , -or a handler routine) and mask -to be used when delivering the specified signal. +or a handler routine) and mask to be used when delivering the specified signal. If .Fa oact -is non-zero, the previous handling information for the signal +is non-NULL, the previous handling information for the signal is returned to the user. .Pp The above declaration of @@ -161,8 +160,12 @@ It is provided only to list the accessible members. See .In sys/signal.h for the actual definition. -In particular, the storage occupied by sa_handler and sa_sigaction overlaps, -and an application can not use both simultaneously. +In particular, the storage occupied by +.Va sa_handler +and +.Va sa_sigaction +overlaps, and it is nonsensical for an application to attempt to use both +simultaneously. .Pp Once a signal handler is installed, it normally remains installed until another